序数コンフィギュレーションフィールドの使用

多くの再使用可能なコンポーネントは、ordinal コンフィギュレーションフィールドを使用して、コンポーネントユーザーインタフェースに表示されるエレメントの順序を設定します。たとえば、タイルコンポーネントや操作バーコンポーネントは、序数を使用して各タイルの順序や操作の順序を設定します。操作バー以外の再使用可能なすべてのコンポーネントでは、序数には負でない値のみがサポートされ、負の値は無効な入力として扱われます。操作バーは負の序数値をサポートします。また、すべての再使用可能なコンポーネントは、序数値としてゼロをサポートします。

コンポーネントコンフィギュレーションに序数値が定義されていない場合、アイテムはコンフィギュレーションにある順序に従って表示されます。調整ページでアイテムの順序が調整されている場合は、序数値がオーバーライドされ、ユーザーインタフェースでの順序には調整が反映されます。

ケース	序数値の例	ユーザーインタフェースでの動作
順序の値は順番どおりです。	1 2 3 4	アイテムは、序数値の順序で表示されます。
順序の値は順番どおりでなく、バラバラです。	2 5 7 8	アイテムは、序数値の順序で表示されます。
2 つのアイテムの序数値は同じです。	1 2 2 4	アイテムは、序数値の順序で表示されます。同じ序数値のアイテムは、コンフィギュレーションにある順序に従って表示されます。ランタイム時に、INFO メッセージがログファイルに記録されます。
1 つ以上のアイテムに序数値がありません。	1 2 [空] 4	アイテムは、序数値の順序で表示されます。序数値のないアイテムは最後に表示されます。複数のアイテムに序数値がない場合は、コンフィギュレーションにある順序に従って末尾に表示されます。ランタイム時に、INFO メッセージがログファイルに記録されます。
1 つ以上のアイテムに、序数値として無効な入力があります。	1 2 “string” 3	無効な序数値のアイテムは、序数値のないアイテムとして扱われます。これらは最後に表示され、複数のアイテムの序数値が無効な場合は、コンフィギュレーションにある順序に従って表示されます。ランタイム時に、INFO メッセージがログファイルに記録されます。