# Listbox

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

Present selectable options in a popup with search filtering and keyboard support, including Select panels.

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 { Listbox } from '@snowui-design-system/components';`. Source fingerprint: `4c2bffeb662c334a80fd7b69b95ca537185cedd693e64e8efdba4c362b7d9094`.

## Usage choices

Use Listbox for an option panel with keyboard navigation and selection semantics, usually hosted by Select. Notifications, contacts, and activity feeds are content lists and do not use Listbox.

- Each item needs a unique value; label provides display text and search text. children replaces the generated items.
- For explicit options, use MenuItem as="item". For an explicit search field, use Input as="search" and disable built-in search to avoid duplicate inputs.
- The generated search placeholder follows LocaleProvider through listbox.search. Explicit parts.Input.placeholder values, including an empty string, and native aria-label values retain priority. Configure explicit Input children yourself; query text and option content are not translated.

## Read as needed

- [API](https://snowui.dev/llms/en/components/listbox/api.md): Public Props and defaults
- [Types and states](https://snowui.dev/llms/en/components/listbox/types.md): Public type declarations and binding rules
- [Full reference](https://snowui.dev/llms/en/components/listbox/reference.md): Composition and interaction boundaries
- [Styles](https://snowui.dev/llms/en/components/listbox/styles.md): Registered public overrides
- [Examples](https://snowui.dev/llms/en/components/listbox/examples.md): Code and preview links
- [Image index](https://snowui.dev/llms/components/listbox/images.json): Use only if appearance remains uncertain
- [Changelog](https://snowui.dev/llms/en/components/listbox/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)