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.