更新记录
2.0.1(2026-10-21)
- chore: 优化条件编译
2.0.0(2026-10-21)
- feat: 兼容 uni-app x 蒸汽模式
- feat: 新增 lClass/lStyle props
- fix: type.ts errorLevel 默认值注释由 H 修正为 M
0.2.4(2025-09-22)
- fix: uniappx ios报错
平台兼容性
uni-app(4.41)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | 5.0 | √ | √ |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | - | √ | √ | - | - | - |
uni-app x(4.61)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| √ | √ | 5.0 | √ | √ | √ |
name: lime-qrcode 二维码组件 description: 功能丰富的二维码生成组件,支持自定义大小、颜色、图标、边框等,适用于分享链接、支付码、名片等场景。 tags:
- qrcode
- 二维码
- 扫码
- 链接 componentTag: l-qrcode plugin: lime-qrcode category: 业务组件 dependencies:
-
lime-shared
lime-qrcode 二维码组件
一个功能丰富的二维码生成组件,用于生成自定义二维码。支持自定义大小、颜色、图标、边框等多种配置,可用于分享链接、支付码、名片等多种场景。组件提供了丰富的自定义选项,可以满足各种二维码生成需求。
插件依赖:lime-shared
安装方法
- 在uni-app插件市场中搜索并导入
lime-qrcode - 导入后可能需要重新编译项目
- 在页面中使用
l-qrcode组件
::: tip 注意🔔 uniappx app vdom需要导入【lime-qrcodegen】这个依赖插件,它是收费的插件,普通授权则需要自定义基座,才能使用,如果您是UI组件库VIP则忽略。 :::
代码演示
基础使用
<l-qrcode value="http://lime.qcoon.cn" />
渲染模式
- 支持 canvas 和 svg 两种渲染模式
<!-- Canvas 模式 -->
<l-qrcode value="https://limeui.qcoon.cn" mode="canvas" size="300rpx"></l-qrcode>
<!-- SVG 模式 -->
<l-qrcode value="https://limeui.qcoon.cn" mode="svg" size="300rpx"></l-qrcode>
码点形状
- 支持多种码点形状:方形、圆形、线形、小方块
<!-- 方形码点(默认) -->
<l-qrcode value="https://limeui.qcoon.cn" size="300rpx" code-point-shape="square"></l-qrcode>
<!-- 圆形码点 -->
<l-qrcode value="https://limeui.qcoon.cn" size="300rpx" code-point-shape="circle"></l-qrcode>
<!-- 线形码点 -->
<l-qrcode value="https://limeui.qcoon.cn" size="300rpx" code-point-shape="line"></l-qrcode>
<!-- 小方块码点 -->
<l-qrcode value="https://limeui.qcoon.cn" size="300rpx" code-point-shape="smallSquare"></l-qrcode>
码眼形状
- 支持方形和圆形码眼
<!-- 方形码眼(默认) -->
<l-qrcode value="https://limeui.qcoon.cn" size="300rpx" code-eye-shape="square"></l-qrcode>
<!-- 圆形码眼 -->
<l-qrcode value="https://limeui.qcoon.cn" size="300rpx" code-eye-shape="circle"></l-qrcode>
码眼颜色
- 自定义码眼颜色,支持设置外圈和内圈颜色
<l-qrcode value="https://limeui.qcoon.cn" size="300rpx" :code-eye-color="['#ff0000', 'rgba(82,196,26,1)']"></l-qrcode>
带图标
- 带 Icon 的二维码
<l-qrcode value="https://limeui.qcoon.cn" size="300rpx" icon="/static/logo.png" iconSize="70rpx"></l-qrcode>
颜色
- 通过设置
color自定义二维码颜色,通过设置bgColor自定义背景颜色。
<l-qrcode value="https://limeui.qcoon.cn" size="300rpx" color="rgb(82,196,26)"></l-qrcode>
<l-qrcode value="https://limeui.qcoon.cn" size="300rpx" color="rgb(22,119,255)" bgColor="rgb(245,245,245)"></l-qrcode>
纠错比例
- 通过设置
errorLevel调整不同的容错等级。
<l-qrcode value="https://limeui.qcoon.cn" size="300rpx" errorLevel="H"></l-qrcode>
生成图片
如果是canvas 2d的环境生成的是base64
- 1、通过设置
useCanvasToTempFilePath在success事件里接收图片地址
<image v-if="image" :src="image" style="width: 300rpx;" mode="widthFix"></image>
<l-qrcode :useCanvasToTempFilePath="true" @success="success" value="https://limeui.qcoon.cn"></l-qrcode>
const image = ref(null)
const success = (img) => {
image.value = img
}
API文档
Props 分类
🎯 基础配置(最常用)
| 属性名 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| value | 二维码内容(支持文本/URL等) | string | string[] | - | - |
| size | 二维码尺寸 | number | string | 160 |
- |
| color | 二维码颜色 | string | #000000 |
- |
| bgColor | 背景颜色 | string | #ffffff |
- |
| errorLevel | 容错等级 | string | M |
L, M, Q, H |
| mode | 二维码模式 | string | svg |
canvas, svg |
🎨 样式与外观
| 属性名 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| icon | 中心图标路径(支持本地/网络路径) | string | - | - |
| iconSize | 中心图标尺寸 | number | string | 40 |
- |
| marginSize | 二维码外边距 | number | 0 |
- |
| bordered | 显示边框 | boolean | false | true, false |
| codePointShape | 码点形状 | string | square |
circle, square, line, smallSquare |
| codeEyeShape | 码眼形状 | string | square |
circle, square |
| codeEyeColor | 码眼颜色 [外圈颜色, 内圈颜色] | string[] | - | - |
🔧 高级配置
| 属性名 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| useCanvasToTempFilePath | 使用canvas生成临时路径 | boolean | false | true, false |
| title | 二维码标题(用于无障碍访问) | string | - | - |
| boostLevel | 是否提升容错等级 | boolean | true | true, false |
| minVersion | 最小版本号 | number | 1 |
- |
🔧 高级配置
| 参数 | 说明 | 类型 | 默认值 | 可选值 |
|---|---|---|---|---|
| ariaLabel | 无障碍标签(用于屏幕阅读器) | string | - | - |
| ariaRole | 无障碍角色 | string | - | - |
Events
| 事件名 | 说明 | 回调参数 | 类型说明 |
|---|---|---|---|
| success | 二维码生成完成时触发 | img | 图片地址(仅当 useCanvasToTempFilePath 为 true 时有效) |
Methods
| 方法名 | 说明 | 参数 | 返回值 |
|---|---|---|---|
| canvasToTempFilePath | 将二维码转为临时图片路径 | options: { success, fail } | - |
主题定制
组件支持通过 color 和 bgColor 属性自定义二维码颜色和背景颜色,无需额外 CSS 变量配置。
Vue2使用说明
main.js中添加以下代码:
// vue2项目中使用
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)
详细配置请参考官方文档:Vue Composition API
快速预览
导入插件后,可以直接使用以下标签查看演示效果:
<!-- 代码位于 uni_modules/lime-qrcode/components/lime-qrcode -->
<lime-qrcode />
插件标签说明
| 标签类型 | 示例 | 说明 |
|---|---|---|
| 组件标签 | l-qrcode |
二维码组件标签 |
| 演示标签 | lime-qrcode |
演示标签,查看完整演示效果 |
文档链接
📚 组件详细文档请访问以下站点:
支持与赞赏
如果你觉得本插件解决了你的问题,可以考虑支持作者:
| 支付宝赞助 | 微信赞助 |
|---|---|
![]() |
![]() |

收藏人数:
购买源码授权版(
试用
赞赏(94)


下载 74666
赞赏 604
下载 12775967
赞赏 1960
赞赏
京公网安备:11010802035340号