使用小工具 > 2D > 清單 (List)
  
清單 (List)
此小工具的功能為何？
「清單」小工具可在單一欄清單檢視中顯示任何資料集合。
使用此小工具的時機？
當您要在資料集合中顯示特定屬性的值時，即可使用清單。舉例來說，如果您要顯示卡車車隊的完整油料狀態，則可使用「清單」小工具並將之繫結到所有卡車共享項目的 OilLevel 屬性。
還有任何特殊屬性、服務、事件、動作嗎？
欲檢視通用小工具的屬性、服務、事件，請參閱 共通的小工具屬性、服務、事件。
下表是此小工具專屬屬性的清單。
屬性
JavaScript
類型
描述
啟用以狀態為基礎的格式
enableStateFormatting
boolean
讓您能根據 ThingWorx 中所定義的狀態定義，設定該小工具的格式。
如果勾選了核取方塊，則下列屬性會顯示：
• 從屬欄位
• 狀態定義
舉例來說，如果某標籤具備 error 的「狀態定義」值，則標籤即轉為紅色。
欲瞭解更多 ThingWorx 中的樣式與狀態定義資訊，可參閱 ThingWorx 輔助說明中心裡的〈樣式與狀態定義〉。
從屬欄位
* 
啟用「啟用以狀態為基礎的格式」時即會顯示。
stateFormatValue
string
如果選取「啟用以狀態為基礎的格式」核取方塊，即會顯示此屬性。欲瞭解更多 ThingWorx 中的樣式與狀態定義資訊，可參閱 ThingWorx 輔助說明中心裡的〈樣式與狀態定義〉。
狀態定義
* 
啟用「啟用以狀態為基礎的格式」時即會顯示。
stateFormat
boolean
如果選取「啟用以狀態為基礎的格式」核取方塊，即會顯示此屬性。欲瞭解更多 ThingWorx 中的樣式與狀態定義資訊，可參閱 ThingWorx 輔助說明中心裡的〈樣式與狀態定義〉。
顯示欄位
label
string
指定「清單」小工具中所要出現的欄位。一般均與「數值」欄位相同，但也有不一樣的地方。
當小工具繫結至 ThingWorx 資料時，即自動產生此欄位與相關選項。
清單項目邊框間距
itempadding
string
內容和邊界之間的空間。請依支援格式之一輸入數字 (例如 10px)：
• px
• %
• in
• mm
• cm
• ex
• em
• pt
• pc
動作中的小工具
此範例為小工具可能的外觀！
使用所必須的最少步驟
近似外觀
1. 拖曳「清單」小工具至畫布上。
2. 從「資料」窗格，針對您想要檢索資料的實體新增服務。
3. 一旦新增該服務之後，將「所有項目」拖曳至小工具上，並選擇「選擇繫結目標」視窗上的「清單」。
4. 在「詳細資訊」窗格的「顯示欄位」中，選取您要在清單中顯示的屬性。
繫結 ThingWorx 資料後的輔助組態欄位
在繫結 ThingWorx 資料至小工具之後，隨即在下拉式清單中顯示某些欄位的選項。舉例來說，如果您繫結「所有項目」至「清單」小工具，並選取「選擇繫結目標」視窗上的「清單」，則「顯示欄位」屬性會出現可用選項。