Skip to content

Qrcode 二维码

用于根据文本内容生成二维码,支持尺寸、颜色、边距、容错级别、Logo 叠加以及导出图片能力。

示例

基础用法

自定义样式

Logo 和导出

API

Props

属性名说明类型默认值
value二维码内容string必填
size二维码尺寸,单位 pxnumber100
margin边距模块数number0
color-dark深色模块颜色string'#000000'
color-light浅色背景颜色string'#ffffff'
error-level容错级别'L' | 'M' | 'Q' | 'H''M'
logoLogo 图片地址string''
logo-sizeLogo 尺寸占二维码比例,范围 0-1number0.2

Events

该组件无自定义事件。

Slots

该组件无插槽。

Exposes

方法名说明类型
toImage获取二维码图片 Base64 地址() => string
downloadImage下载二维码图片(fileName?: string) => unknown

注意事项

  • 组件将二维码内容绘制为图片后展示。
  • value 为空时不会生成二维码。
  • 当前仅监听 valuelogo 变化后重新生成二维码;动态修改 sizemargincolor-darkcolor-lighterror-levellogo-size 不会立即触发重新生成,需要同时更新 value 或重新挂载组件。
  • toImagedownloadImage 依赖已生成的图片数据,建议在组件渲染完成后调用。
  • 设置 logo 后会将图片转为 Base64 并绘制在二维码中心,跨域图片需要允许浏览器读取资源。
  • downloadImage 默认文件名为 qrcode.png
  • 二维码内容建议保持简短,提升识别率。
  • 使用 Logo 时建议提高容错级别并控制 Logo 尺寸。