更新记录
1.0.5(2025-06-12) 下载此版本
更新文档
1.0.4(2025-06-11) 下载此版本
无
1.0.3(2025-06-11) 下载此版本
查看更多平台兼容性
uni-app
Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
---|---|---|---|---|---|---|---|---|
√ | √ | √ | √ | √ | - | - | - | - |
微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
---|---|---|---|---|---|---|---|---|---|---|
- | - | - | - | - | - | - | - | - | - | - |
其他
多语言 | 暗黑模式 | 宽屏模式 |
---|---|---|
× | × | √ |
下拉搜索选择框
一个功能强大的UniApp下拉选择框组件,支持搜索、单选、多选和数据回显功能。同时支持Vue2和Vue3框架。
安装
方式一:插件市场安装
在插件市场中搜索"下拉搜索选择框",点击安装即可。
方式二:导入示例项目
- 在HBuilderX中选择"文件" -> "新建" -> "项目"
- 选择"uni-app" -> "从模板创建"
- 搜索"下拉搜索选择框示例项目"
- 点击"创建"即可导入完整的示例项目
方式三:查看内置示例
安装插件后,可以查看示例页面:pages/demo/demo.vue
使用方式
<template>
<view>
<!-- 基础用法 -->
<cuihai-select-search
:options="options"
v-model="value"
placeholder="请选择"
@change="onChange"
/>
<!-- 多选模式 -->
<cuihai-select-search
:options="options"
v-model="multipleValue"
multiple
placeholder="请选择多个"
@change="onMultipleChange"
/>
</view>
</template>
<script>
export default {
data() {
return {
value: '',
multipleValue: [],
options: [
{ value: '1', label: '选项1' },
{ value: '2', label: '选项2' },
{ value: '3', label: '选项3' }
]
}
},
methods: {
onChange(value, option) {
console.log('选择变化:', value, option)
},
onMultipleChange(values, options) {
console.log('多选变化:', values, options)
}
}
}
</script>
属性说明
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
options | Array | [] | 选项数据数组 |
value | String/Number/Array | null | 当前选中值 |
multiple | Boolean | false | 是否多选 |
searchable | Boolean | true | 是否可搜索 |
placeholder | String | '请选择' | 占位符文本 |
searchPlaceholder | String | '请选择' | 搜索占位符 |
disabled | Boolean | false | 是否禁用 |
maxHeight | String | 300rpx | 下拉框最大高度 |
emptyText | String | 暂无数据 | 空数据提示 |
valueKey | String | value | 选项值字段名 |
labelKey | String | label | 选项标签字段名 |
showConfirmButton | Boolean | false | 多选模式是否显示确认按钮 |
autoClose | Boolean | true | 是否自动关闭下拉框(单选模式) |
事件说明
事件名 | 说明 | 参数 |
---|---|---|
change | 选择变化时触发 | (value, option) 或 (values, options) |
input | 值变化时触发 | value 或 values |
数据格式
[
{ value: '1', label: '选项1' },
{ value: '2', label: '选项2' },
{ value: '3', label: '选项3' }
]
版本说明
- 1.0.2:Vue3支持版本,同时兼容Vue2和Vue3框架
- 1.0.1:修复版本,解决样式和配置问题
- 1.0.0:初始版本,支持基础的单选、多选、搜索功能
注意事项
- 组件同时支持Vue2和Vue3框架,自动适配项目Vue版本
- 兼容所有uni-app支持的平台(H5、小程序、App等)
- 使用时需要确保options数据格式正确
- 项目会根据manifest.json中的vueVersion自动选择对应的初始化方式