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
| 字段名 | 类型 | 描述 |
|---|---|---|
| modelValue | string | number | 绑定的值 |
| options | Array<{ label: string | number; value: string | number; disabled?: boolean } > | 选项列表,每个选项包含标签、值和是否禁用的状态 |
| width | string | number | 下拉框宽度 |
| size | string | number | 下拉框大小 |
| placeholder | string | 占位符文本 |
| clearable | boolean | 是否可清除内容,默认为false |
| zIndex | number | 设置组件的z-index值 |
| multiple | boolean | 是否允许多选,默认为false |
| disabled | boolean | 是否禁用,默认为false |
| maxTag | number | 最多显示的标签数量 |
| arrow | boolean | 是否显示箭头,默认为true |
| offset | number | 箭头偏移量 |
| scrollClose | boolean | 滚动时是否关闭下拉菜单,默认为false |
| emptyText | string | 无选项时的提示文本 |