Back to Nocobase

扫码录入

docs/docs/cn/interface-builder/fields/field-settings/scan-input.md

2.1.21.4 KB
Original Source

扫码录入

介绍

扫码录入用于可编辑表单中的文本类字段。开启后,字段输入框右侧会出现扫码按钮,用户可以扫描二维码、条形码,或者从相册选择图片识别内容,并将识别结果写入当前字段。

通常来说,它适合录入设备编号、资产编码、订单号、快递单号等不适合手动输入的内容。

支持的字段

扫码录入主要用于文本类字段,比如:

  • 单行文本
  • 手机号码
  • 电子邮箱
  • URL
  • UUID
  • Nano ID

如果字段处于只读、阅读模式,或字段本身不支持可编辑输入,则不会显示扫码录入配置。

配置方式

在表单区块中选中对应字段,打开字段配置菜单,找到「扫码录入设置」。

其中:

  • 「启用扫码录入」:开启后,输入框右侧会显示扫码按钮
  • 「禁止手动输入」:开启后,用户只能通过扫码写入字段值,不能手动编辑输入框

关闭「启用扫码录入」后,「禁止手动输入」也会一起失效。

使用说明

用户点击字段右侧的扫码按钮后,可以使用摄像头识别二维码或条形码。浏览器扫码需要允许页面访问摄像头;在支持原生扫码能力的移动端环境中,会优先调用移动端的扫码能力。

如果不方便直接使用摄像头,也可以点击「相册」选择图片进行识别。