Skip to content

Select 选择器

下拉选择器,用于从一组选项中选择一个。

基础用法

基本使用。

vue
<template>
  <ImSelect :options="options" v-model="val" />
</template>

<script setup>
import { ref } from 'vue';
const val = ref('');
const options = new Array(4)
  .fill()
  .map((_, index) => ({ value: `${index}`, label: `Item ${index} ` }));
</script>

设置宽度

设置 width 为一个 css 样式值或者数字,单位默认为 px。

选择试试

设置尺寸

设置 size 为数字,默认为 36。

多选模式

设置 multiple 为 true,开启多选模式。

选择多个试试

设置 maxTag 最多显示的选项数量,默认为 1。

禁用状态

设置 disabled 为 true,禁用选择器。

清空选中

设置 clearable 为 true,开启清空选中功能。

隐藏箭头

设置 arrow 为 false,隐藏下拉箭头。

滚动关闭

设置 scrollClose 属性为 true,即可实现

API

字段名类型描述
modelValuestring | number绑定的值
optionsArray<{ label: string | number; value: string | number; disabled?: boolean } >选项列表,每个选项包含标签、值和是否禁用的状态
widthstring | number下拉框宽度
sizestring | number下拉框大小
placeholderstring占位符文本
clearableboolean是否可清除内容,默认为false
zIndexnumber设置组件的z-index值
multipleboolean是否允许多选,默认为false
disabledboolean是否禁用,默认为false
maxTagnumber最多显示的标签数量
arrowboolean是否显示箭头,默认为true
offsetnumber箭头偏移量
scrollCloseboolean滚动时是否关闭下拉菜单,默认为false
emptyTextstring无选项时的提示文本

基于 MIT 协议发布