更新记录

1.0.1(2024-12-06) 下载此版本

  • 新增 搜索功能,支持输入关键词筛选选项

1.0.0(2024-12-05) 下载此版本

  • 新增 基础选择器功能
  • 新增 默认值支持
  • 新增 可清除功能
  • 新增 禁用选项和禁用状态
  • 新增 样式定制功能,支持自定义高度、颜色等
  • 新增 暗黑模式适配

平台兼容性

Vue2 Vue3
App 快应用 微信小程序 支付宝小程序 百度小程序 字节小程序 QQ小程序
HBuilderX 3.1.0 app-vue
钉钉小程序 快手小程序 飞书小程序 京东小程序
H5-Safari Android Browser 微信浏览器(Android) QQ浏览器(Android) Chrome IE Edge Firefox PC-Safari
×

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>

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问