更新记录

0.1.1（2026-06-01） 下载此版本

更新日志

0.1.0 - 2026-06-01

  • 将 i-qrcode 从 i-ui-x 拆分为独立的 uni_modules 组件插件。
  • 新增独立插件元数据、中文使用说明和更新日志。
  • 补充二维码内容、样式、状态、刷新事件和中心 logo 配置说明。
  • 修复 logoSize="50px" 时白色 logo 背景实际遮挡范围过大的问题。
  • 修复 H 级二维码生成逻辑，按标准分块生成纠错码并交错写入。

0.1.0（2026-06-01） 下载此版本

更新日志

0.1.0 - 2026-06-01

  • 将 i-qrcode 从 i-ui-x 拆分为独立的 uni_modules 组件插件。
  • 新增独立插件元数据、中文使用说明和更新日志。
  • 补充二维码内容、样式、状态、刷新事件和中心 logo 配置说明。
  • 修复 logoSize="50px" 时白色 logo 背景实际遮挡范围过大的问题。
  • 修复 H 级二维码生成逻辑，按标准分块生成纠错码并交错写入。

平台兼容性

uni-app x(3.7.8)

Chrome Safari Android iOS 鸿蒙 微信小程序
√ √ √ √ √ √

i-qrcode

二维码组件，支持本地生成 QR 矩阵、容错级别、中心 logo、状态层和刷新事件。

插件信息

  • 组件名称：i-qrcode
  • 简介：二维码组件，支持本地生成 QR 矩阵、容错级别、中心 logo、状态层和刷新事件。
  • 标签：uni-app-x uni_modules 组件 uvue i-qrcode
  • 版本信息：0.1.0

安装

将本目录放入项目的 src/uni_modules/i-qrcode。UniAppX 会自动发现 components/i-qrcode/i-qrcode.uvue。

基础用法

<template>
  <i-qrcode
    value="https://uniapp.dcloud.net.cn/"
    :size="180"
    foreground="#111827"
    pdground="#2979ff"
    logo="/static/logo.png"
    logoBgColor="transparent"
    logoSize="50px"
    level="L"
    @refresh="handleRefresh"
  ></i-qrcode>
</template>

组件信息

  • 组件名称：i-qrcode
  • 显示名称：I UI X QRCode 二维码
  • 组件文件：components/i-qrcode/i-qrcode.uvue
  • 开发规范：依据 DCloud uni-app x 规范实现，优先使用 UniAppX 内置组件与 UVUE 能力。
  • 依赖组件：无

Props

参数 类型 默认值 说明
value - - 二维码要编码的内容；内容变化时会重新生成二维码，并触发 change。
text String '' 兼容文本内容入口；传入后优先于 value 作为二维码内容。
size Number 180 二维码矩阵区域尺寸，单位 px；组件会按模块数量计算单格尺寸。
background String '#ffffff' 二维码背景色，用于空白模块和静区背景，默认 #ffffff。
foreground String '#000000' 二维码前景色，用于普通深色模块，默认 #000000。
pdground String '#000000' 定位角点颜色，用于左上、右上、左下三个定位图案，默认 #000000。
level String 'L' 容错级别枚举，可选 L | M | Q | H；容错能力从 L 到 H 逐级增强。设置 logo 或 icon 后会自动使用 H 级容错生成二维码；H 级会按 QR 标准进行多纠错块交错写入。
logo String '' 二维码中心 logo 图片路径，默认空；仅在正常状态且二维码生成成功后显示。
logoBgColor String 'transparent' logo 容器背景颜色，默认 transparent；需要白底留白时可传 #ffffff。
logoSize String '50px' logo 总占位大小，默认 50px；支持 50、50px 等写法，不会再额外扩大白底遮挡区域。
icon String '' 兼容旧 API 的二维码中心图标地址；未传 logo 时会作为 logo 使用。
iconSize Number 30 兼容旧 API 的中心图标大小，单位 px；仅在未传 logo 时作为尺寸回退。
status String '' 二维码状态枚举，可选 expired | scanned | loading；空字符串表示正常可扫码状态。
expiredText String '二维码已过期' status 为 expired 时的过期提示文字，默认“二维码已过期”。
scannedText String '二维码已扫描' status 为 scanned 时的已扫码提示文字，默认“二维码已扫描”。
refreshText String '刷新' status 为 expired 时刷新按钮文字，默认“刷新”。

Events

事件名 说明
click 点击二维码整体时触发，回调参数为当前实际编码内容。
change 二维码重新生成时触发；value、text 变化或手动 refresh 后都会派发。
refresh 点击过期状态中的刷新按钮时触发，回调参数为当前实际编码内容。
error 二维码生成失败时触发；例如内容过长导致当前版本无法容纳。

Slots

插槽名 说明
default 默认内容插槽。

Methods

无公开 Methods。

演示页面

本项目中的演示页面位于 src/subpkg 对应分类目录。演示页包含效果演示、Props 调试和 API 说明。

隐私、权限声明

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

无

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

插件不采集任何数据。

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

无

许可协议

MIT协议
评论列表 撰写评论 向官方投诉

暂无用户评论。