Skip to content

@qrcodesdk/svelte

Svelte components for rendering QR codes as inline SVG, PNG, WebP, GIF, and JPEG Image elements, and Canvas elements.

Terminal window
npm install @qrcodesdk/svelte

Import the components directly in a Svelte component:

<script lang="ts">
import {QRCodeCanvas, QRCodePNG, QRCodeSVG} from '@qrcodesdk/svelte';
</script>
<QRCodeSVG payload="https://qrcodesdk.dev" />
<QRCodePNG payload="https://qrcodesdk.dev" />
<QRCodeCanvas payload="https://qrcodesdk.dev" />
@qrcodesdk/svelte Svelte
0.x.x ^5.0.0
ComponentOutputDownload support
QRCodeSVGInline SVG elementSVG
QRCodePNGPNG-backed <img>PNG
QRCodeWebPWebP-backed <img>WebP
QRCodeGIFGIF-backed <img>GIF
QRCodeJPEGJPEG-backed <img>JPEG
QRCodeCanvas<canvas> elementNone

Options

PropTypeDescription
payloadstring | numberRequired QR code payload.
optionsComponent-specific optionsOptional matrix and renderer options.

Each image format has its own component, so your bundle only includes the encoders of the components you import. QRCodePNG uses the browser’s native PNG encoder. QRCodeWebP renders lossless WebP, usually the smallest file, with an encoder bundled in the SDK that also works in Safari. QRCodeGIF is limited to 256 colors and binary transparency, so prefer PNG or WebP for transparent backgrounds and photographic center images. QRCodeJPEG is lossy and has no transparency: it blends transparent pixels onto a white matte by default, and quality (1 to 100, default 92) trades file size for detail. Use it when a destination requires JPEG. See the Image element renderers reference for details.

The components forward class, style, and other native <div> attributes to their wrapper. Use bind:this when you need a download handle; the rendered SVG, Image, or Canvas remains inside that wrapper.

<script lang="ts">
import {QRCodeSVG, type QRCodeSVGOptions} from '@qrcodesdk/svelte';
const options: QRCodeSVGOptions = {
style: {moduleSize: 8, quietZone: 2},
accessibility: {ariaLabel: 'Scan to open qrcodesdk.dev'},
};
</script>
<QRCodeSVG class="mx-auto" payload="https://qrcodesdk.dev" {options} />
<script lang="ts">
import {QRCodePNG, type QRCodePNGImageOptions} from '@qrcodesdk/svelte';
const options: QRCodePNGImageOptions = {
style: {moduleSize: 8, quietZone: 2},
accessibility: {alt: 'QR code for qrcodesdk.dev'},
};
</script>
<QRCodePNG class="mx-auto" payload="https://qrcodesdk.dev" {options} />
<script lang="ts">
import {QRCodeWebP, type QRCodeWebPImageOptions} from '@qrcodesdk/svelte';
const options: QRCodeWebPImageOptions = {
style: {moduleSize: 8, quietZone: 2},
accessibility: {alt: 'QR code for qrcodesdk.dev'},
};
</script>
<QRCodeWebP class="mx-auto" payload="https://qrcodesdk.dev" {options} />
<script lang="ts">
import {QRCodeGIF, type QRCodeGIFImageOptions} from '@qrcodesdk/svelte';
const options: QRCodeGIFImageOptions = {
style: {moduleSize: 8, quietZone: 2},
accessibility: {alt: 'QR code for qrcodesdk.dev'},
};
</script>
<QRCodeGIF class="mx-auto" payload="https://qrcodesdk.dev" {options} />
<script lang="ts">
import {QRCodeJPEG, type QRCodeJPEGImageOptions} from '@qrcodesdk/svelte';
const options: QRCodeJPEGImageOptions = {
style: {moduleSize: 8, quietZone: 2},
quality: 90,
accessibility: {alt: 'QR code for qrcodesdk.dev'},
};
</script>
<QRCodeJPEG class="mx-auto" payload="https://qrcodesdk.dev" {options} />
<script lang="ts">
import {QRCodeCanvas, type QRCodeCanvasOptions} from '@qrcodesdk/svelte';
const options: QRCodeCanvasOptions = {style: {moduleSize: 8, quietZone: 2}};
</script>
<QRCodeCanvas class="mx-auto" payload="https://qrcodesdk.dev" {options} />
<script lang="ts">
import {
QRCodePNG,
type QRCodeDownloadHandle,
type QRCodePNGImageOptions,
} from '@qrcodesdk/svelte';
let qrcode: QRCodeDownloadHandle | undefined;
const options: QRCodePNGImageOptions = {accessibility: {alt: 'QR code for qrcodesdk.dev'}};
</script>
<div class="flex flex-col items-center gap-2">
<QRCodePNG bind:this={qrcode} payload="https://qrcodesdk.dev" {options} />
<button class="btn-primary" type="button" onclick={() => qrcode?.download('qrcodesdk')}>
Download PNG
</button>
</div>

