跳到主要内容

下拉多选

适用场景

以列表形式展示选项,用户可进行多选操作

基础能力说明

选项配置说明

支持手动配置选项列表,录入选项的值和名称

选中值属性说明

  1. 选中值属性表示组件的默认表单值,可绑定变量或表达式实现选中值的动态变更
  2. 选中值需填入对应的选项值;填入选项名称无效

常见场景实践说明

了解更多的表单组件使用场景,可查阅 表单常见场景实践指南

扩展场景说明

通过数据模型数据生成动态选项列表

  1. 创建 1 个数据模型,在其中新建一个班级名称字段

  2. 在该模型中录入几个班级的示例值

  3. 创建一个变量 class,数组类型,数据模型选择刚创建的模型

  4. 页面加载事件触发调用该数据模型的查看列表方法,查询该数据模型的列表数据,并将出参存入变量 class

  5. 点击组件选项属性右侧的数据绑定模式按钮

  6. 点击变量属性右侧的数据绑定按钮,变量属性绑定该 class 变量

  7. 标签名称和标签值属性输入数据模型中班级名称字段的字段标识,即可发现下拉选择组件的可选项加载为数据模型中的数据

属性说明

组件接收的外部传入的属性

属性名
属性标识
类型
属性分组
默认值
说明
绑定字段namestring基础属性"formSelectMultiple"提交表单时会将组件值提交保存到所配置的字段中
字段标题labelstring基础属性"下拉多选"组件标题位置的显示内容
显示标题labelVisibleboolean基础属性true显示组件的标题
提示文字placeholderstring基础属性"请选择"用于说明组件用途或注意事项的提示文字
选中值valuearray基础属性[]默认选中的选项
必填requiredboolean基础属性false启用后该组件强制必填,值不可为空
必填标识requiredFlagboolean基础属性true启用后,组件若要求必填,则会显示必填星号标记
必填校验提示requiredMsgstring基础属性"该项为必填项"启用必填,但组件值为空时的提示信息
选项rangearray基础属性[{"label":"选项名称","value":"选项值"}]供用户进行选择的选项列表
组件宽度(PC端)size"l"|"m"|"s"|"full"基础属性"full"-
选项tipBlockstring基础属性""-
布局方式layout""|"horizontal"|"vertical"高级属性""设置当前组件的标题和输入选择区域为左右布局或上下布局,如选择“自动”,则跟随父级表单容器的配置
禁用disabledboolean高级属性false是否禁用输入/选择,启用后组件强制显示为只读效果

事件说明

组件暴露的事件,可以监听组件的事件来触发一些外部的动作

事件名
事件code
事件出参 event.detail
适用情况
说明
值改变change兼容三端-
取消cancel兼容三端-