更新记录

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

安装方法

  1. 在uni-app插件市场中搜索并导入lime-qrcode
  2. 导入后可能需要重新编译项目
  3. 在页面中使用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 演示标签,查看完整演示效果

文档链接

📚 组件详细文档请访问以下站点:

支持与赞赏

如果你觉得本插件解决了你的问题,可以考虑支持作者:

支付宝赞助 微信赞助

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

无

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无