更新记录

1.0.0(2026-01-20) 下载此版本

支持多选功能 支持选项禁用 支持自定义显示值 支持搜索 支持多选时将选中值按文字形式展示 监听搜索输入事件


平台兼容性

uni-app(3.6.18)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
- - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
- - -

其他

多语言 暗黑模式 宽屏模式
× ×

mxl-selectDown 下拉选择器组件

支持多选功能 支持选项禁用 支持自定义显示值 支持搜索 支持多选时将选中值按文字形式展示 监听搜索输入事件

先使用前需要安装uni-icons 地址:(https://uniapp.dcloud.net.cn/component/uniui/uni-icons.html)

属性名 类型 默认值 说明
v-model String、Array、Number - 选中项绑定值
multiple Boolean false 是否多选
disabled Boolean false 是否禁用
dataKey String "key" 作为 key 唯一标识的键名
dataValue String "value" 作为 value 唯一标识的键名
filterable Boolean false 是否开启搜索
collapseTags Boolean false 多选时是否将选中值按文字的形式展示
collapseTagsNum Number 1 多选时选中值按文字的形式展示的数量
localdata Array - 下拉列表本地数据
label String - 左侧标题
placeholder String "请选择" 输入框的提示文字
emptyTips String "无选项" 无选项提示
clear Boolean true 是否清空
outFilterable Boolean false 是否开启远程搜索
format String - 格式化输出 用法 field="_id as value, version as text, uni_platform as label" format="{label} - {text}"
@inputChange event event(String) 搜索输入事件
@change event event(String) 选中发生变化触发事件
<template>
    <mxl-selectDown
        :localdata="userList"
        v-model='userId'
        dataValue="userId"
        dataKey="userName"
        placeholder="请选择城市"
        @change="onChange"
        @inputChange='handleRemoteSearch'
    />
</template>
data() {
            return {
                userId:null,
                userList:[{
                    userName:'北京',
                    userId:1
                },{
                    userName:'上海2',
                    userId:2
                },{
                    userName:'天津',
                    userId:3
                }],
            }

        },
methods: {
    // 搜索事件
    handleRemoteSearch(){
        // 后台接口
    },
    // 单选变化事件
    onChange(e) {
        console.log('单选选择变化:', e);
    },
}

隐私、权限声明

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

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

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

许可协议

MIT协议

暂无用户评论。