Search input with a leading icon, sizes, and an optional clear button.
Setup
<script lang="ts">
import { Search } from '@cailabs/components.forms';
</script> Default search
<script lang="ts">
import { Search } from '@cailabs/components.forms';
let q = $state('');
</script>
<Search bind:value={q} placeholder="Search components…" clearable /> Sizes
size: sm | md (default) | lg.
<Search size="sm" placeholder="Small" />
<Search size="md" placeholder="Medium" />
<Search size="lg" placeholder="Large" /> Clearable
<script lang="ts">
import { Search } from '@cailabs/components.forms';
let q = $state('Bitblue');
</script>
<Search
bind:value={q}
clearable
clearableOnClick={() => console.log('cleared')}
placeholder="Search…"
/> Children / right content
<script lang="ts">
import { Button } from '@cailabs/components.base';
import { Search } from '@cailabs/components.forms';
</script>
<Search placeholder="Search docs…">
<Button size="xs" class="me-1">Go</Button>
</Search> Accessibility
- Uses
type="search"semantics with a decorative leading icon. - Provide an accessible name via
aria-labelor a visibleLabel. - Clear control is available when
clearableis set.
Props
| Prop | Type | Default | Description |
|---|---|---|---|
value | string | — | Bindable query |
size | sm | md | lg | md | Control size |
placeholder | string | Search | Placeholder text |
children | Snippet | — | Right-side content |
clearable | boolean | false | Show clear button |
clearableOnClick | () => void | — | Extra clear callback |
elementRef | HTMLInputElement | — | Bindable input element |
classes | theme slots | — | Slot class overrides |
disabled / name / id | native | — | HTML input attrs |
class | ClassValue | — | Extra classes |
...rest | HTML input attrs | — | Other input attributes |