穿梭框

简介

需要在多个可选项中进行多选时,穿梭选择框以直观的方式在两栏中移动元素,完成选择行为。

image

配置项

分类

配置

示例

说明

内容

数据源

image

穿梭框的数据源,其中的数据将会被渲染到左边一栏中,右侧框数据 key 集合 中指定的除外。

右侧框数据 Key 集合

image

显示在右侧框数据的 key 集合。

选中数据 Key 集合

image

选中数据的 key 集合。

标题

image

顶部多选框的标题,分为左标题和右标题。

操作文案

image

操作文案,分为左移和右移。

交互

隐藏

image

控制穿梭框的默认展示状态,为true 时将隐藏组件。详情参见通用属性

禁用

image

是否禁用穿梭框。

展示搜索框

image

开启穿梭框的搜索能力,根据用户输入的内容过滤数据。

展示全选勾选框

image

可以勾选框内所有元素。

单向模式

image

只允许从左侧框移动到右侧框。

样式

外边距

image

详情参见通用属性

属性与方法

名称

类型

示例

说明

targetKeys

array

transfer1.targetKeys

当前穿梭框组件的右侧框内的 key 集合

selectedKeys

array

transfer1.selectedKeys

当前穿梭框组件的选中项的 key 集合

dataSource

array

transfer1.disabled

当前穿梭框组件的数据源

disabled

boolean

transfer1.disabled

是否禁用当前穿梭框组件

oneWay

boolean

transfer1.oneWay

当前穿梭框组件是否为单向模式

hidden

boolean

transfer1.hidden

当前组件是否隐藏

setTargetKeys

func

transfer1.setTargetKeys(['option1'])

设置穿梭框的右侧框内数据为option1

clearTargetKeys

func

transfer1.clearTargetKeys()

清除穿梭框的右侧框内数据

setDisabled

func

transfer1.setDisabled(true)

禁用穿梭框

clearDisabled

func

transfer1.clearDisabled()

清除穿梭框的禁用状态

setHidden

func

transfer1.setHidden(false)

设置穿梭框是否隐藏,参数为truefalse

clearHidden

func

transfer1.clearHidden()

清除穿梭框的隐藏状态

事件回调

配置

说明

image

选项在两栏之间转移时将触发的事件

image

选中项发生改变时将触发的事件

场景示例

  • 任务列表场景
    • 使用穿梭框直观的查看任务进展

      image