枢搭云帮助中心

效果与作用

开关用于表达开启或关闭、是或否、启用或停用这类二选一状态。运行态展示为可切换的开关控件，保存值通常对应 true 或 false。它比单选框更适合简单布尔状态，成员点击一次即可改变状态。

配置项

属性面板可以设置「标签」「字段说明」「默认值」「隐藏字段」「隐藏标签」。默认值支持默认关闭和默认打开，适合新建数据时预置常见状态。

「打开时描述」和「关闭时描述」用于配置开关两种状态的显示文案，例如“是/否”“启用/停用”“通过/不通过”。「描述显示位置」支持外部和内部：外部文案显示在开关旁边，更清晰；内部文案显示在开关内部，更紧凑。

应用场景

开关常用于是否启用、是否加急、是否合格、是否需要回访、是否公开、是否完成等字段。需要在列表中快速识别二值状态，或在详情中快速切换某个简单状态时，可以使用开关。

注意事项

开关只适合两个互斥状态，不适合表达待处理、处理中、已完成、已取消这类多状态流程，这种情况应使用下拉单选或单选框组。开关组件没有单独的必填配置，因为它始终有打开或关闭的状态；如果业务需要成员主动确认，应使用单选框组并开启必填。配置文案时要避免“打开”和“关闭”含义不清，例如用“是/否”时要让字段标签本身构成明确问题。