Autocomplete

Overview

Copy the source into your project, then import the parts you need. Styles use local StyleX declarations and shared theme tokens. You can change the source without wrapping or replacing a package.

Installation

Run bunx @yopem-ui/cli init from your project root first. The CLI configures StyleX and installs shared files and dependencies.

bunx @yopem-ui/cli init

bunx @yopem-ui/cli add autocomplete

Run from your project root. The CLI installs required components, shared files, and packages. Previews may need additional components. Existing files are preserved. To refresh installed source, use update; locally edited files need an explicit --force to overwrite.

bunx @yopem-ui/cli update autocomplete

Preview

"use client"

import {
  Autocomplete,
  AutocompleteEmpty,

Usage

Use AutocompleteInput and AutocompletePopup with AutocompleteList and AutocompleteItem inside Autocomplete.

Autocomplete suggests text without requiring the input to equal an option. Supply items and render matching results through the list or collection. AutocompleteEmpty covers no matches; AutocompleteStatus announces result updates.

The input can include a trigger, clear button and start addon. Use Combobox when users must select values.

Import from the local file installed by the CLI.

"use client"

import {
  Autocomplete,
  AutocompleteEmpty,
  AutocompleteInput,
  AutocompleteItem,
  AutocompleteList,
  AutocompletePopup,
} from "@/components/ui/autocomplete"

export function Preview() {
  const items = [
    { label: "Apple", value: "apple" },
    { label: "Banana", value: "banana" },
  ]

  return (
    <Autocomplete items={items}>
      <AutocompleteInput aria-label="Fruit" placeholder="Choose a fruit" />
      <AutocompletePopup>
        <AutocompleteEmpty>No fruit found.</AutocompleteEmpty>
        <AutocompleteList>
          {(item) => (
            <AutocompleteItem key={item.value} value={item}>
              {item.label}
            </AutocompleteItem>
          )}
        </AutocompleteList>
      </AutocompletePopup>
    </Autocomplete>
  )
}

API reference

Generated from canonical TypeScript source. Only component and Base UI props appear below. Required marks a required property, not a required component.