Components / Forms
Combobox
A text input combined with a listbox of options.
<div class="combobox">
<input role="combobox" aria-expanded="false" aria-controls="combobox-default-panel" aria-autocomplete="list" placeholder="Select a framework..." aria-label="Select a framework">
<div data-popover data-side="bottom" aria-hidden="true" id="combobox-default-panel">
<div role="listbox" aria-label="Frameworks">
<div role="option" aria-selected="false"><span data-slot="text">React</span></div>
<div role="option" aria-selected="false"><span data-slot="text">Vue</span></div>
<div role="option" aria-selected="false"><span data-slot="text">Svelte</span></div>
<div data-slot="empty" hidden>No framework found.</div>
</div>
</div>
</div>Installation
pnpm dlx loseta add comboboxnpx loseta add comboboxExamples
Single
<div class="combobox">
<input role="combobox" aria-expanded="false" aria-controls="combobox-fruit-panel" aria-autocomplete="list" placeholder="Search fruit..." aria-label="Search fruit">
<button type="button" class="btn" data-variant="ghost" data-size="icon-xs" data-slot="clear" aria-label="Clear">×</button>
<div data-popover data-side="bottom" aria-hidden="true" id="combobox-fruit-panel">
<div role="listbox" aria-label="Fruit">
<div role="option" aria-selected="false"><span data-slot="text">Apple</span></div>
<div role="option" aria-selected="false"><span data-slot="text">Banana</span></div>
<div role="option" aria-selected="false"><span data-slot="text">Orange</span></div>
<div role="option" aria-selected="false"><span data-slot="text">Pineapple</span></div>
<div data-slot="empty" hidden>No fruit found.</div>
</div>
</div>
</div>Multiple
<div class="combobox">
<input role="combobox" aria-expanded="false" aria-controls="combobox-tag-panel" aria-autocomplete="list" placeholder="Search tags..." aria-label="Search tags">
<button type="button" class="btn" data-variant="ghost" data-size="icon-xs" data-slot="clear" aria-label="Clear">×</button>
<div data-popover data-side="bottom" aria-hidden="true" id="combobox-tag-panel">
<div role="listbox" aria-label="Tags" aria-multiselectable="true">
<div role="option" aria-selected="true"><span data-slot="text">Design</span></div>
<div role="option" aria-selected="false"><span data-slot="text">Engineering</span></div>
<div role="option" aria-selected="true"><span data-slot="text">Docs</span></div>
<div data-slot="empty" hidden>No tags found.</div>
</div>
</div>
</div>Accessibility and behavior
- An input with role="combobox", aria-expanded and aria-controls. The panel is a [data-popover] containing a [role="listbox"]. Add aria-multiselectable="true" for multiple selection. Filtering, selection and keyboard navigation are consumer JavaScript; selected chips are composed with badges.
Files
components/combobox.cssbasestyles/nova/combobox.cssstyleInstall contract
The CLI writes the base file under components/, the visual file for the selected style under styles/<name>/, and any primitive dependency underprimitives/. The generated index.css imports them in the right layer order.