Tokenizer Props

Name	Type	Default	Description
modelValue	T[]	[]	Selected items.
searchSource	SearchSource<T>	Required	Static or async source.
label	string	Required	Field label.
description	string	—	Helper text under the label.
labelTooltip	string	—	Tooltip text on an info icon next to the label.
isLabelHidden	boolean	false	Hides the label visually while keeping it accessible. labelHidden is the older name; either one hides it.
containerClass / controlClass	class	—	Field shell and input box. A root class lands on the box, not the native input. Item actions behave like Typeahead.
placeholder	string	Add… / 添加…	Input placeholder. Shown only while no tokens are selected.
hasCreate	boolean	false	Let users turn free text into a new token. A "Create …" row appears for text that matches nothing else, and the change type is create.
creatable	boolean	false	Legacy name for hasCreate. Either one turns it on.
overflow	'none' | 'unfocused-inline' | 'unfocused-layer'	'none'	Whether blur collapses the tokens to one line with +N.
maxEntries	number	—	Maximum number of tokens. The input becomes read-only at the limit.
debounceMs	number	150	Wait after typing before searching.
minQueryLength	number	1	Shortest query that gets searched, counted in visible characters. Below it nothing is searched and the menu stays closed — unless hasCreate is on, because a "Create …" row comes from the typed text and costs no search.
hasEntriesOnFocus	boolean	false	Show results on focus before the user types.
showOnFocus	boolean	false	Legacy name for hasEntriesOnFocus. Either one turns it on.
hasAutoFocus	boolean	false	Focus the input on mount.
menuWidth	number	—	Requested dropdown width in pixels. Never narrower than the field, and clamped to the viewport.
maxMenuItems	number	10	Maximum number of results in the menu. A "Create …" row is offered on top of them.
hasClear	boolean	false	Show a clear-all button that removes every token.
clearable	boolean	false	Legacy name for hasClear. Either one turns it on.
emptySearchText	string | null	'No results found' / '未找到结果'	Text shown when the query matched nothing. null means "not given" and falls through to the default; an empty string renders nothing. For rich content use the empty slot.
emptyText	string | null	—	Legacy name for emptySearchText.
disabled	boolean	false	Disable the field and every token interaction.
disabledMessage	string	—	Explains why the field is disabled. With disabled, the input stays focusable through aria-disabled and readonly, and the message shows as a tooltip on hover or keyboard focus.
disabledReason	string	—	Legacy name for disabledMessage.
status	'default' | 'success' | 'warning' | 'error'	'default'	Status style.
statusMessage	string	—	Status text under the field.
size	'sm' | 'md' | 'lg'	'md'	Input and token size.
required	boolean	false	Marks the field as required.
optional	boolean	false	Shows an optional indicator on the label.
name	string	—	Form field name. Each selected id is submitted once.
width	number | string	—	Width of the whole field (number = pixels, string used as-is).

Tokenizer Emits

Name	Parameters	Description
update:modelValue	value: T[]	Emitted when the selected items change.
change	value: T[], change: TokenizerChange	Includes the change type: add, create, remove, or clear.
changeQuery	query: string	Emitted when the query text changes.
search	query: string	Legacy name for changeQuery. Both fire.
openChange	isOpen: boolean	Emitted when the menu opens or closes.
focus	event: FocusEvent	Emitted when focus enters the field from outside.
blur	event: FocusEvent	Emitted when focus leaves the whole field, not just the input.

Tokenizer Slots

Name	Parameters	Description
icon	—	Icon at the start of the field, before any token.
end	—	Content at the end of the field, such as a button or a result count.
token	{ item, remove }	Custom selected token. Replaces the default Token.
item	{ item, isActive, isSelected }	Custom menu row. Replaces the default TypeaheadItem.
empty	—	Custom empty state.

Native attributes and listeners that are not listed above land on the input element, so @keydown, @paste and aria-* work as they would on a plain <input>. A keydown listener runs before the internal token navigation; call event.preventDefault() to skip it.