集合小组件 (可应用主题)
“集合”小组件是一个响应式小组件，用于将一系列重复的混搭显示为集合内的单元格。您可以配置高级布局以及对单元格进行分组，以便用户更轻松地将集合显示在各种不同尺寸的屏幕上。要在集合单元格内显示数据，必须定义一个包含混搭单元格数据的信息表。还可以配置数据加载行为，以在加载大型数据集时优化性能。
 |
此小组件也可用作 Web Component SDK 中的 Web 组件。
|
属性
|
属性名称
|
说明
|
基本类型
|
默认值
|
可绑定
|
是否可本地化 (Y/N)
|
|---|---|---|---|---|---|
|
Data
|
“集合”小组件的信息表数据源。
|
INFOTABLE
|
Y
|
N
|
|
|
ItemLoadBehavior
|
用于控制：集合数据的加载行为。可以在用户滚动鼠标时加载和卸载数据，或一开始就加载完整数据集。
|
STRING
|
加载/卸载
|
N
|
N
|
|
Layout
|
用于指定：集合中单元格的布局类型。选项：柔性、栅格、表格。
|
STRING
|
柔性
|
Y
|
N
|
|
Mashup
|
显示集合数据所用的混搭。
|
MASHUPNAME
|
Y
|
N
|
|
|
Width
|
用于设置：小组件宽度。
|
NUMBER
|
400
|
N
|
N
|
|
Height
|
用于设置：小组件高度。
|
NUMBER
|
300
|
N
|
N
|
|
MashupHeight
|
用于设置：集合混搭的高度。
|
NUMBER
|
Y
|
N
|
|
|
MashupWidth
|
用于设置：集合混搭的宽度。
|
NUMBER
|
Y
|
N
|
|
|
MashupWidthField
|
用于指定信息表字段，以通过服务定义单元格宽度。其值改写 MashupHeight。
|
信息表列
|
N
|
N
|
|
|
MashupHeightField
|
用于指定信息表字段，以通过服务定义单元格高度。其值改写 MashupHeight。
|
信息表列
|
N
|
N
|
|
|
UIDField
|
必填。用于指定信息表字段，字段值为各个单元的具有唯一性的标识符。
|
信息表列
|
N
|
N
|
|
|
LastRowAlignment
|
用于控制：集合中最后一行内单元格的对齐方式。选项：“默认”、“均匀分布”、“相同间距”、“左对齐”、“居中”、“右对齐”、“拉伸”
|
STRING
|
默认
|
N
|
N
|
|
HorizontalAlignment
|
用于控制：在集合中的各行内，单元格的水平对齐方式。选项：“均匀分布”、“相同间距”、“左对齐”、“居中”、“右对齐”、“拉伸”
|
STRING
|
均匀分布
|
N
|
N
|
|
VerticalAlignment
|
用于控制：在集合中的各行内，单元格的水平对齐方式。选项：“顶部对齐”、“居中”、“拉伸”、“底部对齐”
|
STRING
|
居中
|
N
|
N
|
|
UniformRowHeight
|
使用相同高度显示行。
|
BOOLEAN
|
False
|
N
|
N
|
|
RowGap
|
用于设置：集合中行的间距。
|
NUMBER
|
44
|
N
|
N
|
|
ColumnGap
|
用于设置：集合中列的间距。
|
NUMBER
|
22
|
N
|
N
|
|
TopPadding
|
用于设置：集合顶部边框与第一个单元之间的填充。
|
NUMBER
|
22
|
N
|
N
|
|
BottomPadding
|
用于设置：集合底部边框与最后一个单元格之间的填充。
|
NUMBER
|
22
|
N
|
N
|
|
MashupNameField
|
用于指定信息表字段，以通过数据服务提供混搭名称。此属性将改写混搭属性。
|
信息表列
|
N
|
N
|
|
|
MashupPropertyBinding
|
已系列化的 JSON 对象，其中，将信息表字段作为键，将混搭参数作为值。例如，{\"min_temp\":\"minTemp\"}
|
JSON
|
N
|
N
|
|
|
MashupGlobalPropertyBinding
|
已系列化的 JSON 对象，其中，将全局参数名称作为键，将数据类型作为值。这些属性可能会绑定到集合小组件，且会发送到各个单元格混搭。{\"minTemp\":\"STRING\"}
|
JSON
|
N
|
N
|
|
|
SelectedCellMashupField
|
用于指定信息表字段，以设置集合中每个单元格的选定状态。
|
信息表列
|
N
|
N
|
|
|
UseMashupDimensions
|
使单元大小与混搭尺寸相匹配。
|
BOOLEAN
|
False
|
N
|
N
|
|
SelectionMode
|
用于控制：用户在运行时可选择的单元格数量。选项：“无”、“单个”、“多个”
|
STRING
|
无
|
N
|
N
|
|
HasSelectedCells
|
当小组件中有选定的单元格时，返回 True。
|
BOOLEAN
|
False
|
Y
|
N
|
|
SelectedCellsCount
|
返回集合中选定单元格的数目。
|
NUMBER
|
0
|
N
|
N
|
|
ScrollToSelectedCell
|
自动滚动到选定的单元格。
|
BOOLEAN
|
False
|
N
|
N
|
|
AutoSelectFirstRow
|
用于控制：当数据加载到集合时，自动选中第一行。
|
BOOLEAN
|
False
|
N
|
N
|
|
SelectedCells
|
用于指定：通过信息表选择的集合单元格。
|
INFOTABLE
|
Y
|
N
|
|
|
SelectedCellMashup
|
用于指定：显示集合中选定单元格的替代混搭。此混搭的属性必须与默认混搭相同。
|
混搭选取器
|
Y
|
N
|
|
|
HandleSelectionUpdates
|
启用后，小组件向其数据服务发送和接收选择内容的更新。
|
BOOLEAN
|
True
|
N
|
N
|
|
CellMenu
|
用于指定：对于在触控设备上滑过单元格时所显示的单元格菜单，控制该菜单的状态定义。在没有触控界面的设备上，右击单元格可显示此菜单。
|
STATEDEFINITION
|
N
|
N
|
|
|
CellMenuIconSize
|
用于指定：单元格菜单中图标的大小。
|
NUMBER
|
20
|
N
|
N
|
|
SectionField
|
用于指定：具有标识符值的信息表字段，可通过这些标识符对分区内的单元格进行分组。
|
INFOTABLE
|
N
|
N
|
|
|
SectionInsetLeft
|
用于设置：对单元格进行分组时，分区的左侧内凹值。
|
NUMBER
|
0
|
N
|
N
|
|
SectionInsetTop
|
用于设置：对单元格进行分组时，分区的顶部内凹值。
|
NUMBER
|
0
|
N
|
N
|
|
SectionInsetRight
|
用于设置：对单元格进行分组时，分区的右侧内凹值。
|
NUMBER
|
0
|
N
|
N
|
|
SectionInsetBottom
|
用于设置：对单元格进行分组时，分区的底部内凹值。
|
NUMBER
|
0
|
N
|
N
|
|
SortField
|
用于指定：对分区内容进行排序时所依据的信息表字段。排序在客户端执行，不会影响源信息表或绑定到数据集的其他小组件。
|
INFOTABLE
|
Y
|
N
|
|
|
SortAscending
|
启用 SortField 属性后，将按升序对分区内容进行排序。默认情况下，按降序对分区进行排序。
|
BOOLEAN
|
False
|
Y
|
N
|
|
SectionHeaders
|
用于控制：对集合中的单元格进行分组时，分区页眉的可见性。选项：“无”、“可见”、“固定”
|
STRING
|
无
|
N
|
N
|
|
HeaderMashup
|
用于指定：对集合中的单元格进行分组时，分区的页眉所用的混搭。
|
MASHUPNAME
|
无
|
N
|
N
|
|
HeaderSectionParam
|
页眉混搭参数的名称，该参数用于接收分区标识符。
|
STRING
|
N
|
N
|
|
|
HeaderHeight
|
用于设置：集合中分区的页眉高度。
|
NUMBER
|
40
|
N
|
N
|
|
SectionFooters
|
用于控制：对集合中的单元格进行分组时，分区页脚的可见性。选项：“无”、“可见”、“固定”
|
STRING
|
无
|
N
|
N
|
|
FooterMashup
|
用于指定：对集合中的单元格进行分组时，分区的页脚所用的混搭。
|
MASHUPNAME
|
N
|
N
|
|
|
FooterSectionParam
|
页脚混搭参数的名称，该参数用于接收分区标识符。
|
STRING
|
N
|
N
|
|
|
FooterHeight
|
用于设置：对集合中的单元格进行分组时，分区的页脚高度。
|
NUMBER
|
40
|
N
|
N
|
|
EmptyMashup
|
用于指定：当集合中的某一单元格不包含数据时，所显示的混搭。
|
MASHUPNAME
|
无
|
N
|
N
|
|
Deselect
|
可绑定服务，用于清空集合中的所选内容。
|
服务
|
Y
|
N
|
|
|
SelectAll
|
可绑定服务，用于选择集合中的所有单元格。
|
服务
|
Y
|
N
|
|
|
DisableWrapping
|
启用后，在一行中显示所有单元格，并显示水平滚动条禁用后，当现有水平空间不足以显示整个集合时，换到新的一行继续显示单元格。
|
BOOLEAN
|
False
|
N
|
N
|
事件
|
属性名称
|
说明
|
基本类型
|
可绑定
|
是否可本地化 (Y/N)
|
|---|---|---|---|---|
|
CellClicked
|
当用户单击或轻触集合中的单元格时，触发的事件。
|
事件
|
Y
|
N
|
|
CellDoubleClicked
|
当用户双击或两次轻触集合中的单元格时，触发的事件。
|
事件
|
Y
|
N
|
|
CellLongClicked
|
当用户单击并按住或轻触并按住集合中的单元格超过 400 毫秒时，触发的事件。
|
事件
|
Y
|
N
|
|
CellRightClicked
|
当用户右键单击集合中的单元格时，触发的事件。
|
事件
|
Y
|
N
|