Реализация QR-генератора на сайте

Реализация QR-генератора на сайте

QR-код нужен в личных кабинетах (ссылка на профиль), системах оплаты (QR для перевода), электронных билетах, визитках и инструментах маркетинга. Генерация в браузере без запросов к серверу — быстро и без зависимости от внешних сервисов.

Библиотека qrcode

qrcode — надёжная библиотека с поддержкой Canvas, SVG и Data URL. Работает в браузере и Node.js.

npm install qrcode
npm install -D @types/qrcode

Компонент генератора

import QRCode from 'qrcode'
import { useEffect, useRef, useState } from 'react'

interface QRGeneratorProps {
  value: string
  size?: number
  errorCorrection?: 'L' | 'M' | 'Q' | 'H'
  color?: { dark: string; light: string }
}

export function QRGenerator({
  value,
  size = 256,
  errorCorrection = 'M',
  color = { dark: '#000000', light: '#ffffff' },
}: QRGeneratorProps) {
  const canvasRef = useRef<HTMLCanvasElement>(null)
  const [dataUrl, setDataUrl] = useState<string>('')

  useEffect(() => {
    if (!value || !canvasRef.current) return

    QRCode.toCanvas(canvasRef.current, value, {
      width: size,
      margin: 2,
      errorCorrectionLevel: errorCorrection,
      color,
    })

    // Параллельно готовим Data URL для скачивания
    QRCode.toDataURL(value, {
      width: size * 2, // 2x для чёткости при печати
      margin: 2,
      errorCorrectionLevel: errorCorrection,
      color,
    }).then(setDataUrl)
  }, [value, size, errorCorrection, color])

  function download() {
    const a = document.createElement('a')
    a.href = dataUrl
    a.download = 'qrcode.png'
    a.click()
  }

  return (
    <div className="flex flex-col items-center gap-3">
      <canvas ref={canvasRef} className="rounded" />
      {dataUrl && (
        <button onClick={download} className="text-sm text-blue-600 hover:underline">
          Скачать PNG
        </button>
      )}
    </div>
  )
}

SVG-версия для встраивания в страницу

import QRCode from 'qrcode'
import { useState, useEffect } from 'react'

function QRCodeSVG({ value, size = 200 }: { value: string; size?: number }) {
  const [svg, setSvg] = useState<string>('')

  useEffect(() => {
    QRCode.toString(value, { type: 'svg', width: size, margin: 1 })
      .then(setSvg)
  }, [value, size])

  return (
    <div
      dangerouslySetInnerHTML={{ __html: svg }}
      className="inline-block"
    />
  )
}

SVG масштабируется без потери качества — подходит для PDF и печатных материалов.

QR с логотипом в центре

QR-код с уровнем коррекции H выдерживает до 30% закрытой площади — можно вставить логотип:

async function generateQRWithLogo(text: string, logoUrl: string): Promise<string> {
  const canvas = document.createElement('canvas')
  const size = 400

  await QRCode.toCanvas(canvas, text, {
    width: size,
    margin: 2,
    errorCorrectionLevel: 'H', // Обязательно H при наличии логотипа
    color: { dark: '#000000', light: '#ffffff' },
  })

  const ctx = canvas.getContext('2d')!

  const logo = new Image()
  logo.crossOrigin = 'anonymous'
  await new Promise<void>((resolve) => {
    logo.onload = () => resolve()
    logo.src = logoUrl
  })

  const logoSize = size * 0.18 // 18% от размера QR
  const logoX = (size - logoSize) / 2
  const logoY = (size - logoSize) / 2

  // Белый фон под логотипом
  ctx.fillStyle = '#ffffff'
  ctx.beginPath()
  ctx.roundRect(logoX - 4, logoY - 4, logoSize + 8, logoSize + 8, 6)
  ctx.fill()

  ctx.drawImage(logo, logoX, logoY, logoSize, logoSize)

  return canvas.toDataURL('image/png')
}

Серверная генерация (Node.js)

Когда QR нужно вставить в PDF или отправить в письме — генерируем на сервере:

import QRCode from 'qrcode'

// Express / Next.js API route
export async function GET(request: Request) {
  const { searchParams } = new URL(request.url)
  const text = searchParams.get('text')

  if (!text) return new Response('Missing text', { status: 400 })

  const buffer = await QRCode.toBuffer(text, {
    type: 'png',
    width: 400,
    errorCorrectionLevel: 'M',
  })

  return new Response(buffer, {
    headers: {
      'Content-Type': 'image/png',
      'Cache-Control': 'public, max-age=3600',
    },
  })
}

Что делаем

Интегрируем генератор QR-кодов в нужное место (форма, карточка товара, личный кабинет), настраиваем размер, цвет, уровень коррекции ошибок, при необходимости добавляем логотип и скачивание в PNG/SVG.

Срок: 0.5 дня.