InputSelect 输入选择器
既可以从预设选项中选择,也允许自由输入(按 Enter 确认),支持单选和多选,适用于标签输入、自定义值选择等场景。
何时使用
- 需要输入与下拉选择结合(既可输入又可选择)时。
基础用法
支持字符串数组或 { label, value } 对象数组作为选项。
字符串数组选项
直接传入字符串数组作为选项。
多选
设置 multiple 开启多选模式,绑定值为数组。
自定义输入
在输入框中输入不在选项中的值,按 Enter 确认。通过 empty-text 自定义无匹配项时的提示。
禁用
设置 disabled 禁用组件。
导入
Props
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | T | T[] | - | 当前值(v-model) |
options | (string | { label, value })[] | [] | 选项列表 |
placeholder | string | 选择或输入... | 占位文字 |
emptyText | string | 无匹配项,按 Enter 确认输入 | 无匹配时提示 |
multiple | boolean | false | 多选 |
disabled | boolean | false | 禁用 |
class | string | - | 附加类名 |
Events
| 事件 | 说明 | 回调参数 |
|---|---|---|
update:modelValue | 值变化 | (value: T | T[]) |
国际化
placeholder、emptyText、搜索框占位等文案默认跟随全局语言(zh-CN / zh-TW / en-US),传 prop 可覆盖。
