开关字段用于保存一个真或假的值。运行时用户可以切换开启或关闭状态。
当字段表示二元状态时,可以使用开关字段。例如已完成、已启用、已确认、已复核、已接受。
基础配置
| 配置项 | 说明 |
|---|
| 名称 | 展示给用户的字段标签,必填;名称应清楚表达这个二元状态 |
| API 名称 | 数据接口、脚本、公式、导入和集成使用的稳定技术名称,必填 |
| 必填 | 保存记录前该字段必须有值 |
| 只读 | 展示状态,但不允许用户修改 |
| 停用 | 字段不参与常规使用 |
| 隐藏 | 字段会保存状态,但不在常规表单页面展示 |
开关字段配置
| 配置项 | 说明 |
|---|
| 开启文案 | 开关为开启状态时显示的文本 |
| 关闭文案 | 开关为关闭状态时显示的文本 |
| 必须为开启 | 要求开关必须开启后才能保存记录 |
| 必须开启提示 | 开关必须开启但当前未开启时显示的自定义提示 |
| 校验时机 | 控制什么时候执行校验:值变更时、失焦时或提交记录时 |
| 颜色 | 设置字段展示颜色 |
| 帮助文案 | 展示在字段附近的辅助说明;可用于解释开启开关代表什么 |
常见示例
| 场景 | 开启文案 | 关闭文案 |
|---|
| 任务完成 | 已完成 | 未完成 |
| 复核状态 | 已复核 | 未复核 |
| 协议确认 | 已接受 | 未接受 |
| 功能状态 | 已启用 | 已停用 |
配置建议
| 建议 | 说明 |
|---|
| 字段名表达正向状态 | 例如已完成、已确认,能让开启状态更明确 |
| 确认场景使用必须为开启 | 当用户必须明确接受或确认时,可以开启该规则 |
| 文案保持简短 | 开关旁的文案越短越容易阅读 |