更新记录

1.0.6(2025-05-12) 下载此版本

修复选中数据或者清除数据的时候下拉打开的定位问题

1.0.5(2025-05-12) 下载此版本

修复点击清除按钮没有更新的问题

1.0.4(2025-04-28) 下载此版本

修复禁用后输入框右侧icon图标依旧会存在且可以点击的问题

查看更多

平台兼容性

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

cl-select

说明

该组件是根据uni-easyinput和scroll-view组件封装的下拉组件,组件样式与uni-select保持一致。

  • 支持对象数组/基础类型数组的选项格式
  • 输入时实时过滤选项
  • 选中项自动回显
  • 可自定义空状态提示
  • 支持双向数据绑定
  • 可以与uni-form组件搭配使用

Props 属性

属性名 类型 默认值 说明
options Array [] 必填,选项数组(支持对象格式{label,value}或基础类型)
labelField String 'label' 选项显示文本字段名
valueField String 'value' 选项值字段名
modelValue [String, Number] - 选中的值,使用v-model双向绑定
placeholder String '请选择' 未选择时的占位文本
maxHeight [String, Number] 300 下拉列表最大高度(单位:px)
placeholderStyle String '' 自定义占位符样式(支持CSS字符串)
disabled Boolean false 是否禁用输入框
maxlength Number 20 最大输入长度
trim String 'both' 同uni-easyinput
hideBorder Boolean false 是否隐藏输入框边框
cursorSpacing Number 0 键盘弹起时光标距离输入框的高度(单位:px)
emptyText String '暂无数据' 无匹配数据时的提示文本

方法列表

方法名 说明 参数
clear 点击清除图标 -
focus 输入框聚焦 -
blur 输入框失焦 -
selected 选中数据 valueFiled(选中数据的valueFiled值),data(选中数据的整个对象)
input 输入内容改变 text(输入框内容) -

插槽说明

插槽名 说明
empty 自定义空状态显示内容

使用方式

<template>
    <view class="content">
        <cl-select :options="options" v-model="value"></cl-select>
        选中的值:{{value}}
    </view>
</template>
<script setup>
    import {
        ref
    } from 'vue'
    const value = ref()
    const options = Array.from({length: 100}, (_, index) => {
        return {
            label: `我是展示的值${index}`,
            value: `我是选中的值${index}`
        }
    })
</script>
<style scoped>
    .content {
        padding: 30px;
    }
</style>

若有问题可联系作者:微信号:fjl_code_life

隐私、权限声明

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

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

插件不采集任何数据

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

许可协议

MIT协议

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