简介
需要在多个可选项中进行多选时,穿梭选择框以直观的方式在两栏中移动元素,完成选择行为。
配置项
分类 | 配置 | 示例 | 说明 |
内容 | 数据源 | 穿梭框的数据源,其中的数据将会被渲染到左边一栏中, | |
右侧框数据 Key 集合 | 显示在右侧框数据的 key 集合。 | ||
选中数据 Key 集合 | 选中数据的 key 集合。 | ||
标题 | 顶部多选框的标题,分为左标题和右标题。 | ||
操作文案 | 操作文案,分为左移和右移。 | ||
交互 | 隐藏 | 控制穿梭框的默认展示状态,为 | |
禁用 | 是否禁用穿梭框。 | ||
展示搜索框 | 开启穿梭框的搜索能力,根据用户输入的内容过滤数据。 | ||
展示全选勾选框 | 可以勾选框内所有元素。 | ||
单向模式 | 只允许从左侧框移动到右侧框。 | ||
样式 | 外边距 | 详情参见通用属性。 |
属性与方法
名称 | 类型 | 示例 | 说明 |
targetKeys | array |
| 当前穿梭框组件的右侧框内的 key 集合 |
selectedKeys | array |
| 当前穿梭框组件的选中项的 key 集合 |
dataSource | array |
| 当前穿梭框组件的数据源 |
disabled | boolean |
| 是否禁用当前穿梭框组件 |
oneWay | boolean |
| 当前穿梭框组件是否为单向模式 |
hidden | boolean |
| 当前组件是否隐藏 |
setTargetKeys | func |
| 设置穿梭框的右侧框内数据为 |
clearTargetKeys | func |
| 清除穿梭框的右侧框内数据 |
setDisabled | func |
| 禁用穿梭框 |
clearDisabled | func |
| 清除穿梭框的禁用状态 |
setHidden | func |
| 设置穿梭框是否隐藏,参数为 |
clearHidden | func |
| 清除穿梭框的隐藏状态 |
事件回调
配置 | 说明 |
当选项在两栏之间转移时将触发的事件 | |
选中项发生改变时将触发的事件 |
场景示例
任务列表场景
使用穿梭框直观的查看任务进展