Files
pengxiaolong 0b9353de84 弹窗
2025-05-21 17:03:19 +08:00

2.4 KiB

wht-select 选择器组件

介绍

一个简单易用的下拉选择器组件,支持丰富的样式定制。

使用方法

<template>
	<wht-select v-model="value" :options="options" placeholder="请选择" />
</template>
<script>
export default {
	data() {
		return {
			value: '',
			options: [
				{ label: '选项一', value: '1' },
				{ label: '选项二', value: '2' },
				{ label: '选项三', value: '3' }
			]
		}
	}
}
</script>

Props 属性说明

参数 说明 类型 默认值
value/v-model 绑定值 string/number -
options 选项数据 array []
placeholder 占位符 string '请选择'
disabled 是否禁用 boolean false
clearable 是否可清除 boolean false
height 选择器高度 number 40
fontSize 字体大小 number 14
borderColor 边框颜色 string '#dcdfe6'
borderRadius 圆角大小 number 4
backgroundColor 背景颜色 string '#ffffff'
textColor 文字颜色 string '#606266'
placeholderColor 占位符颜色 string '#c0c4cc'
activeColor 激活状态颜色 string '#409eff'
filterable 是否开启搜索功能 Boolean false

Events 事件说明

事件名 说明 回调参数
change 选中值发生变化时触发 目前选中的值
clear 点击清除按钮时触发 -
search 搜索输入时触发 (query: string) 搜索关键词

Options 数据结构

{
  label: string,  // 显示的文本
  value: string/number,  // 选项的值
  disabled?: boolean  // 是否禁用该选项
}

代码示例

基础用法

<template>
	<wht-select v-model="value" :options="options" placeholder="请选择" />
</template>
<script>
export default {
	data() {
		return {
			value: '',
			options: [
				{ label: '选项一', value: '1' },
				{ label: '选项二', value: '2' },
				{ label: '选项三', value: '3' }
			]
		}
	}
}
</script>

可搜索

<template>
	<wht-select v-model="value" :options="options" placeholder="请选择" filterable />
</template>
<script>
export default {
	data() {
		return {
			value: '',
			options: [
				{ label: '选项一', value: '1' },
				{ label: '选项二', value: '2' },
				{ label: '选项三', value: '3' }
			]
		}
	}
}
</script>