高级自定义 > 使用可重用组件 > 其他配置信息 > 使用顺序配置字段
  
使用顺序配置字段
许多可重用组件使用 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
项依照顺序值的顺序显示。具有相同序号值的项会根据其在配置中的顺序显示。
在运行期间,INFO 消息会被记录到日志文件中。
一个或多个项没有顺序值。
1 2 [空] 4
项依照顺序值的顺序显示。没有顺序值的项显示在最后。如果存在多个没有顺序值的项,则这些项会根据其在配置中的顺序显示在末尾。
在运行期间,INFO 消息会被记录到日志文件中。
一个或多个项的顺序值输入无效。
1 2 “string” 3
具有无效顺序值的项将被视为没有顺序值。这些项会显示在最后,如果存在顺序值无效的多个项,则会根据这些项在配置中的顺序予以显示。
在运行期间,INFO 消息会被记录到日志文件中。