【page.js】配置及Page函数说明
2024-09-04 10:32:58
页面.js中的Page函数用来注册一个页面,指定页面的初始数据、生命周期回调、事件处理函数等。
语法:Page(Object)
参数: Object json对象
Page({ /**
* data
* 说明: 页面的初始数据
**/
data : {
// 定义本页面所需的变量
text : "This is page data."
}, /**
* onLoad(query)
* 说明: 页面加载时触发。一个页面只会调用一次,可以在 onLoad 的参数中获取打开当前页面路径中的参数。
* 参数: query [Object] 打开当前页面路径中的参数
**/
onLoad : function(query){
}, /**
* onShow()
* 说明: 页面显示/切入前台时触发。。
**/
onShow : function(){
}, /**
* onReady()
* 说明: 页面初次渲染完成时触发。一个页面只会调用一次,代表页面已经准备妥当,可以和视图层进行交互。
**/
onReady : function(){
}, /**
* onHide()
* 说明: 页面隐藏/切入后台时触发。 如 navigateTo 或底部 tab 切换到其他页面,小程序切入后台等。
**/
onHide : function(){
}, /**
* onUnload()
* 说明: 页面卸载时触发。如redirectTo或navigateBack到其他页面时。
**/
onUnload : function(){
}, /**
* onPullDownRefresh()
* 说明: 监听用户下拉刷新事件。
* 注意:
* 1) 需要在app.json的window选项中或页面配置中开启enablePullDownRefresh。
* 2) 可以通过wx.startPullDownRefresh触发下拉刷新,调用后触发下拉刷新动画,效果与用户手动下拉刷新一致。
* 3) 当处理完数据刷新后,wx.stopPullDownRefresh可以停止当前页面的下拉刷新。
**/
onPullDownRefresh : function(){
}, /**
* onReachBottom()
* 说明: 监听用户上拉触底事件。
* 注意:
* 1) 可以在app.json的window选项中或页面配置中设置触发距离onReachBottomDistance。
* 2) 在触发距离内滑动期间,本事件只会被触发一次。
**/
onReachBottom : function(){
}, /**
* onPageScroll(Object)
* 说明: 监听用户滑动页面事件。
* 参数: Object,可以通过Object获取以下数据:
* Object.scrollTop [Number] 页面在垂直方向已滚动的距离(单位px)
**/
onPageScroll : function(Object){
}, /**
* onShareAppMessage(Object)
* 说明: 监听用户转发行为。是点击转发按钮(<button> 组件 open-type="share")还是右上角菜单“转发”按钮的行为,并自定义转发内容。
* 参数: Object,可以通过Object获取以下数据:
* Object.from [button|menu] 转发事件来源。值为 button 时表示点击页面转发按钮。 值为menu通过点击页面右上角转发菜单。
* Object.target [Object] 如果 from 值是 button,则 target 是触发这次转发事件的 button,否则为 undefined
* Object.webViewUrl [String] 页面中包含<web-view>组件时,返回当前<web-view>的url
*
* 注意:
* 1) 只有定义了此事件处理函数,右上角菜单才会显示“转发”按钮
* 2) 该函数需要返回一个对象,用于自定义转发内容
**/
onShareAppMessage : function(Object){
// 返回对象,定义转发内容
return {
title : [String],
path : [String], // 当前页面 path ,必须是以 / 开头的完整路径,比如:/page/user?id=123
imageUrl : [String] // [可选] 自定义图片路径,可以是任意图片路径,支持PNG及JPG。显示图片长宽比是 5:4。不设置时使用默认截图
}
}, /**
* onTabItemTap(Object)
* 说明: 监听点击 tab 时触发
* 参数: Object,可以通过Object获取以下数据:
* Object.index [String] 被点击tabItem的序号,从0开始
* Object.pagePath [String] 被点击tabItem的页面路径
* Object.text [String] 被点击tabItem的按钮文字
**/
onTabItemTap : function(Object){
}, /**
* 自定义组件事件
* 组件中加入 bindtap="sample",在Page内定义该事件
* 比如组件: <view bindtap="sample">点我</view>
* 定义点击事件示例:
**/
sample : function(){
// 这里定义单击事件
}, /**
* 属性: this.route
* 说明: Page内置属性,返回当前页面的路径,不含扩展名,比如: page/index/index
*/ /**
* 函数: this.setData(Object data, Function callback)
* 说明: 更改或增加page.data下的变量值,同时改变对应的视图层调用数据
* 示例:
* this.setData({text : '新内容'}) // 更改或增加data下的text键值
* this.setData({'marray[0].text' : 123}); // 修改键名marray第一个元素的键名为text的值
* this.setData({'object.text' : 567}); // 修改键名object下的键名为text的值
* this.setData({'a.b' : 1}); // 如果this.data.a.b 不存在时,则新建这个键。不管是否存在this.data.a路径
*
* 注意:
* 1) 要获取data下定义的数据,采用 this.data.text 方式获取
* 2) 直接修改 this.data 而不调用 this.setData 是无法改变页面的状态的,还会造成数据不一致。
* 3) 单次设置的数据不能超过1024kB,请尽量避免一次设置过多的数据。
* 4) 请不要把 data 中任何一项的 value 设为 undefined ,否则这一项将不被设置并可能遗留一些潜在问题。
*/ })
最新文章
- javac找不到或无法加载主类 com.sun.tools.javac.Main
- 【leetcode】Merge Two Sorted Lists
- iOS-UIScrollView和UIPageControl的综合实力,滚动图,轮播图
- git之三
- mint锁屏设置
- Java中HashMap案例
- 剑指offer系列54---数组中出现次数超过一半的数
- 什么是DOM
- (转)Eclipse快捷键大全,导包快捷键:ctrl+Shift+/
- C++友元函数重载";++";和";--";运算符
- 可能是讲解ARM中断和中断嵌套最通俗易懂的文章
- java线程状态和获取线程基本信息
- Oracle——存储过程的使用
- python 全栈开发,Day142(flask标准目录结构, flask使用SQLAlchemy,flask离线脚本,flask多app应用,flask-script,flask-migrate,pipreqs)
- PyQt5安装及ModuleNotFoundError: No module named &#39;PyQt5&#39;问题解决
- [ERR] Node 192.168.25.135:7001 is not empty. Either the node already knows other nodes (check with CLUSTER NODES) or contains some key in database 0.
- SSD的SLC MLC 和TLC哪个好?
- JAVA class 编译jar。 控制台使用jar
- MS17-010永恒之蓝验证
- java 的异常处理