Checkbox @ngb-bootstrap/core/checkbox

A checkbox built on Bootstrap 6 .check over a native <input type="checkbox">. It binds with [(value)], [(ngModel)] or formControlName, and supports an indeterminate state.

Basic

The projected content is the label. hint adds a description linked with aria-describedby.
You can change this later.

Accepted: no

Indeterminate

A parent checkbox shows a dash when only some children are selected. A user toggle clears the state.

Reactive forms

Works with formControlName and validators such as Validators.requiredTrue. The checkbox shows its error state once its control is invalid and touched; [invalid] forces it on or off, e.g. for a server error.

Sizes, colors and states

sm, md and lg sizes, theme colours, and disabled, invalid and indeterminate states.

Accessibility

The control is a native checkbox, so Space toggles it and it is announced as checked, unchecked or mixed (when indeterminate). The projected label is a <label for> tied to the input with an SSR-safe id, so clicking the text toggles it. hint text is linked with aria-describedby. An invalid control sets aria-invalid; also explain the error in text, as colour alone is not enough. Disabled controls leave the tab order.

© 2026 The ngb-bootstrap authors · Apache-2.0