更新记录

1.0.1（2021-09-09） 下载此版本

一些小变化

1.0.0（2021-08-30） 下载此版本

初始化

平台兼容性

DataPicker 级联选择

组件名：luyj-data-picker 代码块： uDataPicker 关联组件：uni-data-pickerview、uni-load-more。

说明

在官方组件uni-data-picker的基础上，只是更改了字体大小。使得它与其他插件一样，将字体显示px改为rpx。

<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> 外层的布局可能会影响弹出层，详情

平台差异说明

暂不支持在nvue页面中使用

安装方式

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

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

API

DataPicker Props

---

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

DataPicker Events

基本用法

云端数据

注意事项

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

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

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

本地数据

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

<script>
  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) {
      }
    }
  }
</script>

自定义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>

注意事项 localdata 和 collection 同时配置时，localdata 优先

完整示例

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

<script>
    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() {}
        }
    }
</script>

组件示例

点击查看：https://hellouniapp.dcloud.net.cn/pages/extUI/data-picker/data-picker