Accessibility · Library v2.7.0

Typeahead WAI-ARIA Support

Typeahead keeps focus in the input while moving an active suggestion. Selection and chip behavior depend on configuration.

Roles, states and properties

These describe the installed implementation. ARIA communicates meaning; keyboard handlers and application code provide the interaction.

Typeahead accessibility semantics
ElementSemanticsBehavior
Inputcombobox, aria-autocomplete="list"aria-expanded, aria-controls and aria-activedescendant describe the popup and active result.
PopuplistboxContains the rendered suggestion buttons.
Suggestionsoption, aria-selected, tabindex="-1"Options stay outside the tab order while the combobox exposes the active result. The listbox exposes aria-multiselectable in multi-select mode.

Current limitations

  • Virtual result position/count announcements and multi-select focus behavior need further work.
  • Multi-select, chips and virtual results need separate assistive-technology checks.

This reference is based on the shipped source. It is not a WCAG conformance certificate or a claim that every browser and screen reader combination has been tested.

Compare your workflow with the W3C authoring pattern. The pattern describes the target interaction, not a guarantee of current component support.

This project is not affiliated with ng-bootstrap or ngx-bootstrap. Those projects focus mainly on Bootstrap components for Angular. ngbootstrap focuses on Angular UI for data-heavy apps, especially Data Grid, Angular-native Form Builder, drag and drop workflows, documentation examples, and performance-focused Angular patterns.