С помощью радиокнопок пользователи делают выбор из набора взаимоисключающих, связанных между собой вариантов.
Чтобы показать ошибку валидации, привяжите группу к контролу формы, примените required или Validators.required и поместите текст ошибки в kbq-error внутри группы.
Чтобы показывать ошибку в другой момент, передайте matcher во входное свойство errorStateMatcher: в примере ниже ошибка появляется только после отправки формы. Варианты описаны в руководстве по валидации.
Компонент не добавляет собственных обработчиков клавиш. Варианты — это элементы
<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>: это имя станет именем
поля в отправляемых данных, а сгенерированное меняется между запусками приложения. Браузер отправляет
значение кнопки строкой, поэтому в форму попадают только значения, приводимые к строке.