自訂 ThingWorx Navigate > 建立自訂任務 > 在自訂任務中使用 ThingWorx Navigate 元件 > 配置元件 > 使用序數組態內容
  
使用序數組態內容
許多元件都使用 ordinal 組態內容來設定元素在元件使用者介面中的顯示順序。例如,「圖標」會使用序數來設定圖標的順序,而「項目清單」則使用序數來設定欄的順序。
* 
當在元件的自訂實行中使用序數內容時,請勿使用值 0 或 1 作為序數值。在這種情況下,可用於序數內容的最低值為 2。
當在預先定義的組態中使用序數內容時,可以使用值 0 與 1 作為序數值。
以下是序數出現在元件組態中的範例:
"items": [
{
"id": "RecurringCost",
"ordinal": 1
},
{
"id": "NonRecurringCost",
"ordinal": 0
},
{
"id": "Category",
"ordinal": 3
},
{
"id": "RequestPriority",
"ordinal": 2
}
]
上述範例中的項目會以下列順序顯示在使用者介面中:NonRecurringCostRecurringCostRequestPriorityCategory
如果在元件組態中沒有定義序數值,則項目會根據其在組態中的順序顯示出來。如果在調整頁中為項目排序,則會取代序數值,且使用者介面中的順序會反映出該調整。
以下是序數值的可能輸入案例清單,以及在這些情況下預期的結果:
案例
序數值的範例
使用者介面中的行為
順序值是連續值。
0 1 2 3
項目會以序數值的順序顯示。
順序值是非連續值。
2 5 7 8
項目會以序數值的順序顯示。
兩個項目具有相同的序號值。
0 1 1 2
項目會以序數值的順序顯示。具有相同序數值的項目會根據其在組態中的順序顯示。
在執行時間期間,會將資訊訊息記錄到記錄檔中。
一或多個項目沒有序數值。
0 1 [空白] 3
項目會以序數值的順序顯示。不含序數值的項目會顯示在最後。如果多個項目沒有序數值,它們會根據其在組態中的順序顯示在結尾。
在執行時間期間,會將資訊訊息記錄到記錄檔中。
有一個或多個項目的輸入對於序數值無效。
請注意,會將負數值視為無效輸入。
0 1 “string” 3
具有無效序數值的項目會視為沒有序數值的項目。其會顯示在最後,并且當多個項目具有無效序數值時,其會根據在組態中的順序顯示出來。
在執行時間期間,會將資訊訊息記錄到記錄檔中。