微信小程序学习记录（一）

微信小程序学习记录（一）

一、构造函数App

• App() 必须在 app.js 中调用，必须调用且只能调用一次。不然会出现无法预期的后果。
• App() 函数用来注册一个小程序。接受一个 Object 参数，其指定小程序的生命周期回调等。
• Object参数说明：

onLaunch： Function, 生命周期回调—监听小程序初始化
小程序初始化完成时（全局只触发一次）
	
onShow:	Function,	生命周期回调—监听小程序显示
小程序启动，或从后台进入前台显示时

onHide:	Function,	生命周期回调—监听小程序隐藏
小程序从前台进入后台时

onError:	Function,	错误监听函数
小程序发生脚本错误，或者 api 调用失败时触发，会带上错误信息

onPageNotFound: Function, 页面不存在时的监听函数	
小程序要打开的页面不存在时触发，会带上页面信息回调该函数

其他：Any,	开发者可以添加任意的函数或数据到 Object 参数中，用 `this `可以访问， 即将数据复制到返回的App对象实例中。


返回：App实例，可在程序中直接通过`getApp()`方法获取到App实例。

注意：
1. 不要在定义于 App() 内的函数中调用 getApp() ，使用 this 就可以拿到 app 实例。
2. 通过 getApp() 获取实例之后，不要私自调用生命周期函数。

生命周期函数默认参数：

App.onLaunch : 默认参数----- 一个对象, 	Object

属性	类型	说明	
path	string	启动小程序的路径	
scene	number	启动小程序的场景值	
query	Object	启动小程序的 query 参数	
shareTicket	string	shareTicket，详见获取更多转发信息	
referrerInfo	Object	来源信息。从另一个小程序、公众号或 App 进入小程序时返回。否则返回 {}。(参见后文注意)	

App.onShow : 默认参数----一个对象， object

属性	类型	说明	
path	string	小程序切前台的路径	
scene	number	小程序切前台的场景值	
query	Object	小程序切前台的 query 参数	
shareTicket	string	shareTicket，详见获取更多转发信息	
referrerInfo	Object	来源信息。从另一个小程序、公众号或 App 进入小程序时返回。否则返回 {}。(参见后文注意)	

App.onHide : 无参数

App.onError: 参数----error，错误信息

App.onPageNotFound : 参数----未知

二、页面构造器(page)

Page(Object) 函数用来注册一个页面。接受一个 Object 类型参数，其指定页面的初始数据、生命周期回调、事件处理函数等。
Page构造函数参数对象：

属性			类型			描述
data			Object			页面的初始数据
onLoad			Function		生命周期回调—监听页面加载
onShow			Function		生命周期回调—监听页面显示
onReady			Function		生命周期回调—监听页面初次渲染完成
onHide			Function		生命周期回调—监听页面隐藏
onUnload		Function		生命周期回调—监听页面卸载
onPullDownRefresh	Function		监听用户下拉动作
onReachBottom	Function		页面上拉触底事件的处理函数
onShareAppMessage	Function		用户点击右上角转发
onPageScroll		Function		页面滚动触发事件的处理函数
onResize	Function		页面尺寸改变时触发，详见 响应显示区域变化
onTabItemTap	Function		当前是 tab 页时，点击 tab 时触发
其他		Any			开发者可以添加任意的函数或数据到 Object 参数中，在页面的函数中用 this 可以访问

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

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

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

• 事件处理函数
  除了初始化数据和生命周期函数，Page 中还可以定义一些特殊的函数：事件处理函数。在渲染层可以在组件中加入事件绑定，当达到触发事件时，就会执行 Page 中定义的事件处理函数。
  示例代码：

 click me  
Page({ 
 viewTap: function() { 
  console.log('view tap') 
 } 
}) 

Page.prototype.setData()
setData 函数用于将数据从逻辑层发送到视图层，同时改变对应的 this.data 的值。
注意：
直接修改 this.data 无效，无法改变页面的状态，还会造成数据不一致。
单次设置的数据不能超过1024kB，请尽量避免一次设置过多的数据。

• onShareAppMessage(Object) 监听用户点击页面内转发按钮（ 组件 open-type=“share”）或右上角菜单“转发”按钮的行为，并自定义转发内容。
  注意：只有定义了此事件处理函数，右上角菜单才会显示“转发”按钮

Object	参数类型	参数说明
from:	String	转发事件来源。
button：		页面内转发按钮；
menu：			右上角转发菜单	
target:	Object	如果 from 值是 button，则 target 是触发这次转发事件的 button，否则为 undefined	
webViewUrl: String	页面中包含组件时，返回当前的url	
此事件需要 return 一个 Object，用于自定义转发内容，返回内容如下：

自定义转发内容

字段	说明		默认值	
title	转发标题		当前小程序名称	
path	转发路径		当前页面 path ，必须是以 / 开头的完整路径	
imageUrl	自定义图片路径，可以是本地文件路径、代码包文件路径或者网络图片路径。支持PNG及JPG。显示图片长宽比是 5:4。	
Page({
  onShareAppMessage(res) {
    if (res.from === 'button') {
      // 来自页面内转发按钮
      console.log(res.target)
    }
    return {
      title: '自定义转发标题',
      path: '/page/user?id=123'
    }
  }
})

• onResize(object)
  小程序屏幕旋转时触发。详见 响应显示区域变化

• onTabItemTap(Object)
  点击 tab 时触发

Object 参数说明：
参数	类型	说明	
index		String	被点击tabItem的序号，从0开始	
pagePath	String	被点击tabItem的页面路径	
text	String	被点击tabItem的按钮文字	
示例代码：
Page({
  onTabItemTap(item) {
    console.log(item.index)
    console.log(item.pagePath)
    console.log(item.text)
  }
})