场景值

场景值

上一节中有提到过场景值，我们来了解一下什么是场景值。

场景值可用于统计用户来源，根据不同的来源做不同的引流活动等。

我们可以在 App 的 onlaunch 和 onshow 中获取场景值，部分场景值下还可以获取来源应用、公众号或小程序的appId。

基础库 1.1.0 开始支持，低版本需做兼容处理 （具体的兼容方法在后面内容详细说）

当前支持的场景值有：

• 1001 发现栏小程序主入口
• 1005 顶部搜索框的搜索结果页
• 1006 发现栏小程序主入口搜索框的搜索结果页
• 1007 单人聊天会话中的小程序消息卡片
• 1008 群聊会话中的小程序消息卡片
• 1011 扫描二维码
• 1012 长按图片识别二维码
• 1013 手机相册选取二维码
• 1014 小程序模版消息
• 1017 前往体验版的入口页
• 1019 微信钱包
• 1020 公众号 profile 页相关小程序列表
• 1022 聊天顶部置顶小程序入口
• 1023 安卓系统桌面图标
• 1024 小程序 profile 页
• 1025 扫描一维码
• 1026 附近小程序列表
• 1027 顶部搜索框搜索结果页“使用过的小程序”列表
• 1028 我的卡包
• 1029 卡券详情页
• 1030 自动化测试下打开小程序
• 1031 长按图片识别一维码
• 1032 手机相册选取一维码
• 1034 微信支付完成页
• 1035 公众号自定义菜单
• 1036 App 分享消息卡片
• 1037 小程序打开小程序
• 1038 从另一个小程序返回
• 1039 摇电视
• 1042 添加好友搜索框的搜索结果页
• 1043 公众号模板消息
• 1044 带 shareTicket 的小程序消息卡片
• 1047 扫描小程序码
• 1048 长按图片识别小程序码
• 1049 手机相册选取小程序码
• 1052 卡券的适用门店列表
• 1053 搜一搜的结果页
• 1054 顶部搜索框小程序快捷入口
• 1056 音乐播放器菜单
• 1057 钱包中的银行卡详情页
• 1058 公众号文章
• 1059 体验版小程序绑定邀请页
• 1064 微信连Wi-Fi状态栏
• 1067 公众号文章广告
• 1068 附近小程序列表广告
• 1071 钱包中的银行卡列表页
• 1072 二维码收款页面
• 1073 客服消息列表下发的小程序消息卡片
• 1074 公众号会话下发的小程序消息卡片
• 1078 连Wi-Fi成功页
• 1089 微信聊天主界面下拉
• 1090 长按小程序右上角菜单唤出最近使用历史
• 1092 城市服务入口

Tip: 由于Android系统限制，目前还无法获取到按 Home 键退出到桌面，然后从桌面再次进小程序的场景值，对于这种情况，会保留上一次的场景值。

注册页面-上

页

Page()函数用来注册一个页面。通过传入一个 object 参数，指定页面的初始数据、生命周期函数、事件处理函数等。
对象 参数说明：

object 内容在页面加载时会进行一次深拷贝，需考虑数据大小对页面加载的开销
示例代码：

//index.js
Page({
  data: {
    text: "该数据将传递到页面，供页面使用。"
  },
  onl oad: function(options) {
    // Do some initialize when page load.
  },
  onReady: function() {
    // Do something when page ready.
  },
  onShow: function() {
    // Do something when page show.
  },
  onHide: function() {
    // Do something when page hide.
  },
  onUnload: function() {
    // Do something when page close.
  },
  onPullDownRefresh: function() {
    // Do something when pull down.
  },
  onReachBottom: function() {
    // Do something when page reach bottom.
  },
  onShareAppMessage: function () {
   // return custom share data when user share.
  },
  onPageScroll: function() {
    // Do something when page scroll
  },
  onTabItemTap(item) {
    console.log(item.index)
    console.log(item.pagePath)
    console.log(item.text)
  },
  // 事件处理程序.
  viewTap: function() {
    this.setData({
      text: '设置一些数据来更新视图。'
    }, function() {
      // this is setData callback
    })
  },
  // 自定义数据
  customData: {
    hi: 'MINA'
  }
})

生命周期

初始化数据

初始化数据将作为页面的第一次渲染。data 将会以 JSON 的形式由逻辑层传至渲染层，所以其数据必须是可以转成 JSON 的格式，如字符串，数字，布尔值，对象，数组。
渲染层可以通过 WXML 对数据进行绑定。

WXML代码：

<view>{{text}}</view>
<view>{{array[0].msg}}</view>

JS代码：

Page({
  data: {
    text: '今天的天气：',
    array: [{msg: '晴'}, {msg: '阴'}]
  }
})

执行结果：

生命周期函数

• onLoad (页面加载): 一个页面只会调用一次，可以在 onl oad 中获取打开当前页面所调用的 query 参数。
• onShow (页面显示): 每次打开页面都会调用一次。
• oReady (页面初次渲染完成): 一个页面只会调用一次，代表页面已经准备妥当，可以和视图层进行交互。对界面的设置如wx.setNavigationBarTitle请在onReady之后设置。
• onHide (页面隐藏): 当navigateTo或底部tab切换时调用。
• onUnload (页面卸载): 当redirectTo或navigateBack的时候调用。

生命周期的调用以及页面的路由方式我们将会在下一节"路由"进行讲解

onLoad参数

注册页面-下

页面相关事件处理函数

• onpulDownRefresh 下拉刷新

1. 监听用户下拉刷新事件。
2. 需要在app.json的window选项中或页面配置中开启enablePullDownRefresh。
3. 当处理完数据刷新后，wx.stopPullDownRefresh可以停止当前页面的下拉刷新。

• onReachBottom: 上拉触底

1. 监听用户上拉触底事件。
2. 可以在app.json的window选项中或页面配置中设置触发距离onReachBottomDistance。
   在触发距离内滑动期间，本事件只会被触发一次。

• onPageScroll: 页面滚动

1. 监听用户滑动页面事件。
2. 参数为 Object，包含以下字段：
   

• onShareAppMessage: 用户转发

1. 只有定义了此事件处理函数，右上角菜单才会显示“转发”按钮
2. 用户点击转发按钮的时候会调用
3. 此事件需要 return 一个 Object，用于自定义转发内容

自定义转发字段

示例代码

Page({
  onShareAppMessage: function () {
    return {
      title: '自定义转发标题',
      path: '/page/user?id=888'
    }
  }
})