更新记录

0.1.3(2021-01-14)

item 支持 disable 属性

0.1.2(2021-01-14)

支持nvue

查看更多

DataPicker 级联选择

代码块: uDataPicker 关联组件:uni-data-pickerviewuni-load-more

<uni-data-picker> 是一个选择类datacom组件

支持单列、和多列级联选择。列数没有限制,如果屏幕显示不全,顶部tab区域会左右滚动。

候选数据支持一次性加载完毕,也支持懒加载,比如示例图中,选择了“北京”后,动态加载北京的区县数据。

<uni-data-picker> 组件尤其适用于地址选择、分类选择等选择类。

<uni-data-picker> 支持本地数据、云端静态数据(json),uniCloud云数据库数据。

<uni-data-picker> 可以通过JQL直连uniCloud云数据库,配套DB Schema,可在schema2code中自动生成前端页面,还支持服务器端校验。

在uniCloud数据表中新建表“uni-id-address”和“opendb-city-china”,这2个表的schema自带foreignKey关联。在“uni-id-address”表的表结构页面使用schema2code生成前端页面,会自动生成地址管理的维护页面,自动从“opendb-city-china”表包含的中国所有省市区信息里选择地址。

为了避免错误使用,给大家带来不好的开发体验,请在使用组件前仔细阅读下面的注意事项,可以帮你避免一些错误。

  • 组件需要依赖 sass 插件 ,请自行手动安装
  • 如使用过程中有任何问题,或者您对uni-ui有一些好的建议,欢迎加入 uni-ui 交流群:871950839
  • <uni-data-picker> 内部包含了弹出层组件 <uni-data-pickerview> 外层的布局可能会影响弹出层,详情

安装方式

本组件符合easycom规范,HBuilderX 2.5.5起,只需将本组件导入项目,在页面template中即可直接使用,无需在页面中import和注册componets

如需通过npm方式使用uni-ui组件,另见文档:https://ext.dcloud.net.cn/plugin?id=55

API

DataPicker Props

属性名 类型 可选值 默认值 说明
v-model String/ Number - - 绑定数据
localdata Array 数据,详情
preload Boolean true/false false 预加载数据
step-searh Boolean true/false true 分步查询时,点击节点请求数据
step-search-url String 分步查询时,动态加载云端数据url格式,https://xxx.com/{parentValue}(当前版本暂不支持,下版支持)
self-field String 分步查询时当前字段名称
parent-field String 分步查询时父字段名称
collection String 表名。支持输入多个表名,用 , 分割
field String 查询字段,多个字段用 , 分割
where String 查询条件,内容较多,另见jql文档:详情
orderby String 排序字段及正序倒叙设置
popup-title String 弹出层标题

注意:级联级别没有限制,取决tree的深度,如果层级过多选中tab会出现滚动

collection/where/orderby<unicloud-db> 的用法一致,详情

DataPicker Events

事件称名 类型 说明
@change EventHandle 选择完成时触发 {detail: {value}}
@nodeclick EventHandle 节点被点击时触发
@stepsearch EventHandle 动态加载节点数据前触发(当前版本暂不支持,下版支持)
@popupopened EventHandle 弹出层弹出时触发
@popupclosed EventHandle 弹出层关闭时触发

使用方法

绑定unicloud云端数据

  • 云端数据需要关联服务空间
  • 下面示例中使用的表 opendb-city-china(中国城市省市区数据,含港澳台), 在uniCloud控制台使用opendb创建,详情

只需如下简单代码,即可实现联网的、懒加载的城市选择。

<template>
  <view>
    <uni-data-picker placeholder="请选择地址" popup-title="请选择城市"
      collection="opendb-city-china" field="code as value, name as text, eq(['$type', 2]) as isleaf" orderby="value asc" :step-searh="true" :self-field="code" parent-field="parent_code"
 @change="onchange" @nodeclick="onnodeclick">
    </uni-data-picker>
  </view>
</template>


  export default {
    data() {
      return {
      }
    },
    methods: {
      onchange(e) {
        const value = e.detail.value
      },
      onnodeclick(node) {}
    }
  }

实际上在unicloud的DB schema中配置好合适的schema,可以自动生成城市选择的页面,还自带表单验证。详见

本地数据

<template>
  <view>
    <uni-data-picker :localdata="items" popup-title="请选择班级" @change="onchange" @nodeclick="onnodeclick"></uni-data-picker>
  </view>
</template>


  export default {
    data() {
      return {
        items: [{
          text: "一年级",
          value: "1-0",
          children: [
            {
              text: "1.1班",
              value: "1-1"
            },
            {
              text: "1.2班",
              value: "1-2"
            }
          ]
        },
        {
          text: "二年级",
          value: "2-0"
        },
        {
          text: "三年级",
          value: "3-0"
        }]
      }
    },
    methods: {
      onchange(e) {
        const value = e.detail.value
      },
      onnodeclick(node) {
      }
    }
  }

自定义solt

<uni-data-picker v-slot:default="{data, error, options}" popup-title="请选择所在地区">
  <view v-if="error" class="error">
    <text>{{error}}</text>
  </view>
  <view v-else-if="data.length" class="selected">
    <view v-for="(item,index) in data" :key="index" class="selected-item">
      <text>{{item.text}}</text>
    </view>
  </view>
  <view v-else>
    <text>请选择</text>
  </view>
</uni-data-picker>

localdatacollection 同时配置时,localdata 优先

完整示例

<template>
    <view class="container">
        <uni-data-picker @change="onchange" @nodeclick="onnodeclick" @stepsearch="onstepsearch" @popupopened="onpopupopened"
         @popupclosed="onpopupclosed">
        </uni-data-picker>
    </view>
</template>


    export default {
        data() {
            return {
                count: 1
            }
        },
        methods: {
            onchange(e) {
                const value = e.detail.value
            },
            onnodeclick(node) {
                // node 当前点击节点
            },
            onstepsearch(node, resolve) {
                if (node.level === 0) {
                    return resolve([{
                        text: 'region1',
                        value: 'region1'
                    }, {
                        text: 'region2',
                        value: 'region1'
                    }]);
                }

                var hasChild;
                if (node.text === 'region1') {
                    hasChild = true;
                } else if (node.text === 'region2') {
                    hasChild = false;
                } else {
                    hasChild = Math.random() > 0.5;
                }

                setTimeout(() => {
                    var data;
                    if (hasChild) {
                        data = [{
                            text: 'zone' + this.count++,
                            value: 'zone' + this.count++
                        }, {
                            text: 'zone' + this.count++,
                            value: 'zone' + this.count++
                        }];
                    } else {
                        data = [];
                    }

                    resolve(data);
                }, 500);
            },
            onpopupopened() {},
            onpopupclosed() {}
        }
    }

隐私、权限声明

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

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

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

许可协议

MIT协议

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