Selector Props

Name	Type	Default	Description
modelValue	string | number | null	null	Selected value.
options	SelectorOption[]	Required	Options. An action on any item latches the popup into a two-column grid. Activating the action does not change the selection.
placeholder	string	Select… / 请选择	Placeholder text. English by default; Chinese when zh-CN is provided.
searchable	boolean	false	Whether to support search.
clearable	boolean	false	Whether clearable.
hasClear	boolean	false	Shows a clear button when a value is selected. The clear also passes null to change. clearable is the older name; either one turns it on.
disabled	boolean	false	Whether disabled.
disabledMessage	string	—	Why the field is disabled. With disabled, hovering or keyboard focus shows a tooltip and the trigger stays focusable through aria-disabled; it still cannot open the list. Do not wrap a disabled selector in a tooltip: it would swallow the hover. disabledReason is the older name.
size	'sm' | 'md' | 'lg'	'md'	Size.
variant	'input' | 'secondary' | 'ghost' | 'default'	'default'	input and the older name default are the bordered field. secondary matches a secondary button. ghost is borderless. On the latter two, an attached status becomes detached.
isLabelHidden	boolean	false	Hides the label visually. The accessible name stays.
containerClass / containerStyle	class / style	—	Styles for the field shell. They do not land on the trigger button.
controlClass / controlStyle	class / style	—	Styles for the bordered box. A class or style on the component root lands here too.
status	'default' | 'error' | 'warning' | 'success'	'default'	Status.
label	string	—	Visible label. Without it, the placeholder is the hidden accessible name.
description	string	—	Help text under the label.
isReadOnly	boolean	false	Read-only. The value stays, can be focused and submitted, and cannot be opened or cleared. It does not dim. Disabled wins when both are set.
isLoading	boolean	false	Shows a spinner in the trigger. The empty state stays hidden until loading finishes.
isOptional	boolean	false	Marks the label as optional.
isRequired	boolean	false	Marks the label as required and sets aria-required.
indicatorPosition	'start' | 'end'	'end'	Which edge of the option holds the selection mark. An unchosen check takes no space. After the theme maps that mark to a circle, an unchosen row draws the empty circle too.
emptyText	string	No matches / 无匹配项	Shown when the catalog itself is empty.
emptySearchText	string	No results found / 未找到结果	Shown when a search matches nothing.

Selector Emits

Name	Parameters	Description
update:modelValue	value: string | number | null	Emitted when value changes.
change	value: string | number | null	Emitted when value changes.
search	query: string	Emitted when search input changes.
click	event: MouseEvent	Emitted for a click on the trigger, before the list toggles. preventDefault() does not keep it closed.
focus	event: FocusEvent	Emitted when the trigger takes focus.
keydown	event: KeyboardEvent	Emitted for keys on the trigger that the built-in keyboard model leaves alone. Keys it handles and cancels are not emitted.

Selector Slots

Name	Parameters	Description
selected	{ option: SelectorOption | null }	Customize selected item display.
option	{ option: SelectorOption, isActive: boolean, isSelected: boolean }	Customize option display.
empty	—	Customize empty state.