进阶 docs.budibase.com 2026-11-12 08:33:37 · 19 阅读
第26章 Barcode/QR 扫码器
Barcode/QR 扫码器
添加 Barcode/QR 字段,让用户可以直接扫描条码或二维码填入表单!
添加 Barcode/Scanner 字段
该字段位于组件列表的 Form(表单)分类下。
为此字段配置验证规则。 Schema 验证规则:Schema 中没有内置的验证规则 自定义验证规则: 必须匹配正则表达式 绑定:https://.+ 错误信息:必须是以 https:// 开头的安全 URL。 此功能也可以与 Auto confirm 设置安全地配合使用。如果条形码在扫描时通过验证,弹窗会自动关闭;反之,如果扫描到的条形码不是有效的 URL(本例中的预期格式),弹窗会保持打开,直到用户扫到符合要求的条形码或手动取消。 调优建议: Auto confirm 会在扫描成功且验证通过后立即关闭扫描弹窗。 Manual entry 提供了一个备用的文本输入框,用于无法扫描的场景。 Play sound on scan、Sound pitch 和 Sound frequency (Hz) 可以为扫描提供声音反馈。 验证规则在确认/关闭行为之前执行,因此无效的扫描会留在弹窗中,直到用户修正或取消。 更新于 6 个月前 这个页面对你有帮助吗?
- 扫描
表单已打开且 Barcode/QR 组件已放置后,只需点击“Scan code”按钮即可调起摄像头弹窗。 - 弹窗会显示摄像头正在“Searching for code...”(查找代码)。
- 将有效的 QR/Barcode 对准摄像头。成功扫描后,屏幕上会显示绿色指示器及代码内容。
- 关闭扫描弹窗后,QR/Barcode 的内容将自动填入对应字段。
- 👍代码扫描支持
完整的支持条形码列表见此处:https://github.com/mebjas/html5-qrcode#supported-code-formats - 手动输入
用户也可以点击“Enter manually”(手动输入),例如当代码类型不支持或无法扫描时。点击后,摄像头弹窗将关闭并显示一个文本输入框,允许手动输入代码。 - 要启用手动输入,请确保在 Barcode/QR 组件设置中已勾选“Allow manual entry”(允许手动输入)选项。
- 权限
Barcode/QR 扫描器需要访问设备的摄像头才能进行扫描。 - 系统可能会提示授予 Budibase 摄像头访问权限,或者你需要在浏览器和/或操作系统中手动启用该权限。
- 如果摄像头不可用,将显示以下消息。
- 设置面板
以下是该字段可用的配置选项。
| 设置 | 描述 |
|---|---|
| Name | 构建器组件的名称 |
| Label | 显示在 Barcode/QR 组件旁边、用于描述该字段的文本 |
| Field | 来自父级 Form 元素的连接字段,或通过输入字段名称自定义 |
| Manual entry | 勾选后,用户可以切换至手动输入模式,并通过文本输入框输入代码 |
| Button text | 显示在 Barcode/QR 启动按钮上的文本,默认为“Scan code” |
| Default value | 若提供默认值,每次打开表单时该字段将预填充此值 |
| Disabled | 勾选后,字段被禁用;用户无法更改其值 |
| Play sound on scan | 扫描时播放单音。还可选择音调(Sound pitch) |
| Preferred camera | 决定使用应用设备的前置或后置摄像头进行扫描 |
| Auto confirm | 扫描成功后,扫描弹窗将自动关闭 |
验证
扫描条形码时,底层数据类型可能多种多样,如文本、数字、URL 等。有时你希望添加验证规则,以确保仅特定类型的条形码能被成功扫描。
例如,若你希望确保仅能扫描并保存 Web URL,可以添加一条正则表达式规则:
Validation Rules
为此字段配置验证规则。 Schema 验证规则:Schema 中没有内置的验证规则 自定义验证规则: 必须匹配正则表达式 绑定:https://.+ 错误信息:必须是以 https:// 开头的安全 URL。 此功能也可以与 Auto confirm 设置安全地配合使用。如果条形码在扫描时通过验证,弹窗会自动关闭;反之,如果扫描到的条形码不是有效的 URL(本例中的预期格式),弹窗会保持打开,直到用户扫到符合要求的条形码或手动取消。 调优建议: Auto confirm 会在扫描成功且验证通过后立即关闭扫描弹窗。 Manual entry 提供了一个备用的文本输入框,用于无法扫描的场景。 Play sound on scan、Sound pitch 和 Sound frequency (Hz) 可以为扫描提供声音反馈。 验证规则在确认/关闭行为之前执行,因此无效的扫描会留在弹窗中,直到用户修正或取消。 更新于 6 个月前 这个页面对你有帮助吗?