进阶 docs.budibase.com 2026-11-12 08:33:37 · 19 阅读

第26章 Barcode/QR 扫码器

Barcode/QR 扫码器 添加 Barcode/QR 字段,让用户可以直接扫描条码或二维码填入表单! 添加 Barcode/Scanner 字段 该字段位于组件列表的 Form(表单)分类下。
  1. 扫描
    表单已打开且 Barcode/QR 组件已放置后,只需点击“Scan code”按钮即可调起摄像头弹窗。
  2. 弹窗会显示摄像头正在“Searching for code...”(查找代码)。
  3. 将有效的 QR/Barcode 对准摄像头。成功扫描后,屏幕上会显示绿色指示器及代码内容。
  4. 关闭扫描弹窗后,QR/Barcode 的内容将自动填入对应字段。
  5. 👍代码扫描支持
    完整的支持条形码列表见此处:https://github.com/mebjas/html5-qrcode#supported-code-formats
  6. 手动输入
    用户也可以点击“Enter manually”(手动输入),例如当代码类型不支持或无法扫描时。点击后,摄像头弹窗将关闭并显示一个文本输入框,允许手动输入代码。
  7. 要启用手动输入,请确保在 Barcode/QR 组件设置中已勾选“Allow manual entry”(允许手动输入)选项。
  8. 权限
    Barcode/QR 扫描器需要访问设备的摄像头才能进行扫描。
  9. 系统可能会提示授予 Budibase 摄像头访问权限,或者你需要在浏览器和/或操作系统中手动启用该权限。
  10. 如果摄像头不可用,将显示以下消息。
  11. 设置面板
    以下是该字段可用的配置选项。
设置描述
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 个月前 这个页面对你有帮助吗?

评论 (0)