Checkbox позволяет выбирать независимые параметры, а также может отображать состояние выбора группы.

Dual-state применяется с использованием логического атрибута [checked], чтобы показать, установлен checkbox или нет.

Состояние indeterminate применяется с использованием логического атрибута «[indeterminate]» и может использоваться, когда у вас есть группа параметров, а checkbox более высокого уровня должен отобразить их состояние:

  • если выбраны только некоторые параметры в группе, флажок более высокого уровня отображается частично выбранным ([indeterminate]="true").
  • если выбраны все, отображается checkbox более высокого уровня.
  • Если ни один не выбран, checkbox более высокого уровня появляется не установленным.

Когда пользователь кликает на kbq-checkbox, поведение по умолчанию переключает значение checked и устанавливает indeterminate в false. Это поведение может быть настроено добавлением нового значения KBQ_CHECKBOX_CLICK_ACTION на checkbox.

providers: [
    { provide: KBQ_CHECKBOX_CLICK_ACTION, useValue: 'check' }
];

Возможные значения: noop, check, check-indeterminate

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

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

Предложения по улучшению
Если вы нашли ошибку или хотите доработать статью, создайте запрос на GitHub.