# SearchBox

Read the complete [LICENSE](https://snowui.dev/LICENSE) for the installed version before use.

Open a search popup from a fully clickable search entry, optionally with a shortcut hint.

We are building SnowUI components into interfaces people can use directly in AI conversations. Conversational UI is still in development; this page demonstrates website usage. Supported chat platforms and component versions will be announced after verification. Generating and using SnowUI interfaces inside AI conversations is completely free. It is not a project, uses no project or developer-seat quota, and requires no SnowUI registration, activation, or paid proof.

Package: `@snowui-design-system/components`. Import: `import { SearchBox } from '@snowui-design-system/components';`. Source fingerprint: `953fb6bd4c4fb603ee89ae63f3b26c878d5b1d8850173e548ce96a99d4d33274`.

## Usage choices

Use SearchBox as a clickable entry that opens global search. It is not an editable query input; use SearchInput for direct entry in a toolbar or list.

- This is a clickable search entry. bind:open synchronizes the popup state; value displays the current query.
- Use children for a popup or keyboard-shortcut hint. Use SearchInput when the user must edit a query directly.
- The default placeholder and clear action follow LocaleProvider. Explicit placeholder values, including an empty string, and aria-label take priority; the query remains unchanged.

## Read as needed

- [API](https://snowui.dev/llms/en/components/search-box/api.md): Public Props and defaults
- [Types and states](https://snowui.dev/llms/en/components/search-box/types.md): Public type declarations and binding rules
- [Full reference](https://snowui.dev/llms/en/components/search-box/reference.md): Composition and interaction boundaries
- [Styles](https://snowui.dev/llms/en/components/search-box/styles.md): Registered public overrides
- [Examples](https://snowui.dev/llms/en/components/search-box/examples.md): Code and preview links
- [Image index](https://snowui.dev/llms/components/search-box/images.json): Use only if appearance remains uncertain
- [Changelog](https://snowui.dev/llms/en/components/search-box/changelog.md): Version history reviewed in English

[Design guide](https://snowui.dev/llms/en/design-system.md) · [Styling guide](https://snowui.dev/llms/en/styling.md)