更新记录

2.0.3(2023-07-10)

  • 文档更新

2.0.2(2023-05-15)

  • 修复visible在数据初始化时配置有时失效问题

2.0.1(2023-05-11)

  • 修复父元素下某个子元素设置隐藏时,父子联动状态异常问题
  • 对性能以及代码体积做了进一步优化
查看更多

平台兼容性

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

custom-tree-popup 使用指南

提示: 使用该插件前确保你已经导入 uni-popup uni-icons uni-easyinput 插件。

该插件不支持回显数据,需要回显请使用 custom-tree-select

如果在微信小程序中使用,2023/05/04 之前安装插件或者本地插件版本 <=1.5.5 需要添加,在 main.js 文件中添加以下代码

// #ifdef MP-WEIXIN
Vue.prototype.$bus = new Vue()
// #endif

有问题可以加 QQ 群:297080738(已满),新群:460688316

优势

💪:基于 uni-popup uni-icons uni-easyinput插件进行开发,默认样式与 uni-easyinput 样式对标。

:全面支持懒加载。

:提供更多配置项。

📦:开箱即用。

Props

属性名 类型 默认值 说明
canSelectAll Boolean false 开启一键全选功能
clearResetSearch Boolean false 设置为 true 并且搜索之后,点击输入框清除按钮,会清空搜索内容并且会直接重置整个弹窗内树形选择器内容,默认情况下只有清除之后再次进行查询才会重置选择器
animation Boolean ture 是否开启弹窗动画
is-mask-click Boolean true 点击遮罩关闭弹窗
mask-background-color String rgba(0,0,0,0.4) 蒙版颜色,建议使用 rgba 颜色值
background-color String none 主窗口背景色
safe-area Boolean true 是否适配底部安全区
choseParent Boolean true 父节点是否可选
linkage Boolean false 父子节点是否联动
placeholder String 请选择 空状态信息提示、弹窗标题
confirmText String 完成 确定按钮文字
confirmTextColor String #007aff 确定按钮文字颜色
listData Array - 展示的数据
dataLabel String name listData 中对应数据的 label
dataValue String id listData 中对应数据的 value
dataChildren String children listData 中对应数据的 children
clearable Boolean false 是否显示清除按钮,点击清除所有已选项
mutiple Boolean false 是否可以多选
disabled Boolean false 是否允许修改
search Boolean false 是否可以搜索(常用于数据较多的情况)
showChildren Boolean true 默认展开(数据内部 showChildren 属性优先级更高,可以设置全局收起,单独展开某一条数据)
border Boolean false 显示引导线

Events

事件名称 说明 返回值
change 弹窗组件状态发生变化触发 e={show: true | false,type:当前模式}
maskClick 点击遮罩层触发
done 点击完成按钮触发 选择的数据组成的数组

基础使用示例

<template>
  <!--/pages/index/index-->
  <button @click="$refs.treePopup.open()">打开弹窗</button>
  <custom-tree-popup ref="treePopup" :listData="listData" @done="done" />
</template>

<script>
export default {
  data() {
    return {
      listData: [
        {
          id: 1,
          name: '城市1',
          children: [
            {
              id: 3,
              name: '街道1',
              children: [
                {
                  id: 4,
                  name: '小区1'
                },
                {
                  id: 5,
                  name: '小区2'
                }
              ]
            }
          ]
        },
        {
          id: 2,
          name: '城市2',
          children: [
            {
              id: 6,
              name: '街道2'
            }
          ]
        },
        {
          id: 7,
          name: '城市3',
          children: [
            {
              id: 8,
              name: '街道1'
            },
            {
              id: 9,
              name: '街道2'
            },
            {
              id: 10,
              name: '街道10'
            }
          ]
        }
      ]
    }
  },
  methods: {
    done(data) {
      console.log(data)
    }
  }
}
</script>

隐私、权限声明

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

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

插件不采集任何数据

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

许可协议

MIT协议

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