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

Normal
Big
Normal
Error
Text
Text with Caption
Field label

Чтобы показать ошибку валидации, привяжите группу к контролу формы, примените required или Validators.required и поместите текст ошибки в kbq-error внутри группы.

Чтобы показывать ошибку в другой момент, передайте matcher во входное свойство errorStateMatcher: в примере ниже ошибка появляется только после отправки формы. Варианты описаны в руководстве по валидации.

Second sign-in factor
Save without choosing to see the error

Компонент не добавляет собственных обработчиков клавиш. Варианты — это элементы <input type="radio"> с общим name, поэтому взаимодействие обеспечивает браузер:

  • Группа — одна остановка табуляции. По клавише Tab фокус попадает на выбранный вариант, а если выбранного нет — на первый доступный; следующее нажатие уводит фокус за пределы группы.
  • Клавиши со стрелками перемещают фокус между вариантами и сразу меняют выбор, поэтому любое перемещение по группе меняет ее значение. Отключенные варианты браузер пропускает.
  • Клавиша Space выбирает вариант, на котором стоит фокус.

Группировку задает name, а не разметка. Кнопки с одинаковым именем образуют одну остановку табуляции, даже если лежат в разных контейнерах. Кнопка вне группы получает имя, уникальное для нее самой, и потому становится отдельной остановкой.

kbq-radio-group имеет роль radiogroup, а такая роль не берет название из вложенных вариантов. Свяжите группу с ее видимой подписью — напишите aria-labelledby (или aria-label) прямо на элементе, как на любом другом хосте:

<div id="delivery-label" class="kbq-form__label">Доставка</div>
<kbq-radio-group aria-labelledby="delivery-label">
    <kbq-radio-button [value]="'pickup'">Самовывоз</kbq-radio-button>
    <kbq-radio-button [value]="'courier'">Курьер</kbq-radio-button>
</kbq-radio-group>

kbq-hint, вложенный в кнопку, попадает в ее описание, а не в название: вспомогательные технологии объявляют вариант его текстом, а подпись могут пропустить.

[required] на группе доходит до radiogroup как aria-required, а группа с цветом ошибки или в состоянии ошибки — как aria-invalid. Ошибка и подсказка группы озвучиваются как её описание вместе с aria-describedby, который вы задали на группе сами.

focus() принимает FocusOrigin — и у кнопки, и у группы, которая передает фокус выбранному варианту. Передавайте 'keyboard', когда переводите фокус в ответ на действие с клавиатуры, чтобы было видно кольцо фокуса; значение по умолчанию 'program' переводит фокус без него.

Группа генерирует уникальный name, а ее кнопки его наследуют, поэтому вручную задавать имя не нужно. Кнопка вне группы получает имя, уникальное для нее самой, и потому не зависит от остальных одиночных радиокнопок в приложении.

Задавайте имя группы явно, если она участвует в отправке нативной <form>: это имя станет именем поля в отправляемых данных, а сгенерированное меняется между запусками приложения. Браузер отправляет значение кнопки строкой, поэтому в форму попадают только значения, приводимые к строке.

  • Рекомендуется использовать в Radio Group не более семи вариантов.
  • Используйте Button Toggle для коротких вариантов, если по горизонтали есть свободное место.
  • Если нужно показать больше семи вариантов, используйте Select.
  • Если выбор предполагает два значения и его можно классифицировать как булевый, используйте Toggle. Toggle применяет изменения мгновенно, без дополнительного сохранения данных.
Предложения по улучшению
Если вы нашли ошибку или хотите доработать статью, создайте запрос на GitHub.