标签：function Do 逻辑框架程序 when page 页面

场景值

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

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

我们可以在 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 下拉刷新

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

onReachBottom: 上拉触底

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

onPageScroll: 页面滚动

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

onShareAppMessage: 用户转发

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

自定义转发字段

示例代码

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

标签：function,Do,逻辑,框架,程序,when,page,页面
From： https://www.cnblogs.com/Steph/p/16609210.html

框架-逻辑层（）

场景值

场景值