qr-svg

QR-код в виде минимальной SVG-строки — один rect и один path на целых координатах, чёткий в любом размере и безопасный под строгой CSP, в Node и в браузере.

Доступно в: npm GitHub Сайт проекта

qr-svg — небольшая JavaScript-библиотека, которая возвращает QR-код в виде SVG-строки: один <rect> для фона и один <path> для модулей, на целых координатах и с shape-rendering="crispEdges". Код остаётся чётким в любом размере, чисто печатается и отображается под строгой Content Security Policy. Без зависимостей, 4,0 КБ в gzip, один вызов в Node или в браузере — поэтому генерация QR при сборке в Node даёт ту же разметку, что и на странице.

Почему SVG-строка

  • Маленький результат. Ряд тёмных модулей подряд — один подпуть, поэтому QR короткого URL — около 2,5 КБ разметки: без групп, масок, фильтров, <use> и отдельного элемента на каждый модуль.
  • Работает под строгой CSP. Никаких style="", <style>, <script>, data: или url(): цвета — атрибуты представления, и перед записью они проверяются по белому списку (hex, rgb(), hsl(), ключевое слово). QR-код под строгой CSP не требует ничего дополнительно.
  • Подстраивается под контейнер. Без size у SVG есть только viewBox; с ним — width и height в пикселях. Рисунок в обоих случаях один и тот же.

Как подключить

Установите из npm командой npm install @spintax/qr-svg, затем:

const svg = QR.renderSvg(QR.generateMatrix('https://example.com'));

Это один UMD-файл: импорт по умолчанию, require() или <script> с CDN, который создаёт глобальный QrSvg. В живом демо можно ввести текст, выбрать уровень, цвета и размер, а затем скопировать или скачать SVG.

API

  • generateMatrix(text, options) кодирует текст в матрицу модулей: уровни коррекции ошибок L, M, Q и H (по умолчанию M), версии с 1 по 40, цифровой, буквенно-цифровой и байтовый UTF-8 режимы, автоматическая или заданная маска и необязательный boostEcc.
  • renderSvg(matrix, options) рисует её: quiet (поле, по умолчанию 4 модуля), size, fg и bg (подходит и 'transparent'). Значение, которое не является обычным цветом, вызывает ошибку, потому что оно попадает внутрь атрибута.
  • buildPathData(matrix, quiet) возвращает только атрибут d — для тех, кто строит элемент сам, например в браузерном расширении.

Точность и стабильность

Это QR-кодировщик без зависимостей: порт uqr и генератора Project Nayuki (ISO/IEC 18004), который рисует ту же матрицу модуль в модуль — тест сравнивает их на каждой версии. Тесты также считывают нарисованное независимым декодером jsQR в нескольких масштабах и со всеми масками. В пределах минорной версии один и тот же текст и параметры дают побайтно одинаковый SVG.

Лицензия

MIT. Разработка 301; исходные уведомления кодировщика (uqr, Project Nayuki) лежат в файле LICENSE.