Forms
SearchField
Captures search queries with native search semantics.
01
See it and copy it
Framework example
Choose Astro, React, or Elements to compare native usage against the shared visual output. Each example assumes the framework-level setup is already complete.
CmdK
Framework usage
Switch targets to compare the adapter code. The preview stays visually stable because all three packages share the same tokens andui-* class contract.---
import { Icon, InputGroup, Kbd, SearchField } from '@santi020k/lumen-astro'
---
<InputGroup>
<Icon name="search" decorative />
<SearchField name="q" placeholder="Search docs" />
<div class="pointer-events-none flex items-center gap-1 px-2 opacity-50">
<Kbd>Cmd</Kbd>
<Kbd>K</Kbd>
</div>
</InputGroup>import { Icon, InputGroup, Kbd, SearchField } from '@santi020k/lumen-react'
export const Example = () => (
<>
<InputGroup>
<Icon name="search" decorative />
<SearchField name="q" placeholder="Search docs" />
<div className="pointer-events-none flex items-center gap-1 px-2 opacity-50">
<Kbd>Cmd</Kbd>
<Kbd>K</Kbd>
</div>
</InputGroup>
</>
)<script type="module">
import { defineLumenElements } from '@santi020k/lumen-elements/define'
defineLumenElements()
</script>
<lumen-input-group>
<lumen-icon name="search" decorative></lumen-icon>
<lumen-search-field name="q" placeholder="Search docs"></lumen-search-field>
<div class="pointer-events-none flex items-center gap-1 px-2 opacity-50">
<lumen-kbd>Cmd</lumen-kbd>
<lumen-kbd>K</lumen-kbd>
</div>
</lumen-input-group>02
Choose your target
Add this component
Choose the package for your runtime. All adapters share the Lumen stylesheet. Use the matching registry command when you want a local wrapper for that framework.
pnpm add @santi020k/lumen-astropnpm add @santi020k/lumen-astrolumen add SearchFieldlumen add SearchFieldpnpm add @santi020k/lumen-reactpnpm add @santi020k/lumen-reactlumen add SearchField --target reactlumen add SearchField --target reactpnpm add @santi020k/lumen-elementspnpm add @santi020k/lumen-elementslumen add SearchField --target elementslumen add SearchField --target elementsAPI reference
Lumen-specific props and runtime attributes for the Astro primitive. React props follow the same names; Elements use equivalent kebab-case attributes where custom elements expose them.
| Attribute | Values | Default | Description |
|---|---|---|---|
| type | HTML input type | "search" | Sets the native input type. |
| class, className | string | "" | Merges custom classes with the generated ui-* root classes. |
| ...native attributes | HTML attributes | - | Forwards standard attributes to the root element unless the component consumes them. |