单选下拉

单选下拉字段用于从配置好的选项列表中选择一个值。运行时用户通过下拉框选择，字段保存所选选项的值。

当选项固定，或由表单设计者维护时，可以使用单选下拉。例如状态、优先级、分类、来源、等级。

基础配置

配置项	说明
名称	展示给用户的字段标签，必填；名称应清楚表达所选值的业务含义
API 名称	数据接口、脚本、公式、导入和集成使用的稳定技术名称，必填
必填	保存记录前必须选择一个选项
只读	展示已选择的选项，但不允许用户修改
停用	字段不参与常规使用
隐藏	字段会保存所选值，但不在常规表单页面展示

单选下拉字段配置

配置项	说明
选项	定义可选择的选项列表；每个选项包含展示标签和保存值
占位提示	用户选择选项前显示在字段中的提示文案
显示搜索	允许用户在下拉框中搜索选项；选项较多时建议开启
校验时机	控制什么时候执行选项校验：值变更时、失焦时或提交记录时
输入状态	给字段添加警告或错误等视觉状态
无效选项提示	所选选项无效或不再可用时显示的自定义提示
颜色	设置字段展示颜色
帮助文案	展示在字段附近的辅助说明；可用于说明用户应该如何选择

选项

部分	说明
标签	展示给用户看的选项文本
值	记录、数据接口、脚本、导入和集成使用的保存值；创建数据后应保持稳定
添加选项	向列表中新增一个选项行
批量插入	一次新增多个选项；每行一个选项；需要明确保存值时可使用 标签:值
批量复制	复制当前选项列表，方便复用

选项示例

标签	值	用途
新建	new	初始状态
处理中	in_progress	工作已开始
已完成	completed	工作已结束
高	high	高优先级

配置建议

建议	说明
保持值稳定	标签可以按展示需要调整，但创建数据后应避免修改保存值
长列表开启搜索	选项较多时，搜索能减少用户查找成本
写清无效提示	当旧选项被删除或不再可用时，告诉用户应该如何处理