Combobox
纯组合输入控件。内置关键字过滤(noFilter 可关)、多选(multiple)、自定义值(allowCustom)、加载态(loading)与异步搜索(v-model:search);标签、提示和校验统一交给 XField。
基础
基础
当前值:未选择
API
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
options | SelectOption[] | undefined | undefined | — |
items | (string | Record<string, unknown> | SelectOption)[] | undefined | undefined | — |
itemTitle | string | undefined | "label" | — |
itemValue | string | undefined | "value" | — |
placeholder | string | undefined | undefined | — |
disabled | boolean | undefined | false | — |
clearable | boolean | undefined | false | — |
multiple | boolean | undefined | false | — |
loading | boolean | undefined | false | — |
noFilter | boolean | undefined | false | — |
allowCustom | boolean | undefined | false | — |
size | "mini" | "small" | "medium" | "large" | "super" | undefined | undefined | 尺寸:mini / small / medium(默认) / large / super;不传则跟随环境 data-size |
modelValue | SelectValue | SelectValue[] | — | — |
search | string | undefined | "" | — |
Emits
| 事件 | 载荷 | 说明 |
|---|---|---|
update:modelValue | [value: SelectValue | SelectValue[]] | — |
update:search | [value: string] | — |
Slots
| 插槽 | 说明 |
|---|---|
empty | — |