# Search expandable

- Entry point: `@koobiq/components/search-expandable`
- NgModule: `KbqSearchExpandableModule`
- API: https://koobiq.io/api/search-expandable.md
- Component tokens: https://koobiq.io/tokens/search-expandable.md
- Page: https://koobiq.io/en/components/search-expandable/overview

A search field that expands from a compact icon button.

The component is a form control and has no standalone value input: bind it with `[formControl]`, `[formControlName]` or `[(ngModel)]`, otherwise it throws on initialization. The typed value reaches the bound control after `emitValueTimeout` milliseconds, or on `Enter` when `isEmitValueByEnterEnabled` is set.

The clear button and `Escape` clear a non-empty value while keeping the search expanded and the input focused; when the field is empty, they collapse the search.

[**Example: search-expandable** (`search-expandable-overview`)](https://koobiq.io/examples/search-expandable-overview.md)

The expandable search can be used, for example, in an action panel. When the bound model already holds a value, the search renders expanded:

[**Example: search-expandable-in-header** (`search-expandable-in-header`)](https://koobiq.io/examples/search-expandable-in-header.md)
