项目正在快速迭代中,API 与视觉细节可能随版本调整,请勿用于生产环境。开发迭代中,请勿用于生产环境。
Skip to content
双端兼容 · 桌面 + 移动

Select 下拉选择 ​

EvSelect 用自定义菜单替代原生 select 的生硬外观:选中态打勾、禁用项置灰、spring 展开、 点击外部自动收起。bare 嵌入形态用于 EvSearchBox 等复合控件内部。

基础用法 ​

标准形态
点击展开菜单;选中项标主色并对勾标记。

当前:sh

vue
<EvSelect
  v-model="city"
  :options="[
    { label: '北京', value: 'bj' },
    { label: '上海', value: 'sh' },
  ]"
  placeholder="选择城市"
/>

带图标与尺寸 ​

选项图标 / small / large
vue
<EvSelect v-model="scene" size="small" :options="withIcons" />

在搜索栏中嵌入

bare 形态去边框与最小宽度,专为复合控件准备 —— EvSearchBox 的分类下拉就是它。

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'
glass下拉面板磨砂;缺省跟随全局(ConfigProvider glass)boolean—
blur磨砂强度(px),内联覆盖 --ev-glass-blurstring / number—
saturate磨砂饱和度(倍数),内联覆盖 --ev-glass-saturatestring / number—
tint磨砂底色浓度(%),内联覆盖 --ev-glass-bgstring / number—

事件 ​

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

基于 MIT 许可证发布