使用顺序配置属性
许多组件使用 ordinal 配置属性来设置元素在组件用户界面中的显示顺序。例如，“磁贴”使用序数来设置磁贴的顺序，“项列表”使用序数来设置列的顺序。
 |
在组件的自定义实施中使用序数属性时，不要将值 0 或 1 用作序数值。在此情况下，可用于序数属性的最小值为2。
在预定义的配置中使用序数属性时，将值 0 和 1 用作序数值则没有问题。
|
以下是组件配置中顺序显示的示例：
"items": [
{
"id": "RecurringCost",
"ordinal": 1
},
{
"id": "NonRecurringCost",
"ordinal": 0
},
{
"id": "Category",
"ordinal": 3
},
{
"id": "RequestPriority",
"ordinal": 2
}
]
{
"id": "RecurringCost",
"ordinal": 1
},
{
"id": "NonRecurringCost",
"ordinal": 0
},
{
"id": "Category",
"ordinal": 3
},
{
"id": "RequestPriority",
"ordinal": 2
}
]
以上示例中的项以 NonRecurringCost、RecurringCost、RequestPriority、Category 顺序显示在用户界面中。
如果组件配置中未定义任何顺序值，则项会根据其在配置中的顺序显示。如果已在定制页面中定制项的顺序，则顺序值将被覆盖，且用户界面中的顺序将反映该定制。
以下是顺序值可能输入案例的列表以及此类情况下的预期结果：
|
案例
|
顺序值示例
|
用户界面中的行为
|
|---|---|---|
|
顺序值为连续值。
|
0 1 2 3
|
项依照顺序值的顺序显示。
|
|
顺序值为非连续值。
|
2 5 7 8
|
项依照顺序值的顺序显示。
|
|
两个项具有相同的顺序值。
|
0 1 1 2
|
项依照顺序值的顺序显示。具有相同顺序值的项会根据其在配置中的顺序来显示。
在运行期间，INFO 消息会被记录到日志文件中。
|
|
一个或多个项没有顺序值。
|
0 1 [空] 3
|
项依照顺序值的顺序显示。没有顺序值的项显示在最后。如果存在多个没有顺序值的项，则这些项会根据其在配置中的顺序显示在末尾。
在运行期间，INFO 消息会被记录到日志文件中。
|
|
一个或多个项的顺序值输入无效。
请注意，负值将被视为无效输入。
|
0 1 “string” 3
|
具有无效顺序值的项将被视为没有顺序值。这些项会显示在最后，如果存在顺序值无效的多个项，则会根据这些项在配置中的顺序予以显示。
在运行期间，INFO 消息会被记录到日志文件中。
|