Skip to content
双端兼容 · 桌面 + 移动

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嵌入形态(去边框)booleanfalse
placement菜单方向'bottom' | 'top''bottom'
disabled / error状态booleanfalse
size尺寸'small' | 'default' | 'large''default'

事件

事件说明参数
update:modelValue选择后派发value
change选择后派发value
visible-change菜单展开/收起boolean

基于 MIT 许可证发布