Vue2选择器(Select)
可自定义设置以下属性:
选项数据(options),类型:Array<Option>,默认值 [],其中Option类型:{label?: string, value?: any, disabled?: boolean, [propName: string]: any}
选择器字典项的文本字段名(label),类型:string,默认 'label'
选择器字典项的值字段名(value),类型:string,默认 'value'
选择框默认文字(placeholder),类型:string,默认 '请选择'
是否禁用下拉(disabled),类型:boolean,默认 false
是否支持清除(allowClear),类型:boolean,默认false
是否支持搜索(search),类型:boolean,默认 false
过滤条件函数(filter),类型:Function|true,默认 true,仅当支持搜索时生效,根据输入项进行筛选,默认为 true 时,筛选每个选项的文本字段 label 是否包含输入项,包含返回 true,反之返回 false;当其为函数 Function 时,接受 inputValue option 两个参数,当 option 符合筛选条件时,应返回 true,反之则返回 false
选择框宽度(width),类型:number,默认200px
选择框高度(height),类型:number,默认36px
下拉面板最多能展示的下拉项数,超过后滚动显示(maxDisplay),类型:number,默认 6
当前选中的option条目(v-model:modelValue),类型:number|string|null,默认 null
效果如下图:在线预览
展开图:
支持搜索:
其中引入使用了 Vue3空状态(Empty)
①创建选择器组件Select.vue:
<script setup lang="ts">
import { ref, watchEffect, watch } from 'vue'
import Empty from '../empty'
interface Option {
label?: string // 选项值
value?: string|number // 选项名
disabled?: boolean // 是否禁用选项
[propName: string]: any // 添加一个字符串索引签名,用于包含带有任意数量的其他属性
}
interface Props {
options?: Option[] // 选项数据
label?: string // 字典项的文本字段名
value?: string // 字典项的值字段名
placeholder?: string // 默认文本
disabled?: boolean // 是否禁用
allowClear?: boolean // 是否支持清除
search?: boolean // 是否支持搜索
/*
根据输入项进行筛选,默认为 true 时,筛选每个选项的文本字段 label 是否包含输入项,包含返回 true,反之返回 false
当其为函数 Function 时,接受 inputValue option 两个参数,当 option 符合筛选条件时,应返回 true,反之则返回 false
*/
filter?: Function|true // 过滤条件函数,仅当支持搜索时生效
width?: number // 宽度
height?: number // 高度
maxDisplay?: number // 下拉面板最多能展示的下拉项数,超过后滚动显示
modelValue?: number|string|null // (v-model)当前选中的option条目
}
const props = withDefaults(defineProps<Props>(), {
options: () => [],
label: 'label',
value: 'value',
placeholder: '请选择',
disabled: false,
search: false,
allowClear: false,
filter: true,
width: 120,
height: 32,
maxDisplay: 6,
modelValue: null
})
const filterOptions = ref<Option[]>()
const selectedName = ref()
const inputValue = ref()
const hoverValue = ref() // 鼠标悬浮项的value值
const showOptions = ref(false) // options面板
const activeBlur = ref(true) // 是否激活blur事件
const showArrow = ref(true) // 剪头图标显隐
const showClear = ref(false) // 清除图标显隐
const showSearch = ref(false) // 搜索图标显隐
const selectRef = ref()
watchEffect(() => {
if (props.search) {
filterOptions.value = props.options.filter(option => {
if (typeof props.filter === 'function') {
return props.filter(inputValue.value, option)
} else {
return option[props.label].includes(inputValue.value)
}
})
if (filterOptions.value.length && inputValue.value) {
hoverValue.value = filterOptions.value[0][props.value]
} else {
hoverValue.value = null
}
} else {
filterOptions.value = props.options
}
})
watchEffect(() =>{ // 回调立即执行一次,同时会自动跟踪回调中所依赖的所有响应式依赖
initSelector()
})
watch(showOptions, (to) => {
if (!to && props.search) {
inputValue.value = selectedName.value
}
})
function initSelector () {
if (props.modelValue) {
const target = props.options.find(option => option[props.value] === props.modelValue)
if (target) {
selectedName.value = target[props.label]
hoverValue.value = target[props.value]
} else {
selectedName.value = props.modelValue
hoverValue.value = null
}
} else {
selectedName.value = null
hoverValue.value = null
}
if (props.search) {
inputValue.value = selectedName.value
}
}
function onBlur () {
if (showOptions.value) {
showOptions.value = false
}
if (props.search) {
showSearch.value = false
showArrow.value = true
}
}
function onInputEnter () {
if (props.allowClear && selectedName.value) {
showArrow.value = false
showClear.value = true
if (props.search) {
showSearch.value = false
}
}
}
function onInputLeave () {
if (props.allowClear && showClear.value) {
showClear.value = false
if (!props.search) {
showArrow.value = true
}
}
if (props.search) {
if (showOptions.value) {
showSearch.value = true
showArrow.value = false
selectRef.value.focus()
} else {
showSearch.value = false
showArrow.value = true
}
}
}
function onHover (value: string|number) {
hoverValue.value = value
}
function onEnter () {
activeBlur.value = false
}
function onLeave () {
hoverValue.value = null
activeBlur.value = true
selectRef.value.focus()
}
function openSelect () {
showOptions.value = !showOptions.value
inputValue.value = ''
if (!hoverValue.value && selectedName.value) {
const target = props.options.find(option => option[props.label] === selectedName.value)
hoverValue.value = target ? target[props.value] : null
}
if (props.search) {
if (!showClear.value) {
showArrow.value = !showOptions.value
showSearch.value = showOptions.value
}
}
}
const emits = defineEmits(['update:modelValue', 'change'])
function onClear () {
showClear.value = false
selectedName.value = null
hoverValue.value = null
showOptions.value = false
showArrow.value = true
emits('update:modelValue')
emits('change')
}
function onChange (value: string|number, label: string, index: number) { // 选中下拉项后的回调
if (props.modelValue !== value) {
selectedName.value = label
hoverValue.value = value
emits('update:modelValue', value)
emits('change', value, label, index)
}
showOptions.value = false
if (props.search) {
showSearch.value = false
showArrow.value = true
}
}
</script>
<template>
<div class="m-select" :style="`height: ${height}px;`">
<div
:class="['m-select-wrap', {'hover': !disabled, 'focus': showOptions, 'disabled': disabled}]"
:style="`width: ${width}px; height: ${height}px;`"
tabindex="1"
ref="selectRef"
@mouseenter="onInputEnter"
@mouseleave="onInputLeave"
@blur="activeBlur && !disabled ? onBlur() : () => false"
@click="disabled ? () => false : openSelect()">
<div
v-if="!search"
:class="['u-select-input', {'placeholder': !selectedName}]"
:style="`line-height: ${height - 2}px;`"
:title="selectedName"
>{{ selectedName || placeholder }}</div>
<input
v-else
class="u-search"
:style="`line-height: ${height - 2}px;`"
autocomplete="off"
v-model.number.trim="inputValue"
:placeholder="selectedName || placeholder" />
<svg focusable="false" :class="['u-svg', {'show': showSearch}]" data-icon="search" aria-hidden="true" viewBox="64 64 896 896"><path d="M909.6 854.5L649.9 594.8C690.2 542.7 712 479 712 412c0-80.2-31.3-155.4-87.9-212.1-56.6-56.7-132-87.9-212.1-87.9s-155.5 31.3-212.1 87.9C143.2 256.5 112 331.8 112 412c0 80.1 31.3 155.5 87.9 212.1C256.5 680.8 331.8 712 412 712c67 0 130.6-21.8 182.7-62l259.7 259.6a8.2 8.2 0 0011.6 0l43.6-43.5a8.2 8.2 0 000-11.6zM570.4 570.4C528 612.7 471.8 636 412 636s-116-23.3-158.4-65.6C211.3 528 188 471.8 188 412s23.3-116.1 65.6-158.4C296 211.3 352.2 188 412 188s116.1 23.2 158.4 65.6S636 352.2 636 412s-23.3 116.1-65.6 158.4z"></path></svg>
<svg :class="['u-svg', {'rotate': showOptions, 'show': showArrow}]" viewBox="64 64 896 896" data-icon="down" aria-hidden="true" focusable="false"><path d="M884 256h-75c-5.1 0-9.9 2.5-12.9 6.6L512 654.2 227.9 262.6c-3-4.1-7.8-6.6-12.9-6.6h-75c-6.5 0-10.3 7.4-6.5 12.7l352.6 486.1c12.8 17.6 39 17.6 51.7 0l352.6-486.1c3.9-5.3.1-12.7-6.4-12.7z"></path></svg>
<svg @click.stop="onClear" :class="['close', {'show': showClear}]" focusable="false" data-icon="close-circle" aria-hidden="true" viewBox="64 64 896 896"><path d="M512 64C264.6 64 64 264.6 64 512s200.6 448 448 448 448-200.6 448-448S759.4 64 512 64zm165.4 618.2l-66-.3L512 563.4l-99.3 118.4-66.1.3c-4.4 0-8-3.5-8-8 0-1.9.7-3.7 1.9-5.2l130.1-155L340.5 359a8.32 8.32 0 01-1.9-5.2c0-4.4 3.6-8 8-8l66.1.3L512 464.6l99.3-118.4 66-.3c4.4 0 8 3.5 8 8 0 1.9-.7 3.7-1.9 5.2L553.5 514l130 155c1.2 1.5 1.9 3.3 1.9 5.2 0 4.4-3.6 8-8 8z"></path></svg>
</div>
<TransitionGroup name="fade" tag="div">
<div
v-show="showOptions && filterOptions && filterOptions.length"
class="m-options-panel"
@mouseenter="onEnter"
@mouseleave="onLeave"
key="1"
:style="`top: ${height + 4}px; line-height: ${height - 10}px; max-height: ${ maxDisplay * height + 9 }px; width: ${width}px;`">
<p
v-for="(option, index) in filterOptions" :key="index"
:class="['u-option', {'option-hover': !option.disabled&&option[value]===hoverValue, 'option-selected': option[label]===selectedName, 'option-disabled': option.disabled }]"
:title="option[label]"
@mouseenter="onHover(option[value])"
@click="option.disabled ? () => false : onChange(option[value], option[label], index)">
{{ option[label] }}
</p>
</div>
<div
v-show="showOptions && filterOptions && !filterOptions.length"
key="2"
class="m-empty-wrap"
:style="`top: ${height + 4}px; width: ${width}px;`">
<Empty image="2" key="2" />
</div>
</TransitionGroup>
</div>
</template>
<style lang="less" scoped>
.m-select {
position: relative;
display: inline-block;
font-size: 14px;
font-weight: 400;
color: rgba(0, 0, 0, .88);
}
.fade-enter-active, .fade-leave-active {
transform: scaleY(1);
transform-origin: 0% 0%;
opacity: 1;
transition: all .3s;
}
.fade-enter-from {
transform: scaleY(.8);
transform-origin: 0% 0%;
opacity: 0;
}
.fade-leave-to {
transform: scaleY(1);
opacity: 0;
}
.m-select-wrap {
position: relative;
z-index: 8;
display: inline-block;
border: 1px solid #d9d9d9;
border-radius: 6px;
background-color: #FFF;
outline: none;
cursor: pointer;
transition: all .3s cubic-bezier(.645, .045, .355, 1);
.u-select-input {
display: block;
text-align: left;
margin-left: 11px;
margin-right: 27px;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.u-search {
display: inline-block;
margin-left: 11px;
margin-right: 27px;
width: calc(100% - 38px);
text-overflow: ellipsis;
background: transparent;
border: none;
outline: none;
}
input::-webkit-input-placeholder {
color: rgba(0, 0, 0, .25);
}
input:-moz-placeholder {
color: rgba(0, 0, 0, .25);
}
input::-moz-placeholder {
color: rgba(0, 0, 0, .25);
}
input:-ms-input-placeholder {
color: rgba(0, 0, 0, .25);
}
.placeholder {
color: rgba(0, 0, 0, .25);
}
.u-svg {
position: absolute;
top: 0;
bottom: 0;
margin: auto 0;
right: 11px;
width: 12px;
height: 12px;
fill: rgba(0, 0, 0, .25);
opacity: 0;
pointer-events: none;
transition: all .3s ease-in-out;
}
.rotate {
transform: rotate(180deg);
-webkit-transform: rotate(180deg);
}
.close {
.u-svg();
fill: rgba(140, 140, 140, .6);
&:hover {
fill: rgba(100, 100, 100, .8);
}
}
.show {
opacity: 1;
pointer-events: auto;
}
}
.hover { // 悬浮时样式
&:hover {
border-color: @themeColor;
}
}
.focus { // 激活时样式
border-color: @themeColor;
box-shadow: 0 0 0 2px fade(@themeColor, 20%);
}
.disabled { // 下拉禁用样式
color: rgba(0,0,0,.25);
background: #f5f5f5;
user-select: none;
cursor: not-allowed;
}
.m-options-panel {
position: absolute;
z-index: 9;
overflow: auto;
background-color: #FFF;
padding: 4px;
border-radius: 8px;
box-shadow: 0 6px 16px 0 rgba(0, 0, 0, .08), 0 3px 6px -4px rgba(0, 0, 0, .12), 0 9px 28px 8px rgba(0, 0, 0, .05);
.u-option { // 下拉项默认样式
text-align: left;
position: relative;
display: block;
padding: 5px 12px;
border-radius: 4px;
font-weight: 400;
line-height: inherit;
overflow: hidden;
white-space: nowrap;
text-overflow: ellipsis;
cursor: pointer;
transition: background .3s ease;
}
.option-hover { // 悬浮时的下拉项样式
background: rgba(0, 0, 0, .04);
}
.option-selected { // 被选中的下拉项样式
font-weight: 600;
background: #e6f4ff;
}
.option-disabled { // 禁用某个下拉选项时的样式
color: rgba(0, 0, 0, .25);
user-select: none;
cursor: not-allowed;
}
}
.m-empty-wrap {
position: absolute;
z-index: 9;
height: 100px;
border-radius: 8px;
padding: 13px 20px;
background-color: #FFF;
box-shadow: 0 6px 16px 0 rgba(0, 0, 0, .08), 0 3px 6px -4px rgba(0, 0, 0, .12), 0 9px 28px 8px rgba(0, 0, 0, .05);
}
</style>
②在要使用的页面引入:
<script setup lang="ts">
import Select from './Select.vue'
import { ref, watchEffect } from 'vue'
const options = ref([
{
label: '北京市',
value: 1
},
{
label: '上海市',
value: 2,
disabled: true
},
{
label: '纽约市',
value: 3
},
{
label: '旧金山',
value: 4
},
{
label: '布宜诺斯艾利斯',
value: 5
},
{
label: '伊斯坦布尔',
value: 6
},
{
label: '拜占庭',
value: 7
},
{
label: '君士坦丁堡',
value: 8
},
{
label: '墨尔本',
value: 9
}
])
const optionsCustom = ref([
{
name: '北京市',
id: 1
},
{
name: '上海市',
id: 2
},
{
name: '纽约市',
id: 3
},
{
name: '旧金山',
id: 4
},
{
name: '布宜诺斯艾利斯',
id: 5
},
{
name: '伊斯坦布尔',
id: 6
},
{
name: '拜占庭',
id: 7
},
{
name: '君士坦丁堡',
id: 8
}
])
const selectedValue = ref(1)
watchEffect(() => {
console.log('selectedValue:', selectedValue.value)
})
function onChange (value: string|number, label: string, index: number) {
console.log('value:', value)
console.log('label:', label)
console.log('index:', index)
}
// 自定义过滤函数,但选项的 value 值大于 输入项时返回 true
function filter (inputValue: string, option: any) {
return option.value > inputValue
}
function onAntChange (value: string|number, option: any) {
console.log('value:', value)
console.log('option:', option)
}
</script>
<template>
<div>
<h1>Select 选择器</h1>
<h2 class="mt30 mb10">基本使用</h2>
<Select :options="options" v-model="selectedValue" />
<h2 class="mt30 mb10">禁用 (disabled: true)</h2>
<Select
:options="options"
disabled
v-model="selectedValue" />
<h2 class="mt30 mb10">支持清除 (allowClear: true)</h2>
<Select
:options="options"
allow-clear
v-model="selectedValue"
@change="onChange" />
<h2 class="mt30 mb10">支持搜索 (search: true)</h2>
<Select
:options="options"
search
v-model="selectedValue" />
<h2 class="mt30 mb10">自定义搜索过滤函数</h2>
<Select
:options="options"
search
:filter="filter"
v-model="selectedValue" />
<h2 class="mt30 mb10">自定义样式 (width: 160 & height: 36)</h2>
<Select
:width="160"
:height="36"
search
:options="options"
v-model="selectedValue"
@change="onChange" />
<h2 class="mt30 mb10">自定义节点 lable、value 字段名</h2>
<Select
:options="optionsCustom"
label="name"
value="id"
v-model="selectedValue" />
<h2 class="mt30 mb10">自定义下拉面板数</h2>
<Select
:options="options"
:max-display="8"
v-model="selectedValue" />
</div>
</template>