跳到主要内容

开关

使用开关切换两种状态之间。

何时使用​

  • 表示开/关状态或两种状态之间的切换
  • 区别于 Checkbox：Switch 切换立即生效，而 Checkbox 通常用于状态标记，需配合提交按钮使用

一、属性​

引用标识，详见 通用属性。

1. 数据​

  • 数据绑定： 详见 数据绑定
  • 初始值： 设置开关初始状态，支持三种状态：开启、关闭、无（默认）；也可绑定页面参数设置

初始值设置

2. 功能​

  • 开启 / 关闭内容： 开关上可显示对应状态的文字信息

功能配置面板

效果示例如下：

显示效果

3. 外观​

  • 尺寸： 支持调整开关大小，常用为默认尺寸和小尺寸

外观面板

尺寸效果对比

4. 状态属性​

详见 通用属性

二、样式​

详见 通用属性

三、常见使用场景​

1. 表示状态​

用于表示某项是否启用、激活等状态。

表示状态示例

2. 与其他组件嵌套使用​

2.1 表单中显示状态

开关作为表单项用于用户输入状态。

表单中使用

2.2 表格中使用，并支持操作修改状态

可嵌入表格单元格中，直接修改某行数据状态。

表格中使用