# Search Trigger

> Open Advanced Search from a field-like button or ⌘K.

- Category: Navigation
- Import: `import { SearchTrigger } from "@sagui/ui";`
- Page: /components/search-trigger

```tsx
import { SearchTrigger } from "@sagui/ui";

export function Hero() {
  return (
    <div className="flex items-center gap-4"><SearchTrigger onOpen={() => {}} shortcut={false} /><SearchTrigger variant="icon" onOpen={() => {}} shortcut={false} /></div>
  );
}
```

## When to use

- In the App Bar or Page Header, to open app-wide search.

## When not to use

- Use SearchField to filter a single list in place.

## Installation

Install the package and import the styles once. The [installation guide](/docs/installation) covers the Tailwind setup.

```bash
npm install @sagui/ui
```

## Usage

```tsx
import { SearchTrigger, AdvancedSearch } from "@sagui/ui";

<SearchTrigger onOpen={() => setOpen(true)} />
<AdvancedSearch open={open} onOpenChange={setOpen} results={results} />
```

## Accessibility

- A real button with `aria-haspopup="dialog"` and `aria-keyshortcuts`.
- The icon variant keeps “Search” as its accessible name.
