Select 下拉选择
EwSelect 用自定义菜单替代原生 select 的生硬外观:选中态打勾、禁用项置灰、spring 展开、 点击外部自动收起。bare 嵌入形态用于 EwSearchBox 等复合控件内部。
基础用法
标准形态
点击展开菜单;选中项标主色并对勾标记。
当前:sh
vue
<EwSelect
v-model="city"
:options="[
{ label: '北京', value: 'bj' },
{ label: '上海', value: 'sh' },
]"
placeholder="选择城市"
/>带图标与尺寸
选项图标 / small / large
vue
<EwSelect v-model="scene" size="small" :options="withIcons" />在搜索栏中嵌入
bare 形态去边框与最小宽度,专为复合控件准备 —— EwSearchBox 的分类下拉就是它。
API
Props
| 属性 | 说明 | 类型 | 默认值 |
|---|---|---|---|
| v-model | 当前值 | string / number | '' |
| default-value | 非受控模式的初始值(未绑定 v-model 时生效) | string / number | — |
| options | 选项 [{ label, value, icon?, disabled? }] | array | [] |
| placeholder | 占位文案 | string | '请选择' |
| bare | 嵌入形态(去边框) | boolean | false |
| placement | 菜单方向 | 'bottom' | 'top' | 'bottom' |
| disabled / error | 状态 | boolean | false |
| size | 尺寸 | 'small' | 'default' | 'large' | 'default' |
事件
| 事件 | 说明 | 参数 |
|---|---|---|
| update:modelValue | 选择后派发 | value |
| change | 选择后派发 | value |
| visible-change | 菜单展开/收起 | boolean |