UI Library

Prop Type Default Value Notes
chipSnippet<[tag, remove]>—
Custom chip renderer; committing applies it, and the dialog edits its prefix text.
chipClassstring | ((tag: string) => string)?—
Chip classes; a string applies to all, a function overrides per tag (wins over the palette) and owns the whole class string, shape included.
clearLabelstring?'Clear tags'
Accessible name for the clear button.
clearPlacement'auto' | 'inside' | 'outside''auto'
Inside overlays the box edge; outside sits after it; auto renders inside with the tags.
clearablebooleanfalse
Appends a cross button that resets the tags to the default value.
defaultValuestring[]?—
Baseline the clear button compares against; the cross hides while the tags match it; the eye applies the list.
disabledbooleanfalse
Disables the input.
idstring?—
Native input id.
optionSnippet<[tag]>—
Custom suggestion renderer; committing applies it, and the dialog edits its prefix text.
optionsstring[]?—
Suggestions offered while typing; the eye applies the list.
palettereadonly string[]?built-in
Per-tag colour classes; replaces the built-in palette.
placeholderstring?—
Placeholder text.
ratiosTagInputRatioOverrides?—
Partial override of the tag-row ratios (font, paddings, gap, and the inner input's vertical padding and caret-line width) plus the shared text-field clear cross (its trimmed button, reserved slot, and gutter); the line box follows the font and the clear inset follows padX.
size'xs' | 'sm' | 'md' | 'lg' | 'xl' | number'md'
Control scale; numbers are icon-scale pixels interpolated between the steps.
valuestring[]?—
Selected tags; the eye applies the list (hiding the readout while off).
chipStyle(tag: string) => string | undefined——Inline style per tag for the chip; the caller owns the colour treatment.
onChange(next: string[]) => void——Called with the new tag list.
onClear() => voidonChange(default)—Clear handler; resets to the default value when omitted.
onQueryChange(query: string) => void——Called on every keystroke; supply externally filtered options.
optionDotStyle(tag: string) => string | undefined——Inline style for the dot before the option label; the dot itself is the component’s.