# QR Code URL: https://ark-ui.com/docs/components/qr-code Source: https://raw.githubusercontent.com/chakra-ui/ark/refs/heads/main/website/src/content/pages/components/qr-code.mdx A component that generates a QR code based on the provided data. --- ## Anatomy ```tsx ``` ## Examples **Example: basic** #### React ```tsx import { QrCode } from '@ark-ui/react/qr-code' import styles from 'styles/qr-code.module.css' export const Basic = () => { return ( ) } ``` #### Solid ```tsx import { QrCode } from '@ark-ui/solid/qr-code' import styles from 'styles/qr-code.module.css' export const Basic = () => { return ( ) } ``` #### Vue ```vue ``` #### Svelte ```svelte ``` ### With Overlay You can also add a logo or overlay to the QR code. This is useful when you want to brand the QR code. **Example: overlay** #### React ```tsx import { QrCode } from '@ark-ui/react/qr-code' import styles from 'styles/qr-code.module.css' export const Overlay = () => { return ( Ark UI Logo ) } ``` #### Solid ```tsx import { QrCode } from '@ark-ui/solid/qr-code' import styles from 'styles/qr-code.module.css' export const Overlay = () => { return ( Ark UI Logo ) } ``` #### Vue ```vue ``` #### Svelte ```svelte Ark UI Logo ``` ### Error Correction In cases where the link is too long or the logo overlay covers a significant area, the error correction level can be increased. Use the `encoding.ecc` or `encoding.boostEcc` property to set the error correction level: - `L`: Allows recovery of up to 7% data loss (default) - `M`: Allows recovery of up to 15% data loss - `Q`: Allows recovery of up to 25% data loss - `H`: Allows recovery of up to 30% data loss **Example: error-correction** #### React ```tsx import { QrCode } from '@ark-ui/react/qr-code' import { RadioGroup } from '@ark-ui/react/radio-group' import { useState } from 'react' import styles from 'styles/qr-code.module.css' import radio from 'styles/radio-group.module.css' type ErrorLevel = 'L' | 'M' | 'Q' | 'H' export const ErrorCorrection = () => { const [errorLevel, setErrorLevel] = useState('L') return (
setErrorLevel(e.value as ErrorLevel)} >
{['L', 'M', 'Q', 'H'].map((level) => ( {level} ))}
) } ``` #### Solid ```tsx import { QrCode } from '@ark-ui/solid/qr-code' import { RadioGroup } from '@ark-ui/solid/radio-group' import { For, createSignal } from 'solid-js' import styles from 'styles/qr-code.module.css' import radio from 'styles/radio-group.module.css' type ErrorLevel = 'L' | 'M' | 'Q' | 'H' export const ErrorCorrection = () => { const [errorLevel, setErrorLevel] = createSignal('L') return (
setErrorLevel(e.value as ErrorLevel)} >
{(level) => ( {level} )}
) } ``` #### Vue ```vue ``` #### Svelte ```svelte
(errorLevel = e.value as ErrorLevel)} >
{#each levels as level} {level} {/each}
``` ### Root Provider An alternative way to control the QR code is to use the `RootProvider` component and the `useQrCode` hook. This way you can access the state and methods from outside the component. **Example: root-provider** #### React ```tsx import { QrCode, useQrCode } from '@ark-ui/react/qr-code' import styles from 'styles/qr-code.module.css' export const RootProvider = () => { const qrCode = useQrCode({ value: 'http://ark-ui.com' }) return (
{qrCode.value}
) } ``` #### Solid ```tsx import { QrCode, useQrCode } from '@ark-ui/solid/qr-code' import styles from 'styles/qr-code.module.css' export const RootProvider = () => { const qrCode = useQrCode({ value: 'http://ark-ui.com' }) return (
{qrCode().value}
) } ``` #### Vue ```vue ``` #### Svelte ```svelte
{qrCode().value}
``` ### Download Use the `QrCode.DownloadTrigger` component to allow users to download the QR code as an image. Specify the `fileName` and `mimeType` props for the downloaded file. **Example: download** #### React ```tsx import { QrCode } from '@ark-ui/react/qr-code' import button from 'styles/button.module.css' import styles from 'styles/qr-code.module.css' export const Download = () => { return ( Download ) } ``` #### Solid ```tsx import { QrCode } from '@ark-ui/solid/qr-code' import button from 'styles/button.module.css' import styles from 'styles/qr-code.module.css' export const Download = () => { return ( Download ) } ``` #### Vue ```vue ``` #### Svelte ```svelte Download ``` ## API Reference ### Props **Component API Reference** #### React **Root Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `boolean` | No | Use the provided child element as the default rendered element, combining their props and behavior. | | `defaultValue` | `string` | No | The initial value to encode when rendered. Use when you don't need to control the value of the qr code. | | `encoding` | `QrCodeGenerateOptions` | No | The qr code encoding options. | | `id` | `string` | No | The unique identifier of the machine. | | `ids` | `Partial<{ root: string; frame: string }>` | No | The element ids. | | `onValueChange` | `(details: ValueChangeDetails) => void` | No | Callback fired when the value changes. | | `pixelSize` | `number` | No | The pixel size of the qr code. | | `value` | `string` | No | The controlled value to encode. | **Root CSS Variables:** | Variable | Description | |----------|-------------| | `--qrcode-pixel-size` | The size of the Root | | `--qrcode-width` | The width of the Root | | `--qrcode-height` | The height of the Root | **DownloadTrigger Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `fileName` | `string` | Yes | The name of the file. | | `mimeType` | `DataUrlType` | Yes | The mime type of the image. | | `asChild` | `boolean` | No | Use the provided child element as the default rendered element, combining their props and behavior. | | `quality` | `number` | No | The quality of the image. | **Frame Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `boolean` | No | Use the provided child element as the default rendered element, combining their props and behavior. | **Overlay Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `boolean` | No | Use the provided child element as the default rendered element, combining their props and behavior. | **Pattern Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `boolean` | No | Use the provided child element as the default rendered element, combining their props and behavior. | **RootProvider Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `value` | `UseQrCodeReturn` | Yes | | | `asChild` | `boolean` | No | Use the provided child element as the default rendered element, combining their props and behavior. | #### Solid **Root Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `(props: ParentProps<'div'>) => Element` | No | Use the provided child element as the default rendered element, combining their props and behavior. | | `defaultValue` | `string` | No | The initial value to encode when rendered. Use when you don't need to control the value of the qr code. | | `encoding` | `QrCodeGenerateOptions` | No | The qr code encoding options. | | `ids` | `Partial<{ root: string; frame: string }>` | No | The element ids. | | `onValueChange` | `(details: ValueChangeDetails) => void` | No | Callback fired when the value changes. | | `pixelSize` | `number` | No | The pixel size of the qr code. | | `value` | `string` | No | The controlled value to encode. | **Root CSS Variables:** | Variable | Description | |----------|-------------| | `--qrcode-pixel-size` | The size of the Root | | `--qrcode-width` | The width of the Root | | `--qrcode-height` | The height of the Root | **DownloadTrigger Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `fileName` | `string` | Yes | The name of the file. | | `mimeType` | `DataUrlType` | Yes | The mime type of the image. | | `asChild` | `(props: ParentProps<'button'>) => Element` | No | Use the provided child element as the default rendered element, combining their props and behavior. | | `quality` | `number` | No | The quality of the image. | **Frame Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `(props: ParentProps<'svg'>) => Element` | No | Use the provided child element as the default rendered element, combining their props and behavior. | **Overlay Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `(props: ParentProps<'div'>) => Element` | No | Use the provided child element as the default rendered element, combining their props and behavior. | **Pattern Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `(props: ParentProps<'path'>) => Element` | No | Use the provided child element as the default rendered element, combining their props and behavior. | **RootProvider Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `value` | `UseQrCodeReturn` | Yes | | | `asChild` | `(props: ParentProps<'div'>) => Element` | No | Use the provided child element as the default rendered element, combining their props and behavior. | #### Vue **Root Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `boolean` | No | Use the provided child element as the default rendered element, combining their props and behavior. | | `defaultValue` | `string` | No | The initial value to encode when rendered. Use when you don't need to control the value of the qr code. | | `encoding` | `QrCodeGenerateOptions` | No | The qr code encoding options. | | `id` | `string` | No | The unique identifier of the machine. | | `ids` | `Partial<{ root: string; frame: string }>` | No | The element ids. | | `modelValue` | `string` | No | The v-model value of the qr code | | `pixelSize` | `number` | No | The pixel size of the qr code. | **Root CSS Variables:** | Variable | Description | |----------|-------------| | `--qrcode-pixel-size` | The size of the Root | | `--qrcode-width` | The width of the Root | | `--qrcode-height` | The height of the Root | **DownloadTrigger Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `fileName` | `string` | Yes | The name of the file. | | `mimeType` | `DataUrlType` | Yes | The mime type of the image. | | `asChild` | `boolean` | No | Use the provided child element as the default rendered element, combining their props and behavior. | | `quality` | `number` | No | The quality of the image. | **Frame Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `boolean` | No | Use the provided child element as the default rendered element, combining their props and behavior. | **Overlay Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `boolean` | No | Use the provided child element as the default rendered element, combining their props and behavior. | **Pattern Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `boolean` | No | Use the provided child element as the default rendered element, combining their props and behavior. | **RootProvider Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `value` | `QrCodeApi` | Yes | | | `asChild` | `boolean` | No | Use the provided child element as the default rendered element, combining their props and behavior. | #### Svelte **Root Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `Snippet<[PropsFn<'div'>]>` | No | Use the provided child element as the default rendered element, combining their props and behavior. | | `defaultValue` | `string` | No | The initial value to encode when rendered. Use when you don't need to control the value of the qr code. | | `encoding` | `QrCodeGenerateOptions` | No | The qr code encoding options. | | `id` | `string` | No | The unique identifier of the machine. | | `ids` | `Partial<{ root: string; frame: string }>` | No | The element ids. | | `onValueChange` | `(details: ValueChangeDetails) => void` | No | Callback fired when the value changes. | | `pixelSize` | `number` | No | The pixel size of the qr code. | | `ref` | `Element` | No | | | `value` | `string` | No | The controlled value to encode. | **Root CSS Variables:** | Variable | Description | |----------|-------------| | `--qrcode-pixel-size` | The size of the Root | | `--qrcode-width` | The width of the Root | | `--qrcode-height` | The height of the Root | **Context Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `api` | `Snippet<[UseQrCodeContext]>` | No | | **DownloadTrigger Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `fileName` | `string` | Yes | The name of the file. | | `mimeType` | `DataUrlType` | Yes | The mime type of the image. | | `asChild` | `Snippet<[PropsFn<'button'>]>` | No | Use the provided child element as the default rendered element, combining their props and behavior. | | `quality` | `number` | No | The quality of the image. | | `ref` | `Element` | No | | **Frame Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `Snippet<[PropsFn<'svg'>]>` | No | Use the provided child element as the default rendered element, combining their props and behavior. | | `ref` | `Element` | No | | **Overlay Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `Snippet<[PropsFn<'div'>]>` | No | Use the provided child element as the default rendered element, combining their props and behavior. | | `ref` | `Element` | No | | **Pattern Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `asChild` | `Snippet<[PropsFn<'path'>]>` | No | Use the provided child element as the default rendered element, combining their props and behavior. | | `ref` | `Element` | No | | **RootProvider Props:** | Prop | Type | Required | Description | |------|------|----------|-------------| | `value` | `UseQrCodeReturn` | Yes | | | `ref` | `Element` | No | | ### Context **API:** | Property | Type | Description | |----------|------|-------------| | `value` | `string` | The value to encode. | | `setValue` | `(value: string) => void` | Set the value to encode. | | `getDataUrl` | `(type: DataUrlType, quality?: number) => Promise` | Returns the data URL of the qr code. |