跳到主要内容

多选框组

多个复选框的组合。

何时使用​

  • 在多个选项中选择多个状态
  • 与可多选的 下拉框 区别在于 复选框组 所有选项可见
  • 与 单选框组 的区别在于 复选框组 可多选
  • 选项不宜过多

一、属性​

1. 数据源​

数据源设置

多选框组的数据源有接口绑定和模型绑定两种方式，详见 数据绑定。

2. 数据​

数据设置

2.1 选项名称：选项在页面上的显示内容

2.2 选项值：选项选中后的 value 绑定值

2.3 数据绑定：绑定数据源下的属性，详见 数据绑定。

2.4 初始值：多选框组默认选中的值，可以设置多个

初始值示例1
初始值示例2

3. 外观​

3.1 排列方式​

选项排列样式可更改为水平排列或者垂直排列

排列方式设置

  • 水平排列：默认选择，横向水平排列
  • 垂直排列：纵向垂直排列

两种排列方式的效果差别：

排列效果示例

4. 状态​

  • 禁用：设置为不可选中的状态

    禁用状态示例

  • 隐藏：设置为隐藏的状态

    隐藏状态示例

二、样式​

无特殊样式，详见 通用样式。

三、常见使用场景​

  1. 普通使用，如多选用过的手机品牌

多选手机品牌示例