Interface: MayHaveOrder

Expand

Тип для элементов UI, которым порядок может быть указан опционально.

Если order не указан, элемент добавляется в конец списка.

Remarks

Использование:

• Когда точный порядок важен, используйте HasOrder с обязательным order
• Когда порядок может быть произвольным, используйте MayHaveOrder

Поведение если order не указан:

• Элемент добавляется в конец списка
• После других элементов с явно указанным order
• Порядок нескольких элементов без order не гарантирован

Example

// С порядком — будет в начале
{ id: 'item1', title: 'First', order: 10 }

// Без порядка — будет в конце
{ id: 'item2', title: 'Second' }

// Без порядка — будет в конце
{ id: 'item3', title: 'Third' }

Extended by

• CustomRibbonGroup
• CustomSidebarTabInfo

Properties

order?

readonly optional order: number

Число, определяющее позицию элемента среди аналогичных элементов в родительском контейнере.

Remarks

Правила сортировки:

• Элементы сортируются по возрастанию (меньшее order — левее или выше)
• Элементы расположены по возрастанию значения order
• Контейнер автоматически переупорядочивает элементы при изменении order

Рекомендуемые значения:

• 10, 20, 30 — для встроенных элементов
• 15, 25, 35 — для пользовательских элементов

Примеры:

// На ленте
{ id: 'tab:file', order: 10 }      // Слева
{ id: 'tab:edit', order: 20 }      // В середине
{ id: 'plugin:tab', order: 100 }   // Справа

// В меню
{ id: 'copy', order: 10 }
{ id: 'cut', order: 20 }
{ id: 'separator', order: 30 }
{ id: 'paste', order: 40 }