Load and decode a browser image first, store it in rune-mode state, and pass canvasCenterImage(image) as options.centerImage. Render the PNG, WebP, GIF, JPEG, or Canvas component only after the source is ready. QRCodeSVG takes svgCenterImage() with an embedded data URL instead. See Add a center image for a complete Svelte example.

QRCodeSVG, QRCodePNG, QRCodeWebP, QRCodeGIF, and QRCodeJPEG expose download(filename?) for SVG, PNG, WebP, GIF, and JPEG files respectively. The method appends the matching file extension when needed. QRCodeCanvas has no download method.

See Download or save for the complete Svelte example, or its Canvas export section for manual downloads.

QRCodeSVG produces runtime-neutral SVG and can render on the server.

QRCodePNG, QRCodeWebP, QRCodeGIF, QRCodeJPEG, and QRCodeCanvas rely on browser DOM and Canvas APIs, so they render an empty wrapper on the server and populate it after mounting in the browser. Their download methods also skip work outside the browser.

The options prop groups encoding settings under matrix. Renderer settings such as style, accessibility, and centerImage go alongside it:

import {type QRCodeSVGOptions, circle, finder, rounded} from '@qrcodesdk/svelte';
const options: QRCodeSVGOptions = {
matrix: {errorCorrectionLevel: 'H'},
style: {moduleSize: 8, quietZone: 4, modules: rounded(), finder: finder({center: circle()})},
accessibility: {ariaLabel: 'Scan to open qrcodesdk.dev'},
};

Pass this object through the component’s options prop. Use QRCodePNGImageOptions, QRCodeWebPImageOptions, QRCodeGIFImageOptions, QRCodeJPEGImageOptions, or QRCodeCanvasOptions for the corresponding component. QRCodeGIFImageOptions also accepts transparency.threshold, and QRCodeJPEGImageOptions accepts quality and transparency.matte.

Import shape and pattern factories, and center-image factories from @qrcodesdk/svelte alongside the components.

Mixed-mode segmentation is opt-in. Import automaticSegmenter from @qrcodesdk/svelte and pass it as matrix.segmenter, without installing @qrcodesdk/core separately:

import {type QRCodeSVGOptions, automaticSegmenter} from '@qrcodesdk/svelte';
const options: QRCodeSVGOptions = {matrix: {mode: 'auto', segmenter: automaticSegmenter}};

See Builder and matrix for the fields inside matrix, Customize appearance for style, and Renderer outputs for output-specific options.

import {
type QRCodeAlignmentCenterShape,
type QRCodeAlignmentOptions,
type QRCodeAlignmentRingShape,
type QRCodeAlignmentStyle,
type QRCodeBaseProps,
QRCodeCanvas,
type QRCodeCanvasAccessibilityOptions,
type QRCodeCanvasCenterImage,
type QRCodeCanvasOptions,
type QRCodeCanvasProps,
type QRCodeCenterImageLayout,
type QRCodeCircleShapeOptions,
type QRCodeColor,
type QRCodeDataImageURL,
type QRCodeDownloadHandle,
type QRCodeEncodingMode,
type QRCodeErrorCorrectionLevel,
type QRCodeFinderCenterShape,
type QRCodeFinderOptions,
type QRCodeFinderRingShape,
type QRCodeFinderStyle,
QRCodeGIF,
type QRCodeGIFImageOptions,
type QRCodeGIFProps,
type QRCodeImageAccessibilityOptions,
QRCodeJPEG,
type QRCodeJPEGImageOptions,
type QRCodeJPEGProps,
type QRCodeMask,
type QRCodeMatrixOptions,
type QRCodeMode,
type QRCodeModulePattern,
type QRCodeModuleShape,
QRCodePNG,
type QRCodePNGImageOptions,
type QRCodePNGProps,
type QRCodePayload,
type QRCodeRoundedShapeOptions,
QRCodeSVG,
type QRCodeSVGAccessibilityOptions,
type QRCodeSVGCenterImage,
type QRCodeSVGOptions,
type QRCodeSVGProps,
type QRCodeSegment,
type QRCodeSegmenter,
type QRCodeSegmenterOptions,
type QRCodeShape,
type QRCodeShapePath,
type QRCodeShapePiece,
type QRCodeVersion,
type QRCodeVisualStyle,
QRCodeWebP,
type QRCodeWebPImageOptions,
type QRCodeWebPProps,
alignment,
automaticSegmenter,
canvasCenterImage,
circle,
customShape,
diagonal,
finder,
rounded,
svgCenterImage,
} from '@qrcodesdk/svelte';

@qrcodesdk/svelte

Version
v0.0.5
Downloads
365/mo
Install size
480.4 kB
Bundled size
5.1 kB
Works with
Works with Google ChromeWorks with FirefoxWorks with Safari

Support QRCodeSDK

If you find QRCodeSDK useful, please consider sponsoring the project!