跳到主要内容

开关

用于在开启和关闭两种状态间切换，适用于简洁明确的布尔类选项。

一、何时使用​

  • 功能启用 / 禁用，例如推送通知、权限控制。
  • 页面中需要快速切换布尔状态的选项。
  • 显示/隐藏子内容、选项配置。
  • 用户期望“切换后立即生效”的操作。

二、属性配置​

1. 数据设置​

绑定数据源控制开关值的读写，支持手动赋值和视图参数。

数据设置

1.1 数据绑定​

开关的值可绑定父级组件或表单的数据字段，详见：数据绑定

1.2 初始值​

可设置开关的默认开启或关闭状态：

  • 手动赋值
  • 视图参数赋值

2. 外观设置​

支持颜色、尺寸等外观样式设置。

外观设置

2.1 选中颜色​

设置开关处于开启状态时的颜色：

选中颜色示意

2.2 未选中颜色​

设置开关处于关闭状态时的颜色：

未选中颜色示意

2.3 尺寸设置​

支持设置开关的大小（如小/中/大）：

尺寸设置

3. 状态设置​

3.1 载入状态​

开启后，切换开关时显示加载状态，适合用于请求中的反馈场景：

载入状态示意

3.2 其他状态​

无其他特殊状态，详见：通用状态。

三、样式​

无特殊样式配置，详见：通用样式。

四、常见使用场景​

1. 商品上架 / 下架，权限启用 / 禁用​

可快速切换状态值：

商品上架示例

2. 动态控制子内容显示​

用于表单或页面中控制某些子配置项是否显示，提升界面简洁度：

控制子内容示例