更新记录
1.0.0(2026-11-18)
- 首个版本
- 纯 JS 二维码编码器:UTF-8(中文/emoji)、版本 1-40 自动选择、纠错等级 L/M/Q/H、Reed-Solomon 纠错、8 种掩码自动择优;与 qrcode-generator 参考实现完成 538 组用例逐模块交叉验证
- canvas / view 双渲染模式,canvas 环境探测失败自动降级 view
- 平台支持:H5、微信/支付宝/抖音/百度/QQ/飞书/快手/京东/小红书小程序、App-vue / App-nvue、App 鸿蒙(HarmonyOS)、uni-app x 蒸汽模式
- 码点形状(square/circle/dot)、码眼形状(square/circle)、码眼双色、中心图标(本地/网络)、静区控制
toTempFilePath图片导出、useCanvasToTempFilePath自动导出、success/error事件
平台兼容性
uni-app(4.66)
| Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | 5.0 | √ | √ |
| 微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 小红书小程序 | 快应用-华为 | 快应用-联盟 |
|---|---|---|---|---|---|---|---|---|---|---|---|
| √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ | √ |
uni-app x(4.66)
| Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
|---|---|---|---|---|---|
| √ | √ | 5.0 | √ | √ | √ |
其他
| 多语言 | 暗黑模式 | 宽屏模式 | 蒸汽模式 |
|---|---|---|---|
| × | × | × | √ |
ant-qrcode 全平台二维码组件
基于 uni-app 的二维码生成组件,一套代码运行于 H5、各家小程序、App(vue/nvue,含鸿蒙 HarmonyOS)、uni-app x 蒸汽模式。
- 内置纯 JS 二维码编码器:UTF-8 中文/emoji、版本 1-40 自动选择、纠错等级 L/M/Q/H、Reed-Solomon 纠错、8 种掩码自动择优(与 qrcode-generator 逐模块对齐验证)
- canvas / view 双渲染模式,canvas 不可用的环境自动降级为纯 view 渲染,任何端都不会白屏
- 码点形状(方形/圆形/圆点)、码眼形状(方形/圆形)与颜色自定义、中心图标、静区控制
- canvas 模式支持导出临时图片(
toTempFilePath/useCanvasToTempFilePath)
平台支持
| 平台 | 支持 | 说明 |
|---|---|---|
| H5(Chrome/Safari/Firefox/Edge) | ✅ | 2d canvas,导出 base64 |
| 微信小程序 | ✅ | canvas type="2d" 同层渲染 |
| 支付宝 / 抖音 / 百度 / QQ / 飞书 / 快手 / 京东 / 小红书 | ✅ | 旧版 CanvasContext |
| App-Android / App-iOS(vue) | ✅ | 2d 节点,不可用时旧版上下文 |
| App-鸿蒙(HarmonyOS) | ✅ | 同 App-vue 渲染管线 |
| App-nvue | ✅ | 自动使用 view 模式渲染 |
| uni-app x 蒸汽模式 | ✅ | 推荐 mode="view";canvas 走 2d 节点自动探测,失败自动回退 view |
| uni-app x 原生(uts) | ❌ | 需 UTS 实现,请等待后续版本 |
组件为 options API 编写,同时兼容 Vue2 / Vue3。
快速开始
组件符合 easycom 规范,将 uni_modules/ant-qrcode 拷入项目后直接使用,无需注册:
<template>
<ant-qrcode value="https://uniapp.dcloud.net.cn" />
</template>
属性 Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| value | String / Number | '' |
二维码内容(文本/URL,UTF-8) |
| size | Number / String | 200 |
尺寸,支持 200、'160px'、'300rpx' |
| mode | String | 'canvas' |
渲染模式:canvas / view(svg 作为 view 别名兼容) |
| color | String | '#000000' |
码点颜色 |
| bgColor | String | '#ffffff' |
背景颜色,'transparent' 为透明 |
| errorLevel | String | 'M' |
纠错等级 L(7%) / M(15%) / Q(25%) / H(30%) |
| version | Number | 0 |
指定版本 1-40;0 自动选择最小可容纳版本 |
| minVersion | Number | 1 |
自动选择版本时的最小版本(提升容错冗余) |
| marginSize | Number | 2 |
静区(白边)宽度,单位:模块数 |
| bordered | Boolean | true |
是否绘制静区(false 时白边为 0) |
| icon | String | '' |
中心图标,本地路径或网络地址 |
| iconSize | Number / String | 40 |
图标尺寸:40、'40px'、'80rpx'、'25%'(相对 size) |
| codePointShape | String | 'square' |
码点形状:square 方形 / circle 圆形 / dot 小圆点 |
| codeEyeShape | String | 'square' |
码眼形状:square / circle |
| codeEyeColor | String / Array | '' |
码眼颜色,默认继承 color;数组 [外圈色, 内芯色] 可分别设置 |
| useCanvasToTempFilePath | Boolean | false |
生成后自动导出图片并通过 success 事件返回 |
| fileType | String | 'png' |
导出格式 png / jpg |
| title | String | '' |
无障碍标题(aria-label) |
事件 Events
| 事件名 | 说明 | 回调参数 |
|---|---|---|
| success | 生成完成 | { mode, count, version, tempFilePath?, fallback? },开启 useCanvasToTempFilePath 时含 tempFilePath |
| error | 生成失败(内容超容量等) | { errMsg } |
方法 Methods(通过 ref 调用)
| 方法名 | 说明 | 参数 |
|---|---|---|
| toTempFilePath | 导出为临时图片,返回 Promise(仅 canvas 模式) | (options) 透传 uni.canvasToTempFilePath:fileType / quality / destWidth / destHeight |
| repaint | 手动触发重绘 | - |
使用示例
<template>
<view>
<!-- 基础用法 -->
<ant-qrcode value="http://ant.localhost" />
<!-- 自定义颜色 + 尺寸 -->
<ant-qrcode
value="https://uniapp.dcloud.net.cn"
size="300rpx"
color="rgb(82, 196, 26)"
bg-color="#ffffff"
/>
<!-- 圆点 + 圆码眼 + 双色码眼 -->
<ant-qrcode
value="蒸汽模式 Steam Mode"
size="240"
mode="view"
code-point-shape="dot"
code-eye-shape="circle"
:code-eye-color="['#1a1a1a', '#e1251b']"
/>
<!-- 中心图标 + 高容错 -->
<ant-qrcode
value="https://ext.dcloud.net.cn/plugin?id=12939"
size="260"
error-level="H"
icon="/static/logo.png"
icon-size="52"
/>
<!-- 生成后自动导出图片 -->
<ant-qrcode
ref="qr"
value="export me"
use-canvas-to-temp-file-path
@success="onSuccess"
/>
</view>
</template>
<script>
export default {
methods: {
onSuccess(e) {
console.log('二维码图片:', e.tempFilePath)
},
save() {
// 手动导出
this.$refs.qr.toTempFilePath({ fileType: 'png' }).then((res) => {
uni.previewImage({ urls: [res.tempFilePath] })
})
}
}
}
</script>
渲染模式说明
canvas 模式(默认)
按以下顺序自动探测可用上下文,全部失败时自动降级为 view 模式:
- Canvas 2D 节点(
SelectorQuery.fields({ node: true }))— 微信小程序、uni-app x 蒸汽模式、部分 App - H5 DOM canvas
- 旧版
uni.createCanvasContext— 支付宝/抖音/百度/QQ 等小程序、App-vue
view 模式
纯 <view> 百分比布局渲染,不依赖任何 canvas API:
- 任何环境 100% 可用(nvue、蒸汽模式、低版本基础库等)
- 方形码点自动做横向 run 合并,控制节点数量
- 不支持导出图片(无画布)
常见问题
Q:内容最长能放多少?
版本 40 / 纠错 L 下约 2953 字节(UTF-8)。超限会触发 error 事件并提示容量。
Q:中文是 UTF-8 编码吗? 是,内置 UTF-8 编码器,中文、emoji 均正常。
Q:鸿蒙 App 如何验证? HBuilderX 4.x 选择「App 鸿蒙」运行时即可;组件走标准 vue 渲染管线,无原生依赖。
Q:蒸汽模式注意什么?
蒸汽模式下推荐 mode="view"(零 API 依赖);mode="canvas" 会尝试 2d 节点,失败自动回退 view,不会报错中断。
目录结构
ant-qrcode
└── uni_modules/ant-qrcode
├── package.json
├── readme.md
├── changelog.md
└── components/ant-qrcode
├── ant-qrcode.vue # 组件(双渲染模式 / 多端适配)
└── core
├── qrcode.js # 纯 JS 二维码编码器
├── painter.js # canvas 绘制器(2d / 旧版上下文统一适配)
└── utils.js # 尺寸解析、节点查询、图标下载等工具

收藏人数:
购买源码授权版(
试用
赞赏(0)
下载 31
赞赏 1
下载 12771827
赞赏 1959
赞赏
京公网安备:11010802035340号