Skip to content
loseta

Components / Forms

Combobox

A text input combined with a listbox of options.

Status stableInstalls listbox, popover-primitiveWorks with button
<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 combobox
npx loseta add combobox

Examples

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.cssbase
styles/nova/combobox.cssstyle

Install 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.

← Back to components

loseta is MIT licensed. Built with native CSS, no runtime. Inspired byshadcn/ui.