UI Library

Prop Type Default Value Notes
ariaLabelstring—
Required accessible name.
clearLabelstring?'Clear'
Accessible name for the clear button.
clearPlacement'auto' | 'inside' | 'outside''auto'
Inside overlays the field edge; outside sits after it; auto stays inside (no trailing adornment).
clearablebooleanfalse
Appends a cross button that clears the value.
defaultValuestring?''
Baseline the clear button compares against; the cross hides while the value matches it.
hideOutlinebooleanfalse
Drops the field’s border and focus border while keeping its surface, padding, and text metrics.
inputClassstring?built-in
Replaces the default input classes.
inputRefHTMLInputElement | nullnull—Bindable native input.
placeholderstring?'Search...'
Native placeholder.
ratiosSearchInputRatioOverrides?—
Partial override of the field and search-icon ratios; the gutter derives from the icon inset, glyph, and gap.
size'xs' | 'sm' | 'md' | 'lg' | 'xl' | number'md'
Box, text, and icon scale together; numbers are icon-scale pixels interpolated between the steps.
valuestring—
Bindable search text; the eye resets it to empty.
wrapperClassstring?''
Extra classes for the outer wrapper.
onClear() => voidclears value—Clear handler; falls back to clearing the bound value when omitted.
onblur(event: FocusEvent) => void——Blur callback.
onfocus(event: FocusEvent) => void——Focus callback.
oninput(event: Event) => void——Input callback.
onkeydown(event: KeyboardEvent) => void——Keydown callback; Escape clears in this demo.