更新记录
0.1.2(2025-05-29) 下载此版本
优化插件报错的问题
0.1.1(2025-05-26) 下载此版本
增加是否筛选配置; 增加清空选项; 修复输入值绑定问题;
0.1.0(2025-05-07) 下载此版本
2025-05-07
- 新增输入候选词选择组件
平台兼容性
uni-app
Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
---|---|---|---|---|---|---|---|---|
√ | √ | - | - | - | - | - | - | - |
微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
---|---|---|---|---|---|---|---|---|---|---|
√ | - | - | - | - | - | - | - | - | - | - |
u-input-select 输入选择组件
介绍
u-input-select
是一个结合了输入框和下拉选择功能的组件,支持输入搜索和下拉选择,适用于需要快速选择或搜索选项的场景。
特性
- 支持输入搜索过滤
- 支持下拉选择
- 支持键盘输入
- 自动过滤匹配选项
- 选中项高亮显示
- 空数据提示
属性说明
属性名 | 类型 | 默认值 | 说明 |
---|---|---|---|
options | Array | [] | 选项数组,格式为[{label: '显示文本', value: '实际值'}] |
placeholder | String | '请输入' | 输入框占位文本 |
value | String/Number | '' | 默认选中值 |
clearable | Boolean | false | 是否可清空 |
事件说明
事件名 | 说明 | 回调参数 |
---|---|---|
input | 输入时触发 | value: 输入值 |
change | 选择改变时触发 | item: 选中项对象 |
基础用法
<template>
<u-input-select
v-model="selectedValue"
:options="options"
placeholder="请选择"
@change="onChange"
/>
</template>
<script>
export default {
data() {
return {
selectedValue: '',
options: [
{ label: '选项1', value: '1' },
{ label: '选项2', value: '2' }
]
}
},
methods: {
onChange(item) {
console.log('选中项:', item)
}
}
}
</script>
样式说明
组件采用了响应式设计,主要样式特点:
- 输入框高度40px,带有边框和圆角
- 下拉框最大高度200px,超出部分可滚动
- 选中项和悬停项有特殊的背景色标识
- 带有下拉箭头图标,点击时有旋转动画
- 支持暗色主题
注意事项
- options数组中的对象必须包含label和value属性
- 组件会自动处理失焦事件,延迟200ms关闭下拉框
- 支持键盘输入和鼠标点击两种操作方式
- 组件内部会自动处理大小写敏感的过滤逻辑
贡献
如果您在使用过程中发现任何问题,欢迎提出建议或贡献代码。