二维码
二维码组件用于在页面中生成并展示一个二维码,常配合链接、单号等内容用于扫码跳转或信息分享。
概述
将「二维码」拖入画布后,在属性抽屉中填写二维码的地址(承载内容)并设置尺寸。组件基于组件库的二维码渲染,中心会叠加平台 logo 图标。
- 地址可以是链接(扫码跳转)或普通文本(扫码后展示内容)。
- 中心 logo 尺寸随二维码尺寸自动调整,约为二维码边长的四分之一。
- 纠错级别采用组件库默认值,
meta中未开放配置。
配置项
| 配置项 | 说明 |
|---|---|
| 尺寸 | 二维码边长(px),取值 50 ~ 1000,默认 160 |
| 地址 | 二维码承载的内容(链接或文本),必填,为空时渲染 - |
内容来源与尺寸
- 地址:二维码所编码的原始内容,取自
Address。链接类型扫码后可直达;文本类型扫码后展示文本。 - 尺寸:控制二维码边长,同时决定中心 logo 大小(
尺寸 / 4)。
使用建议
- 地址为链接时,可扫码直接跳转;地址为文本时,扫码后展示文本内容。
- 尺寸过小时可能影响扫描识别率,建议不低于 100px。
下一步
属性明细
以下内容面向技术实现与 AI 检索。组件的全部配置项均存放在节点的 meta 中,且所有 meta 值统一以字符串形式存储。
组件属性(meta)
| 属性名 | 类型 | 含义 | 取值/存储值 |
|---|---|---|---|
Size | string(number) | 二维码边长(px) | 50 ~ 1000,默认 160 |
Address | string | 二维码承载内容,必填 | 链接或文本,为空时渲染 - |
存储示例
以下为一个完整的 WidgetItem 节点,其中 uid 为该组件在侧边栏中的固定 GUID:
{
"id": "3c9a1d5e-6f24-4b87-8d10-5e2f3a4b6c7d",
"uid": "0b370398-b08d-4e34-b91c-ffda92f4dbb3",
"dragType": "Widget",
"originalType": "Widget",
"widgetType": "QRCode",
"widgetTypeName": "二维码",
"meta": {
"Size": "160",
"Address": "https://demo.chameleon.cn"
},
"children": []
}