next-qrcode
next-qrcode copied to clipboard
Bunlong
React hooks for generating QRCode for your next React apps.
next-qrcode
React hooks for generating QR code for your next React apps.
🎁 Features
- Render Canvas & Image
- Support Numeric, Alphanumeric, Kanji and Byte mode
- Support Japanese, Chinese, Greek and Cyrillic characters
- Support multibyte characters (like emojis smile)
🔧 Install
next-qrcode is available on npm. It can be installed with the following command:
npm install next-qrcode --save
next-qrcode is available on yarn as well. It can be installed with the following command:
yarn add next-qrcode
💡 Canvas
usage
import React from 'react';
import { useQRCode } from 'next-qrcode';
function App() {
const { Canvas } = useQRCode();
return (
<Canvas
text={'https://github.com/bunlong/next-qrcode'}
options={{
type: 'image/jpeg',
quality: 0.3,
level: 'M',
margin: 3,
scale: 4,
width: 200,
color: {
dark: '#010599FF',
light: '#FFBF60FF',
},
}}
/>
);
}
export default App;
props
| Prop | Type | Require | Description |
|---|---|---|---|
| text | string | ✔️ | Text/URL to encode. |
| options | options | ❌ | QR code options. |
options
| Prop | Type | Default | Require | Description |
|---|---|---|---|---|
| level | string | M |
❌ | Correction level. Possible values are low, medium, quartile, high or L, M, Q, H. |
| margin | number | 4 |
❌ | Define how much wide the quiet zone should be. |
| scale | number | 4 |
❌ | Scale factor. A value of 1 means 1px per modules (black dots). |
| width | number | 4 |
❌ | Forces a specific width for the output image. If width is too small to contain the qr symbol, this option will be ignored. Takes precedence over scale. |
| color.dark | string | #000000ff |
❌ | Color of dark module. Value must be in hex format (RGBA). Note: dark color should always be darker than color.light. |
| color.light | string | #ffffffff |
❌ | Color of light module. Value must be in hex format (RGBA). |
💡 Image
usage
import React from 'react';
import { useQRCode } from 'next-qrcode';
function App() {
const { Image } = useQRCode();
return (
<Image
text={'https://github.com/bunlong/next-qrcode'}
options={{
type: 'image/jpeg',
quality: 0.3,
level: 'M',
margin: 3,
scale: 4,
width: 200,
color: {
dark: '#010599FF',
light: '#FFBF60FF',
},
}}
/>
);
}
export default App;
props
| Prop | Type | Require | Description |
|---|---|---|---|
| text | string | ✔️ | Text/URL to encode. |
| options | object | ❌ | QR code options |
options
| Prop | Type | Default | Require | Description |
|---|---|---|---|---|
| type | string (image/png, image/jpeg, image/webp) |
image/png |
❌ | Image format. |
| quality | number | 0.92 |
❌ | A Number between 0 and 1 indicating image quality if the type is image/jpeg or image/webp. |
| level | string | M |
❌ | Correction level. Possible values are low, medium, quartile, high or L, M, Q, H. |
| margin | number | 4 |
❌ | Define how much wide the quiet zone should be. |
| scale | number | 4 |
❌ | Scale factor. A value of 1 means 1px per modules (black dots). |
| width | number | 4 |
❌ | Forces a specific width for the output image. If width is too small to contain the qr symbol, this option will be ignored. Takes precedence over scale. |
| color.dark | string | #000000ff |
❌ | Color of dark module. Value must be in hex format (RGBA). Note: dark color should always be darker than color.light. |
| color.light | string | #ffffffff |
❌ | Color of light module. Value must be in hex format (RGBA). |
📜 Changelog
Latest version 2.2.0 (2022-08-14):
- Update dependencies
Details changes for each release are documented in the CHANGELOG.md.
❗ Issues
If you think any of the next-qrcode can be improved, please do open a PR with any updates and submit any issues. Also, I will continue to improve this, so you might want to watch/star this repository to revisit.
🌟 Contribution
We'd love to have your helping hand on contributions to next-qrcode by forking and sending a pull request!
Your contributions are heartily ♡ welcome, recognized and appreciated. (✿◠‿◠)
How to contribute:
- Open pull request with improvements
- Discuss ideas in issues
- Spread the word
- Reach out with any feedback
🏆 Contributors
Bunlong |
Michael Desa |
Jared Scheib |
👨👩👦 Advertisement
You maybe interested.
- React Patterns – React patterns & techniques to use in development for React Developer.
- React Patterns Blog – The latest React news and articles.
- React Papaparse – The fastest in-browser CSV (or delimited text) parser for React.
- Next Share – Social media share buttons for your next React apps.
⚖️ License
The MIT License 
Bunlong