更新记录

1.0.4(2025-06-23) 下载此版本

更新日志

修改自动下载组件

1.0.3(2025-06-23) 下载此版本

更新日志

自动下载到uni_modules文件夹下面

1.0.2(2025-06-23) 下载此版本

更新日志

[1.0.2] - 2025-06-23

✨ 修改

查看更多

平台兼容性

uni-app(4.03)

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

uni-app x(4.03)

Chrome Safari Android iOS 鸿蒙 微信小程序
- - - - - -

其他

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

级联下拉选择器

一个功能强大的 uni-app 级联下拉选择组件,支持多级联动、多选、自动展开等功能。

✨ 特性

  • 🎯 支持多级级联选择
  • ✅ 支持多选模式
  • 🔄 自动展开子级选项
  • 📱 适配所有 uni-app 平台
  • 🎨 美观的 UI 设计
  • ⚡ Vue2/Vue3 兼容

📦 安装

  1. 在 uni-app 项目中,通过插件市场导入
  2. 或直接将组件文件复制到项目中

🎯 组件注册方式

方式 1:自动注册(推荐) 安装插件后,组件会自动注册,可直接使用:

<template>
  <view>
    <Xyy-cascade-dropdown :options="cascadeOptions" v-model="selectedValue" />
  </view>
</template>

方式 2:手动注册

<script>
import XyyCascadeDropdown from "@/uni_modules/Xyy-cascade-dropdown/components/Xyy-cascade-dropdown/Xyy-cascade-dropdown.vue";

export default {
  components: {
    XyyCascadeDropdown,
  },
};
</script>

🚀 快速开始

<template>
  <view>
    <Xyy-cascade-dropdown
      :options="cascadeOptions"
      v-model="selectedValue"
      @change="ionChange"
    />
  </view>
</template>

<script>
export default {
  data() {
    return {
      selectedValue: "",
      cascadeOptions: [
        {
          label: "一级选项1",
          value: "1",
          children: [
            {
              label: "二级选项1-1",
              value: "1-1",
              children: [{ label: "三级选项1-1-1", value: "1-1-1" }],
            },
          ],
        },
      ],
    };
  },
  methods: {
    ionChange(value) {
      console.log("选中值:", value);
    },
  },
};
</script>

📋 API

Props

参数 类型 默认值 说明
options Array [] 级联选项数据
value Array/String [] 绑定值

Events

事件名 说明 参数
change 选择变化时触发 (value)
input v-model 绑定 (value)
itemsChange 选中项变化 (items)

🔧 数据格式

const options = [
  {
    label: "显示文本",
    value: "选项值",
    children: [
      // 子级选项...
    ],
  },
];

📱 兼容性

  • ✅ App 端
  • ✅ H5 端
  • ✅ 小程序端
  • ✅ Vue2/Vue3

🤝 贡献

欢迎提交 Issues 和 Pull Requests!

📄 许可证

MIT License

隐私、权限声明

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

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

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

许可协议

MIT协议

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