多选

在线编辑

允许用户从项列表中一次选择多个项。

数据绑定

在“配置”属性中设置或修改该视图的数据绑定。 此视图可与 ANY (List) 类型绑定在一起。

配置属性

在“配置”下，设置或修改视图的外观和行为属性。

屏幕大小
在属性名称旁边具有 "屏幕大小" 图标 "屏幕大小" 图标 的配置属性对于每个屏幕大小可以具有不同的值。 如果您未设置值，那么屏幕大小会继承下一个更大的屏幕大小值来作为其缺省值。
主题定义
主题定义指定视图的颜色和样式，并确定视图的外观。 您可以在主题编辑器中预览视图的外观。 请参阅 主题。
下表中显示了“多选”视图的外观配置属性：
表 1. “多选”的外观配置属性
外观配置属性 描述 数据类型
宽度"屏幕大小" 图标 这是视图的宽度。 您可以指定宽度，以 px（像素）、%（百分比）或 em 为单位。 例如，50px、20% 或 0.4em。 如果未指定单位类型，那么将使用 px。 String
大小 "屏幕大小" 图标 该视图中文本的字号、标签文本的字号以及文本四周的内间距量。 例如，要使智能手机上的文本和标签更易读，可以将此配置选项设置为 Large 以补偿小屏幕大小。 String
标签放置 "屏幕大小" 图标 该视图的标签放置位置。 String
标签宽度 大屏幕图标 这是标签的宽度。 您可以指定宽度，以 px（像素）、%（百分比）或 em 为单位。 例如，50px、20% 或 0.4em。 如果未指定单位类型，那么将使用 px。 String
显示验证标记 当视图无效时显示验证图标和边框。 Boolean
下表中显示了“多选”视图的行为配置属性：
表 2. “多选”的行为配置属性
行为配置属性 描述 数据类型
跳进索引 跳进顺序索引。 跳进索引从 1 开始，可稀疏地进行设置。 例如，您可以使用 1、5、10。 Integer
下表中显示了“多选”视图的项配置属性：
表 3. “多选”的项配置属性
项配置属性 描述 数据类型
项查找方式 用于填充用户可以从中进行选择的项的列表的方法。 注：请确保选择正确的选项，否则将不会正确填充列表。
开始清空
使用以下命令以编程方式填充选择列表:appendItem(value, displayText)方法。
来自服务的项
通过您在列表项服务选项中指定的服务来填充选择列表。
来自静态列表的项
通过您在静态列表选项中输入的属性来填充选择列表。
来自配置选项的项
通过您在项输入数据选项中指定的业务对象列表来填充选择列表。
 String
列表项服务 此服务用于填充显示在选择列表中的项的列表。 当“项查找方式”为来自服务的项时，会使用此服务。 该服务是具有相应的 Ajax 访问权限的服务流，基于服务输入数据业务对象提供的数据来提供选择列表。 您可以将此选项用作将视图绑定到列表对象的替代方法。
提示: 列表项服务使用两个变量: 类型为 string named data的输入变量和类型为 list named results的输出变量，后者将结果作为绑定到视图的数据输出。 如果输出变量名称不是列表项服务的 results，那么将无可用值。
 服务流
服务输入数据 业务对象，提供向用于填充选择列表的服务流传递的输入数据。 当项查找方式为来自服务的项时，会使用此服务。 ANY
忽略输入数据更改 在服务输入数据更改时禁用自动服务调用。 仅当将项查找方式设置为来自服务的项时，才会使用此选项。 Boolean
项输入数据 用于填充选择列表的业务对象列表。 仅当“项查找方式”为来自配置选项的项时，才会使用此属性。 ANY[]
项选择数据 在显示属性字段中，设置要显示在选择列表中的业务对象属性。 如果没有为数据映射属性指定任何值，那么缺省值为 name（对于值属性）和 value（对于显示属性）。 
SelectDataMapping
输出业务数据 当视图绑定到复杂类型时，用户选择的属性将传递至显示属性中指定的属性以及绑定到视图的属性。 
SelectDataMapping
静态列表 用于填充选择列表的静态项列表。 仅针对静态列表使用此选项。 请勿对此选项指定变量。 对于变量列表，请使用来自配置选项的项查找方式。 NameValuePair[]

示例：来自静态列表的项

您具有标签为 Grocery list 的 "多选" 视图，并且选择的 项查找方式 为 来自静态列表的项。 在静态列表中，您定义了以下名称/值对。
表 4. 静态列表
名称 值
1 Milk
2 Bread
3 Bananas
4 Rice
您将看到以下结果:

示例：使用业务对象填充项

此示例使用 Customer 业务对象来填充选择列表中的名字列表。 当用户选择多个姓名时，表中会显示对应的记录。

Customer 业务对象具有以下结构：
  • 字符串类型的参数。
  • 字符串类型的参数。
  • 字符串类型的参数。
Customer 业务对象具有以下缺省值：
var autoObject = [];
autoObject[0] = {};
autoObject[0].ID = "000";
autoObject[0].firstName = "Pierre";
autoObject[0].lastName = "de Fermat";
autoObject[1] = {};
autoObject[1].ID = "001";
autoObject[1].firstName = "Isaac";
autoObject[1].lastName = "Newton";
autoObject[2] = {};
autoObject[2].ID = "002";
autoObject[2].firstName = "John";
autoObject[2].lastName = "Venn";
autoObject

客户机端人员服务具有类型为 outputList 的专用变量。 "输出" 类型有两个字符串参数，并且。 “多选”视图会绑定到 outputList，其中包含该视图的数据输出。

页面包含具有以下属性的“多选”视图：
  • 在 常规下，将 绑定 设置为 outputList。
  • 在 配置 > 项下，将 项查找方式 设置为。
  • 在 配置 > 项下，将 项输入数据 设置为。
  • 在 配置 > 项 > 项选择数据下:
    • 对于 值属性，请指定。
    • 对于 显示属性，请指定。
  • 在 配置 > 项 > 输出业务数据下:
    • 对于 值属性，请指定。
    • 对于 显示属性，请指定。
“表”视图具有以下属性：
  • 两列标题和
  • 在 常规下， 标签 设置为。
  • 在 常规下， 绑定 设置为。
提示: 要快速创建表，请将 outputList 变量拖到页面上。
这是运行时的结果：
这是您进行多项选择后的结果:
您选择的值将显示在 Value2 列中，这是在 输出业务数据下的 显示属性 选项中指定的属性。 通过值传递该属性。 如果输入为 显示属性，那么您选择的名称将显示在 Value1 列中。

事件

在“事件”属性中设置或修改该视图的事件处理程序。 可以将事件设置为以编程方式或在用户与该视图交互时触发。 有关如何定义和编码事件的信息，请参阅 用户定义的事件。

“多选”视图具有以下类型的事件处理程序：

  • : 在装入页面时激活。 例如：

  • : 在绑定数据更改时激活。 例如：

  • : 在服务流返回项列表时激活。 仅当项查找方式设置为来自服务的项时激活。

  • : 在服务流返回服务错误时激活。 仅当项查找方式设置为来自服务的项时激活

根据特定事件，您可以使用 JavaScript 逻辑来修改视图的效果。 可在 用户定义的事件主题中找到有关将事件与视图配合使用的更多信息。

方法

有关多选的可用方法的详细信息，请参阅 多选 JavaScript API 。

其他资源

有关如何创建 Coach 或页面的信息，请参阅 构建 Coach。
有关标准属性 (常规， 配置， 定位， 可视性和 HTML 属性) 的信息，请参阅 查看属性。