feat: 将省市区数据存储在云开发数据库中 (#2428)

example/app.js

@@ -1,3 +1,12 @@
 App({
-  globalData: {}
+  globalData: {},
+  onLaunch() {
+    if (!wx.cloud) {
+      console.error('请使用 2.2.3 或以上的基础库以使用云能力');
+    } else {
+      wx.cloud.init({
+        env: 'production-7dtfw'
+      });
+    }
+  }
 });

example/pages/area/index.js

@@ -1,6 +1,8 @@
 import Page from '../../common/page';
 import Toast from '../../dist/toast/toast';
 
+const db = wx.cloud.database();
+
 Page({
   data: {
     areaList: {},
@@ -9,15 +11,20 @@ Page({
   },
 
   onShow() {
-    wx.request({
-      url: 'https://cashier.youzan.com/wsctrade/uic/address/getAllRegion.json',
-      success: response => {
+    db.collection('region').limit(1).get().then(res => {
+      if (res.data && res.data.length > 0) {
         this.setData({
           loading: false,
-          areaList: response.data.data
+          areaList: res.data[0]
         });
       }
-    });
+    })
+      .catch(err => {
+        console.log(err);
+        this.setData({
+          loading: false,
+        });
+      });
   },
 
   onChange(event) {

packages/area/README.md

@@ -86,6 +86,29 @@
 |-----------|-----------|-----------|-------------|
 | reset | code: string | - | 根据 code 重置所有选项，若不传 code，则重置到第一项 |
 
+
+### 使用云开发获取省市区数据
+
+实际项目中，可以通过小程序云开发的能力，将省市区数据保存在云开发的数据库中，并在小程序中使用云开发的接口异步获取数据。
+
+在小程序中使用云能力之前需要先调用`wx.could.init`方法完成云能力的初始化。
+
+``` js
+const db = wx.cloud.database();
+
+db.collection('region').limit(1).get()
+.then(res => {
+  if (res.data && res.data.length > 0) {
+    this.setData({
+      areaList: res.data[0]
+    });
+  }
+})
+.catch(err => {
+    console.log(err);
+  });
+```
+
 ### 省市区列表数据格式
 
 整体是一个 Object，包含 `province_list`, `city_list`, `county_list` 三个 key。