# Autocomplete

> Autocomplete input that filters a list as you type.

Registry name: `autocomplete`. HTML docs: https://ui.anuragroy.dev/component/autocomplete.

## Install

```bash
npx shadcn@latest add https://ui.anuragroy.dev/r/autocomplete.json
```

If the website is down: `npx shadcn@latest add https://raw.githubusercontent.com/anurag-roy/ui.anuragroy.dev/main/public/r/autocomplete.json`.

Registry JSON: https://ui.anuragroy.dev/r/autocomplete.json (GitHub: https://raw.githubusercontent.com/anurag-roy/ui.anuragroy.dev/main/public/r/autocomplete.json).

## Import

Import paths follow the consumer `components.json` aliases. After a default install:

```tsx
import {
  Autocomplete,
  AutocompleteClear,
  AutocompleteContent,
  AutocompleteEmpty,
  AutocompleteIcon,
  AutocompleteInput,
  AutocompleteInputGroup,
  AutocompleteItem,
  AutocompleteList
} from "@/components/ui/autocomplete"
```

## Usage

```tsx
import {
  Autocomplete,
  AutocompleteClear,
  AutocompleteContent,
  AutocompleteEmpty,
  AutocompleteIcon,
  AutocompleteInput,
  AutocompleteInputGroup,
  AutocompleteItem,
  AutocompleteList,
} from "@/components/ui/autocomplete"

const items = ["Apple", "Banana", "Orange"]

export function Example() {
  return (
    <Autocomplete items={items}>
      <AutocompleteInputGroup>
        <AutocompleteIcon />
        <AutocompleteInput placeholder="Search fruit…" />
        <AutocompleteClear />
      </AutocompleteInputGroup>
      <AutocompleteContent>
        <AutocompleteEmpty>No results</AutocompleteEmpty>
        <AutocompleteList>
          {(item: string) => (
            <AutocompleteItem key={item} value={item}>
              {item}
            </AutocompleteItem>
          )}
        </AutocompleteList>
      </AutocompleteContent>
    </Autocomplete>
  )
}
```

## API

### Autocomplete

Base UI Autocomplete root.

| Prop | Type | Default | Description |
| --- | --- | --- | --- |
| `items` | readonly Item[] | — |  |

## See also

- [HTML page](https://ui.anuragroy.dev/component/autocomplete): Preview and the same docs in the site chrome.
- [Registry item](https://ui.anuragroy.dev/r/autocomplete.json): Source files and dependencies.
- [Catalog](https://ui.anuragroy.dev/component): All components.
- [llms.txt](https://ui.anuragroy.dev/llms.txt): Agent index for this library.