Mashup Builder > 小组件 > 标准小组件 > 列表穿梭小组件 (可应用主题)
列表穿梭小组件 (可应用主题)
您可以使用“列表穿梭”小组件从现有列表中选择项 (即源)，然后将其放置到新列表中 (即目标)。在目标列表中，对选定项进行排序，并从源列表中移除不需要的项。
* 
“列表穿梭”小组件可在平台中用作标准小组件，也可用作 web 组件 (可从 SDK 导入)。
数据格式
可使用信息表中的数据配置 ListShuttle 小组件项，信息表的格式为以下结构：
字段定义
显示字段
IDField
说明
表示运行时列表交换项的标签。
表示列表交换项的实际 ID。该值也存储在 SelectedItems 属性中。
基本类型
STRING 或 NUMBER
STRING 或 NUMBER
定义列表项
要定义列表项，请绑定使用所需数据格式格式化的信息表。
1. 在“数据”面板上，添加一个用于定义小组件列表项的数据服务。可使用之前介绍的信息表格式来定义项。
2. 将数据服务的 All Data 属性绑定至列表交换小组件的 Data 属性。
3. 在“属性”面板上，为以下属性选择信息表字段：
◦ DisplayField - 项标签的数据。
◦ IDField - 各个项的 ID。
4. 单击“保存”，然后单击“查看混搭”。
在运行时，列表项会显示在小组件内。
验证选定项的数目
可使用 NumberOfSelectedItems 属性跟踪和验证运行时列表中选定项的数目。例如，可将属性绑定至验证器函数。如果选定项的数目与特定值不匹配，还可显示错误消息并限制用户保存页面。
以下示例显示了属性和验证器函数之间的绑定。SelectedItemsChanged 事件用于通过函数验证 NumberOfSelectedItems 属性。在运行时，函数会检查选定项的数目，并在验证失败后显示错误消息。
小组件属性：
属性名称
说明
基本类型
默认值
是否可绑定? (Y/N)
是否可本地化? (Y/N)
TabSequence
设置按 TAB 键时突出显示小组件的顺序。
NUMBER
不适用
N
N
DisplayField
表示数据值的信息表字段。
INFOTABLE
不适用
N
N
ListFormat
将状态格式应用于列表项。
呈现器和状态格式
不适用
N
N
Disabled
禁用混搭中的小组件。小组件随即显示，但不可用。
BOOLEAN
False
Y
N
CustomClass
定义小组件顶层 div 元素的 CSS 类名称。输入多个类时，请以空格分隔每个类。
STRING
不适用
Y
N
SelectedItems
列表中选定项的信息表数据源。
INFOTABLE
不适用
Y
N
SingleSelect
设置单项选择或多项选择。
BOOLEAN
False
Y
N
HideFilter
显示或隐藏源列表中的筛选器。
BOOLEAN
False
Y
N
IDField
包含列表项 ID 的信息表字段。当各个项共享相同的显示名称时，必须指定 ID 字段。
字段名称
不适用
不适用
N
Data
小组件的数据源。
INFOTABLE
不适用
Y
N
ListShuttleLabel
“列表穿梭”小组件标签的显示文本。
STRING
列表穿梭
Y
Y
ListShuttleLabelAlignment
在小组件中将标签“左”、“右”或“居中”对齐。
STRING
左
Y
N
ListShuttleLabelType
将标签类型设置为“标题”、“子标题”、“标签”或“正文”。
STRING
子标题
Y
N
NumberOfSelectedItems
返回 List Shuttle 中选定项的数目。
* 
也可在禁用小组件后设置选定项的数目。
NUMBER
不适用
Y
N
SourceListLabel
源列表标签的显示文本。
STRING
源
Y
Y
SourceListLabelAlignment
在源列表中将标签“左”、“右”或“居中”对齐。
STRING
左
Y
N
SourceListLabelType
将标签类型设置为“标题”、“子标题”、“标签”或“正文”。
STRING
Label
Y
N
TargetListLabel
目标列表标签的显示文本。
STRING
目标
Y
Y
TargetListLabelAlignment
在目标列表中将标签“左”、“右”或“居中”对齐。
STRING
左
Y
N
TargetListLabelType
将标签类型设置为“标题”、“子标题”、“标签”或“正文”。
STRING
Label
Y
N
ResetToDefaultValue
将列表重置为其默认值。
不适用
不适用
Y
N
验证属性
除常用验证属性外，还可使用 TargetListMaxItems 和 TargetListMinItems 属性来限制小组件中的选定项数目。当选定项的数目超出既定范围时，将显示一条失败消息。
属性名称
说明
基本类型
默认值
是否可绑定? (Y/N)
是否可本地化? (Y/N)
ValidationState
用于设置验证状态的可绑定属性。可将此属性设置为未定义、未验证、有效或无效。
STRING
Undefined
In
N
ValidationOutput
可绑定属性，用于检索小组件验证的输出。返回值包括未定义、未验证、有效或无效。
STRING
不适用
Out
N
ValueRequired
需为目标列表添加项。
BOOLEAN
False
In
N
RequiredMessage
ValueRequired 设置为 true 且未向目标列表中添加项时显示的消息。
STRING
“选择内容为必需”
In
Y
Validate
更改小组件值时触发的事件。将此事件绑定至服务或函数以应用验证表达式。
EVENT
不适用
Out
N
ShowValidationState
一种可绑定服务，用于在运行时用户与小组件进行交互前显示验证状态。默认情况下，验证状态仅在用户交互后显示。
服务
不适用
In
N
ShowValidationSuccess
当验证成功时显示成功消息。
BOOLEAN
False
In
N
ValidationSuccessIcon
针对验证成功时的状况消息，选择在其中显示的 SVG 图标。
IMAGELINK
success
不适用
N
ShowValidationFailure
当验证失败时显示失败消息。
BOOLEAN
False
In
N
ValidationFailureIcon
针对验证失败时的状况消息，选择在其中显示的 SVG 图标。
IMAGELINK
error
不适用
N
ShowValidationCritera
编辑列表时显示有关所需输入的提示消息。
BOOLEAN
False
In
N
ValidationCriteriaIcon
针对关于验证条件的提示消息，选择在其中显示的 SVG 图标。
IMAGELINK
Info
不适用
N
SuccessMessage
验证成功时显示的消息。
STRING
不适用
In
N
SuccessMessageDetails
二级消息，显示关于验证成功消息的更多信息。
STRING
不适用
In
Y
CriteriaMessage
当验证失败时所显示的消息。
STRING
不适用
Y
Y
CriteriaMessageDetails
二级消息，显示关于验证失败消息的更多信息。
STRING
不适用
In
Y
TargetListMinItems
设置目标列表中的最小数目。
NUMBER
不适用
In
N
TargetListMinItemsFailureMessage
目标列表中的选定项数目小于 TargetListMinItems 值时显示的消息。
STRING
${value} Is the minimum number of items
In
Y
TargetListMaxItems
设置目标列表中的最大项数。
NUMBER
不适用
In
N
TargetListMaxItemsFailureMessage
目标列表中的选定项数目大于 TargetListMaxItems 值时显示的消息。
STRING
${value} Is the maximum number of items
In
Y
这对您有帮助吗?