Accessibility · Library v2.6.0

Typeahead Accessibility Overview

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

Keyboard interaction

Typeahead keyboard behavior
KeyAction
Up / DownMove the active suggestion.
Home / EndMove to the first/last result while the popup is open.
EnterSelect the active result, or the first visible result.
EscapeClose the popup.
TabSelect an active suggestion when the popup is open. In chips + multiSelect mode, updateOnTab consumes Tab to add a token.

In your application

  • Provide a visible field label and verify the internal input has an accessible name. A placeholder alone is not a label.
  • Prefer updateOnTab=false when users need ordinary Tab navigation through a form.
  • Keep custom suggestion templates concise and avoid nested interactive controls.

Keep focus indicators visible, check contrast with your theme, and test at browser zoom. Try the component examples using only a keyboard.

Current limitations

  • A dedicated internal-input labeling API is not yet available. 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.