跳到主要内容

多选框组

用于在一组选项中选择多个值的场景。

一、何时使用​

多选框组适用于以下场景：

  • 选择兴趣爱好、通知方式等（可多选）
  • 同意多个条款或条件
  • 多项内容的批量操作（如卡片、多行列表等）
  • 页面过滤条件的选择

二、属性配置​

1. 数据源设置​

数据源

支持以下三种绑定方式：

  • 接口绑定
  • 数据绑定
  • 模型绑定

用于控制选项动态渲染，详见：数据绑定。

2. 数据配置​

数据字段

2.1 选项名称​

用户界面上展示给用户看的文字。

2.2 选项值​

提交或保存到后端的实际值。

2.3 数据绑定​

可绑定父组件的数据源，实现联动。

2.4 初始值​

设置默认被勾选的项。

3. 外观设置​

外观配置

3.1 排列方式​

支持两种方式：

  • 水平排列：子项沿水平方向排列

  • 垂直排列：子项沿垂直方向排列

    水平排列

3.2 形状​

多选框形状可设为：

  • 方形
  • 圆形 形状示例

3.3 选中状态颜色​

支持设置选中项的颜色，提升界面辨识度。

颜色配置

4. 状态设置​

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

三、样式​

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

四、常见使用场景​

1. 兴趣爱好选择​

兴趣爱好

2. 通知方式设定​

通知方式

3. 权限管理​

权限管理