@bonosoft/sveltekit-qrcode
v0.0.3
Published
QR Code generator component for SvelteKit
Downloads
1,058
Maintainers
Readme
QR Code generator for SvelteKit
Install
Use your package manager to install the module:
npm install @bonosoft/sveltekit-qrcode
Adding QR Codes to a svelte file in SvelteKit
Now you can start adding QR Codes to your pages.
<script lang="ts">
import QRCode from "@bonosoft/sveltekit-qrcode"
</script>
<QRCode content="Test"></QRCode>
Quick Response Codes
While conventional bar codes are capable of storing a maximum of approximately 20 digits, QR Code is capable of handling several dozen to several hundred times more information.
QR Code is capable of handling all types of data, such as numeric and alphabetic characters, Kanji, Kana, Hiragana, symbols, binary, and control codes. Up to 7,089 characters can be encoded in one symbol.
Content
Content is the text that needs to be send to the code reader. The text is normally an URL to a web site, or a code that is used by an application, for example in handling secrets in time based one time password applications.
<QRCode content="https://www.bonosoft.dk/"/>
Size, padding and responsive
You can set the size used for generation, the larger the size, the more information you are able to store in the QR code. The size is also used for the container in pixels. You can also specify the padding in module units, and recommended minimum is 4.
With the repsponsive settings enabled, the size settings will only be used in the code calculation, and the container will addapt and use all available space in it's parent element.
<QRCode size="50" content="https://www.bonosoft.dk/"/>
<QRCode padding="10" content="https://www.bonosoft.dk/"/>
<QRCode responsive='true' content="https://www.bonosoft.dk/"/>
Colours
With the colour settings, you can control both the front and background colour.
<QRCode color="#009900" content="https://www.bonosoft.dk/"/>
<QRCode color="#ffffff" bgcolor="#009900" content="https://www.bonosoft.dk/"/>
QR Code error correction
QR Code has error correction capability to restore data if the code is dirty or damaged. Four error correction levels are available for users to choose according to the operating environment. Raising this level improves error correction capability but also increases the amount of data QR Code size. To select error correction level, various factors such as the operating environment and QR Code size need to be considered. Level Q or H may be selected for factory environment where QR Code get dirty, whereas Level L may be selected for clean environment with the large amount of data. Typically, Level M (15%) is most frequently selected.
Level L Approx 7% Level M Approx 15% Level Q Approx 25% Level H Approx 30%
<QRCode errorCorrection='L' content="https://www.bonosoft.dk/"/>
<QRCode errorCorrection='M' content="https://www.bonosoft.dk/"/>
<QRCode errorCorrection='Q' content="https://www.bonosoft.dk/"/>
<QRCode errorCorrection='H' content="https://www.bonosoft.dk/"/>
For use with Time based one time passwords (TOTP)
Sample URL for a John Doe user on the Acme app:
<QRCode content="otpauth://totp/ACME%20Co:[email protected]?secret=HXDMVJECJJWSRB3HWIZR4IFUGFTMXBOZ&issuer=ACME%20Co&algorithm=SHA1&digits=6&period=30"/>