乐趣区

前后台数据交互跟数据渲染小程序入门与实战九

jiezi

4-3

上一章节我们了解了小程序的页面使用 Page({}) 注册，数据 data，生命周期函数，事件处理函数都可以被接收。

先静后动，我们的首页已经是一个静态页面了，所以我们需要用数据来渲染首页。

wx.request 后台数据交互

发送 HTTPS 网络请求。

wx.request({
  url: 'https://guojiang.club/api/sir/card', // 真实的接口地址
  header: {'content-type': 'application/json' // 默认值},
   data:{
   // 传入的数据为 page，页数
       page:1
   }
   //HTTP 请求方法，默认值为 get
  method:'GET',
  success (res) {
  // 接口调用成功，在这里就可以获取到数据
    console.log(res.data)
  },
  fail(rej){
  // 接口调用失败
      console.log(rej.data)
  }
  
})

使用前说明

在使用 wx.request 之前，我们需要注意以下两点：

服务器域名配置
  1. 进入 https://mp.weixin.qq.com，输入账号密码登入
  2. 在菜单栏找到”开发“-”开发者设置“


点击”修改“按钮，在”request 合法请求域名“添加，例如：https://guojiang.club

  1. 如果你的这个域名只是测试环境的域名，你并不打算拿来上线的，就需要你在微信开发者工具勾选

勾选完”不合法域名校验之后“，你可以看看你的调试基础库，是不是最新的，如果不是勾选使用人数最多的。

这些都做好之后，我们就可以在 index.js里写方法请求数据了。

代码实例分析

// index.js 代码
Page({
//data 是页面第一次渲染使用的初始数据
    data:{// 声明一个 cradList 变量，初始值为“[]”, 一个空数组
        cardList:[]},
    onLoad(){// 调用 getIndexCard()方法，this 指向整个小程序实例
        this.getIndexCard(1)
    },
    // 获取首页数据信息
    getIndexCard(page){
        wx.request({
            url: 'https://guojiang.club/api/sir/card', // 真实的接口地址
            header: {'content-type': 'application/json' // 默认值},
            data:{
                // 传入的数据为 page，页数
                page:page
            },
            //HTTP 请求方法，默认值为 get
            method:'GET',
            success:res=> {
                // 接口调用成功，在这里就可以获取到数据
                res = res.data;
                if(res.status){
                    this.setData({cardList:res.data})
                }
            },
            fail:(rej)=>{
                // 接口调用失败
                console.log(rej.data)
            }

        })
    }

})

我们上面已经已经写了 getIndexCard 这个方法，可以调用 https://guojiang.club/api/sir/card 这个接口，获取列表的数据。

打开微信开发者工具看一下后台返回给我们的数据。

data

data 是页面第一次渲染使用的 初始数据。

页面加载时，data将会以 JSON 字符串的形式由逻辑层传至渲染层，所以data 的数据类型只能为：

  • 字符串 ‘abc’
  • 数字 1,2
  • 布尔值 true ,false
  • 对象 {}
  • 数组 []

渲染层可以通过 WXML 对数据进行绑定。使用 {{}}双大括号进行数据绑定。

示例：

# js
data:{message:'黔在在'}

# wxml
<view>{{message}}</view>

这样页面上就会显示“黔在在”。

如果你要在 index.js 使用 message , 则需要 this.data.message，this指向整个小程序实例。

setData() 方法

setData 函数用于将数据从逻辑层发送到视图层（异步），同时改变对应的 this.data 的值（同步）。

字段 描述
data 接收对象 这次要改变的数据
callback 函数 setData 引起的界面更新渲染完毕后的回调函数

我们上面写了这样一段代码

data:{cardList:[]
},
this.setData({cardList:res.data})

cardList的初始值为 [] ,
this.setData 将 cardList 重新赋值为 res.data。以键值对的形式，key:value。

其中 key 可以以数据路径的形式给出，支持改变数组中的某一项或对象的某个属性，如 array[2].message，a.b.c.d，并且不需要在 this.data 中预先定义。

注意：

  1. 直接修改 this.data 而不调用 this.setData 是无法改变页面的状态的，还会造成数据不一致。
  2. 单次设置的数据不能超过 1024kB，请尽量避免一次设置过多的数据。
  3. 请不要把 data 中任何一项的 value 设为 undefined，否则这一项将不被设置并可能遗留一些潜在问题。

我们可以看一下 cardList 这个数据的改变。

渲染数据到 WXML 上

我们来渲染图片，昵称跟描述。

# index.wxml 代码

 <swiper-item wx:for="{{cardList}}" wx:key="index">
                    <image mode="aspectFill"
                           src="{{item.img_list[0]}}"
                           class="slide-image">
                    </image>
                    <!-- 文字说明 -->
                    <view class="text-box">
                        <view class="name">
                            @{{item.nick_name}}
                        </view>
                        <view class="info">
                            {{item.description}}
                        </view>
                    </view>
                    </view>
                </swiper-item>

这里我们用到了，列表渲染。

列表渲染

使用 wx:for 循环数组，就可以用数组中的各项数据重复渲染该组件。

简单举例：

<view> 黔在在 <view>
<view> 在在 <view>
<view> 小黔黔 <view>

可以使用 wx:for 来简化

Page({
    data:{
        arr:[
        {name:'黔在在'},
         {name:'在在'},
         {name:'小黔黔'},
        
        ]
    }
})
<view wx:for="{{arr}}" wx:key="index">{{item.name}} <view>

item: 数组当前项的变量名

index: 数组的当前项的下标变量名

我们必须使用 wx:key 来指定列表中项目的唯一的标识符。

如不提供 wx:key，会报一个 warning

可以使用 wx:for-item 可以指定数组当前元素的变量名，为字符串

可以使用 wx:for-index 可以指定数组当前下标的变量名, 为字符串

<view wx:for="{{arr}}"
wx:for-item="itemName"
wx:for-index="idx"
wx:key="idx">

    {{item.name}} 

<view>

总结

  • wx.request 发送 HTTPS 请求，跟后端进行数据交互
  • 使用 wx.request 的说明，需要配置域名或者勾选掉“不校验开发者域名”
  • 数据绑定使用 {{}}
  • this指向为小程序实例
  • setData()赋值，可以改变视图层。
  • 使用 wx:for 进行列表渲染。

下一章节我们讲解分页数据应该怎么处理，触底怎么刷新数据。

本文由博客群发一文多发等运营工具平台 OpenWrite 发布

退出移动版