進階自訂 > 使用可重複使用的元件 > 其他組態資訊 > 使用序數組態欄位
  
使用序數組態欄位
許多可重複使用的元件使用 ordinal 組態欄位來設定元素在元件使用者介面中的顯示順序。例如,圖標元件會使用序數來設定圖標的順序,而動作列元件會使用它來設定動作的順序。對於除動作列以外之所有可重複使用的元件,僅支援序數的非負值,且會將負值視為無效輸入。動作列支援負序數值。所有可重複使用的元件支援零作為序數值。
以下是序數出現在元件組態中的範例:
"items": [
{
"id": "RecurringCost",
"ordinal": 1
},
{
"id": "NonRecurringCost",
"ordinal": 0
},
{
"id": "Category",
"ordinal": 3
},
{
"id": "RequestPriority",
"ordinal": 2
}
]
上述範例中的項目會以下列順序顯示在使用者介面中:NonRecurringCostRecurringCostRequestPriorityCategory
如果在元件組態中沒有定義序數值,則項目會根據其在組態中的順序顯示出來。如果在調整頁中為項目排序,則會取代序數值,且使用者介面中的順序會反映出該調整。
以下是序數值的可能輸入案例清單,以及在這些情況下預期的結果:
案例
序數值的範例
使用者介面中的行為
順序值是連續值。
1 2 3 4
項目會以序數值的順序顯示。
順序值是非連續值。
2 5 7 8
項目會以序數值的順序顯示。
兩個項目具有相同的序號值。
1 2 2 4
項目會以序數值的順序顯示。具有相同序數值的項目會根據其在組態中的順序顯示。
在執行時間期間,會將資訊訊息記錄到記錄檔中。
一或多個項目沒有序數值。
1 2 [空] 4
項目會以序數值的順序顯示。不含序數值的項目會顯示在最後。如果多個項目沒有序數值,它們會根據其在組態中的順序顯示在結尾。
在執行時間期間,會將資訊訊息記錄到記錄檔中。
有一個或多個項目的輸入對於序數值無效。
1 2 “string” 3
具有無效序數值的項目會視為沒有序數值的項目。其會顯示在最後,并且當多個項目具有無效序數值時,其會根據在組態中的順序顯示出來。
在執行時間期間,會將資訊訊息記錄到記錄檔中。