集合小器具 (主題化)
「集合」小器具是一個回應式小器具，可讓您將一系列重複的混搭顯示為集合中的儲存格。您可以配置進階版面配置以及對儲存格進行分組，以便使用者更輕鬆地將集合顯示在各種大小的螢幕上。欲在集合儲存格內顯示資料，您必須為混搭儲存格定義具有資料的資料負載。您也可以配置資料載入行為，以在載入大型資料集時最佳化效能。
 |
此小器具也可作為 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
|