Mashup Builder > 小器具 > 標準小器具 > 清單往復小器具 (主題化)
清單往復小器具 (主題化)
您可以使用「清單往復」小器具從現有清單 (來源) 中選取項目，並將其放置在新清單 (目標) 中。在目標清單中，排序所選項目，並從來源清單移除不想要的項目。
* 
「清單往復」小器具可作為平台中的標準小器具使用，也可作為您可從 SDL 匯入的 web 元件使用。
資料格式
可使用資料負載中的資料配置 ListShuttle 小器具項目，資料負載的格式為以下結構：
欄位定義
顯示欄位
IDField
描述
表示在執行時間的清單往復項目的標籤。
表示清單往復項目的實際 ID。此值也會儲存在 SelectedItems 內容中。
基礎類型
STRINGor NUMBER
STRINGor NUMBER
定義清單項目
欲定義清單項目，請繫結使用所需資料格式設定格式的資料負載。
1. 在「資料」面板中，新增定義小器具清單項目的資料服務。您可以使用上一部份內容概述的資料負載格式來定義項目。
2. 將資料服務的 All Data 內容繫結至「清單往復」小器具的 Data 內容。
3. 在「內容」面板中，針對下列內容選取資料負載欄位：
◦ DisplayField - 項目標籤的資料。
◦ IDField - 項目 ID。
4. 按一下「儲存」，然後按一下「檢視混搭」。
清單項目會在執行時間顯示在小器具內。
驗證所選項目數
在 ThingWorx 9.4 或更高版本中，可使用 NumberOfSelectedItems 內容在執行時間追蹤及驗證清單中的所選項目數量。例如，可將內容繫結至驗證器函數。如果所選項目數與特定值不符，也可顯示錯誤訊息並限制使用者儲存頁面。
下列範例顯示了內容與驗證器函數之間的繫結。SelectedItemsChanged 事件可用於透過函數驗證 NumberOfSelectedItems 內容。在執行時間，函數會檢查所選項目數，並在驗證失敗時顯示錯誤訊息。
小器具內容：
屬性名稱
描述
基礎類型
預設值
可繫結? (Y/N)
可當地語系化? (Y/N)
TabSequence
設定當您按下 TAB 鍵時小器具反白的順序。
NUMBER
n/a
N
N
DisplayField
表示資料值的資料負載欄位。
INFOTABLE
n/a
N
N
ListFormat
針對顯示的資料套用特定的轉譯器。在 ThingWorx 9.1 及更新版本中，您可以使用此內容將狀態格式套用至小器具。
轉譯器和狀態格式
n/a
N
N
Disabled
在混搭中禁用此小器具。小器具會顯示，但無法使用。
布林值
False
Y
N
CustomClass
可定義小器具頂層 div 元素的 CSS 類別名稱。輸入多個類別時，請用空格分隔每個類別。
STRING
n/a
Y
N
SelectedItems
清單中所選項目的資料負載來源。
INFOTABLE
n/a
Y
N
SingleSelect
設定單一選取或多重選取。
布林值
False
Y
N
HideFilter
在來源清單中顯示或隱藏篩選器。
布林值
False
Y
N
IDField
包含清單項目 ID 的資料負載欄位。當多個項目共用相同的顯示名稱時，您必須指定 ID 欄位。
* 
此內容在 ThingWorx 9.3.3 或更新版本中可用。
欄位名稱
n/a
n/a
N
Data
小器具的資料來源。
INFOTABLE
n/a
Y
N
ListShuttleLabel
「清單往復」小器具標籤中顯示的文字。
STRING
清單往復
Y
Y
ListShuttleLabelAlignment
將小器具中的標籤「左」、「右」或「置中」對齊。
STRING
左
Y
N
ListShuttleLabelType
將標籤類型設定為「標題」、「子標題」、「標籤」或「本文」。
STRING
子標題
Y
N
NumberOfSelectedItems
傳回 List Shuttle 中所選項目的數量。
* 
• ThingWorx 9.4 及更新版本提供此內容。
• 禁用小器具后，也會設定所選項目的數量。
NUMBER
n/a
Y
N
SourceListLabel
來源清單標籤中顯示的文字。
STRING
來源
Y
Y
SourceListLabelAlignment
將來源清單中的標籤「左」、「右」或「置中」對齊。
STRING
左
Y
N
SourceListLabelType
將標籤類型設定為「標題」、「子標題」、「標籤」或「本文」。
STRING
標籤
Y
N
TargetListLabel
目標清單標籤中顯示的文字。
STRING
目標
Y
Y
TargetListLabelAlignment
將目標清單中的標籤「左」、「右」或「置中」對齊。
STRING
左
Y
N
TargetListLabelType
將標籤類型設定為「標題」、「子標題」、「標籤」或「本文」。
STRING
標籤
Y
N
ResetToDefaultValue
將清單重設為其預設值。
n/a
n/a
Y
N
驗證內容
* 
清單往復小器具的下列驗證內容僅適用于 ThingWorx 9.4 及更高版本。
除通用驗證內容外，還可使用 TargetListMaxItems 和 TargetListMinItems 內容限制小器具中所選項目的數量。當所選項目數超出指定範圍時，會顯示失敗訊息。
屬性名稱
描述
基礎類型
預設值
可繫結? (Y/N)
可當地語系化? (Y/N)
ValidationState
這是設定驗證狀態的可繫結內容。可將此內容設定為未定義、未驗證、有效或無效。
STRING
Undefined
在
N
ValidationOutput
用於擷取小器具驗證輸出的可繫結內容。傳回的值為未定義、未驗證、有效或無效。
STRING
n\a
Out
N
ValueRequired
需將專案新增至目標清單。
布林值
False
在
N
RequiredMessage
ValueRequired 設定為 true 且未將項目新增至目標清單時顯示的訊息。
STRING
「需要選取一項」
In
Y
Validate
小器具值變更時觸發的事件。將此事件繫結至服務或函數以套用驗證運算式。
EVENT
n/a
Out
N
ShowValidationSuccess
驗證成功時顯示成功訊息。
布林值
False
在
N
ValidationSuccessIcon
選取要在驗證成功時於狀況訊息中顯示的 SVG 圖示。
IMAGELINK
success
不適用
N
ShowValidationFailure
驗證失敗時顯示失敗訊息。
布林值
False
在
N
ValidationFailureIcon
選取要在驗證失敗時於狀況訊息中顯示的 SVG 圖示。
IMAGELINK
error
不適用
N
ShowValidationCritera
編輯清單時，顯示有關所需輸入的提示訊息。
布林值
False
在
N
ValidationCriteriaIcon
選取要在驗證條件的提示訊息中顯示的 SVG 圖示。
IMAGELINK
Info
不適用
N
SuccessMessage
驗證成功時顯示的訊息。
STRING
n/a
在
N
SuccessMessageDetails
顯示有關驗證成功訊息之詳細資訊的次要訊息。
STRING
n/a
In
Y
CriteriaMessage
驗證失敗時顯示的訊息。
STRING
n/a
Y
Y
CriteriaMessageDetails
顯示有關驗證失敗訊息之詳細資訊的次要訊息。
STRING
n/a
In
Y
TargetListMinItems
設定目標清單中的最小數目。
NUMBER
n/a
在
N
TargetListMinItemsFailureMessage
目標清單中的所選項目數小於 TargetListMinItems 值時顯示的訊息。
STRING
${value} Is the minimum number of items
In
Y
TargetListMaxItems
設定目標清單中的最大項目數。
NUMBER
n/a
在
N
TargetListMaxItemsFailureMessage
目標清單中的所選項目數大於 TargetListMaxItems 值時顯示的訊息。
STRING
${value} Is the maximum number of items
In
Y
這是否有幫助?