The Autocomplete component is a text input connected to a panel of suggested options. Use it when users need to type, filter a list, and select one matching value. It is best for searchable choices where a normal Select would feel too static or too long.
Use it for:
- Searchable selection: Let users find an item by typing part of its label.
- Filtered options: Connect it to reactive forms and filter options as the input value changes.
- Object values: Store an object as the value and show readable text with displayWith.
- Grouped suggestions: Organize options with option groups when the list has clear sections.
Build Autocomplete with an ngs-form-field, an input using ngsInput and ngsAutocomplete, an ngs-autocomplete panel, and ngs-option items. Do not use it for simple free text, small static lists, command menus, or multi-value tags.