Сплит-кнопка объединяет несколько связанных действий в одном элементе управления. Основное действие доступно сразу, а дополнительные варианты скрыты в выпадающем меню.

Сплит-кнопка повторяет виды оформления обычной кнопки.

Filled Contrast
Filled Fade Contrast
Outline Fade Theme
Outline Fade Contrast
Transparent Theme
Transparent Contrast

Основное действие можно обозначить подписью и иллюстрировать иконкой. У варианта без подписи кнопка-меню становится более узкой.

Длинный текст в основной кнопке не переносится на новую строку, а скрывается под многоточие. Не делайте кнопки с длинным текстом.

Заблокировать можно основное или второстепенное действие, а также целиком всю группу.

Primary Disabled
Secondary Disabled
Сompletely Disabled

Состояние Progress можно комбинировать с любым другим состоянием (Normal, Disabled, Active). Как и состояние Disabled, его можно применить как ко всей группе кнопок, так и к отдельному элементу.

Primary in Progress
Secondary in Progress
Completely in Progress

Расположение меню настраивается, как в компоненте Dropdown. Когда ширина меню примерно равна габаритам сплит-кнопки, для красоты лучше выровнять их.

  • Группировка. Хост объявляется как role="group": он связывает два действия, при этом каждая кнопка остаётся отдельной точкой табуляции. Если на странице несколько сплит-кнопок, задайте группе имя — <kbq-split-button aria-label="Сохранить документ">.
  • Кнопка меню. Кнопка меню состоит только из иконки, поэтому у неё нет ни текста, ни собственного доступного имени. Задайте его явно: <button kbq-button aria-label="Другие действия" [kbqDropdownTriggerFor]="menu">.
  • Состояние открытия. На кнопке меню выставляется aria-expanded, поэтому вспомогательные технологии сообщают, открыто меню или нет.
  • Клавиатура. Tab переводит фокус на основную кнопку, затем на кнопку меню, Enter и Space активируют кнопку в фокусе. На кнопке меню ArrowDown также открывает меню, а Escape закрывает его и возвращает фокус на кнопку — та же модель, что и в Dropdown.
  • Неактивное состояние. Заблокированная кнопка выпадает из порядка табуляции и объявляется неактивной: через нативный атрибут disabled на хосте <button> и через aria-disabled на хостах без нативной поддержки, например <a>.

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

  • Когда есть четкое и часто используемое главное действие. Сплит-кнопка идеальна, когда в 80% случаев пользователю нужно одно действие (например, «Сохранить»), но иногда требуется выбрать другой вариант.
  • Действия в меню однородны и тесно связаны с главным. Все пункты в выпадающем списке должны быть вариациями или уточнениями основного действия.
Предложения по улучшению
Если вы нашли ошибку или хотите доработать статью, создайте запрос на GitHub.