UI Library

Prop Type Default Value Notes
ariaLabelstring?—
Accessible name; optional so wrappers can leave it to an external label.
autocompletestring?—
Native autocomplete token.
classNamestring?''
Extra classes appended to the input.
clearLabelstring?'Clear'
Accessible name for the clear button.
clearPlacement'auto' | 'inside' | 'outside''auto'
Inside overlays the field edge; outside sits after it; auto picks outside when a trailing adornment is set.
clearablebooleanfalse
Appends a cross button that clears the value.
defaultValuestring?''
Baseline the clear button compares against; the cross hides while the value matches it.
disabledbooleanfalse
Disables the input.
hideOutlinebooleanfalse
Drops the bordered field’s border and focus border while keeping its surface, padding, and text metrics.
idstring?—
Native input id.
inputClassstring?built-in
Replaces the default input classes.
inputStylestring?—
Inline style appended after the size metrics; sizes the field at runtime.
inputmodestring?—
Native inputmode; NumberInput drives numeric/decimal.
leadingSnippet—
Adornment block rendered before the text, positioned inside the frame.
namestring?—
Native input name.
placeholderstring?—
Native placeholder.
ratiosTextInputRatioOverrides?—
Partial override of the field’s tunable ratios (font, radius, paddings, the clear box and gutter, and the trailer gap); the editor opens on the shared defaults, omitted keys keep them, the line box follows the font, and the clear inset follows padX.
readonlybooleanfalse
Read-only input.
requiredbooleanfalse
Native required flag.
size'xs' | 'sm' | 'md' | 'lg' | 'xl' | number'md'
Control scale; numbers are icon-scale pixels interpolated between the steps.
trailerSnippet—
Content rendered outside the field, after it, in a size-scaled row.
trailingSnippet—
Adornment block rendered after the text, positioned inside the frame.
typestring?'text'
Native input type; PasswordInput and SearchInput drive it.
valuestring—
Bindable field value; the eye resets it to empty.
variant'bordered' | 'embedded''bordered'
Chrome variant; embedded drops the border, the background, and the focus ring for a field rendered inside another surface.
wrapperStylestring?—
Style for the wrapping frame: the adornments’ metric custom properties and any frame-level layout a composite supplies.
inputRefHTMLInputElement | nullnull—Bindable native input.
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.
onpointercancel(event: PointerEvent) => void——Pointer-cancel callback.
onpointerdown(event: PointerEvent) => void——Pointer-down callback.
onpointerup(event: PointerEvent) => void——Pointer-up callback.