更新记录

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 模式:

  1. Canvas 2D 节点(SelectorQuery.fields({ node: true }))— 微信小程序、uni-app x 蒸汽模式、部分 App
  2. H5 DOM canvas
  3. 旧版 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      # 尺寸解析、节点查询、图标下载等工具

隐私、权限声明

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

无

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

插件在本地生成二维码,不采集任何数据

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

无

暂无用户评论。