Перейти к основному содержимому
Версия: Next

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​

Properties​

order?​

readonly optional order: number

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

Remarks​

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

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

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

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

Примеры:

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