本系列专门针对新手,可能是知识点的再次陈述,也可能是一些小技巧的整理;
本分享作者:谢一咕,来自原文地址
一:获取设备信息 API实例详解
wxml
<button type="primary" bindtap="getNetWorkType">获取网络类型</button>
<button type="primary" bindtap="getSystemInfo">获取设备信息</button>
<button type="primary" bindtap="onAccelerometerChange">监听重力感应数据</button>
<button type="primary" bindtap="onCompassChange">监听罗盘数据</button>
js
Page({
data:{
text:"Page system"
},
onLoad:function(options){
// 页面初始化 options为页面跳转所带来的参数
},
/**
* 获取当前网络状态
*/
getNetWorkType: function() {
wx.getNetworkType({
success: function(res) {
console.log(res)
}
})
},
/**
* 获取系统信息
*/
getSystemInfo: function() {
wx.getSystemInfo({
success: function(res) {
console.log(res)
}
})
},
/**
* 监听重力感应数据
* - 带on开头的都是监听接收一个callback
*/
onAccelerometerChange: function() {
wx.onAccelerometerChange(function(res) {
console.log(res)
})
},
/**
* 监听罗盘数据
*/
onCompassChange: function() {
wx.onCompassChange(function(res) {
console.log(res)
})
},
onReady:function(){
// 页面渲染完成
},
onShow:function(){
// 页面显示
},
onHide:function(){
// 页面隐藏
},
onUnload:function(){
// 页面关闭
}
})
二:template模板引用
WXML 引用import 可以在当前文件中使用目标文件定义的 template
在 item.wxml 中定义了一个 item 的 template
<!-- item.wxml -->
<template name="item">
<text>{{text}}</text>
</template>
在 index.wxml 中引用 item.wxml,就可以使用 item 的模板
<import src="item.wxml"/>
<template is="item" data="{{text: 'forbar'}}"/>
三:注册页面 Page()函数
生命周期函数onLoad: 页面加载
-
一个页面只会调用一次。
-
接收页面参数可以获取wx.navigateTo和wx.redirectTo及<navigator/>中的 query。
onShow: 页面显示
onReady: 页面初次渲染完成
-
一个页面只会调用一次,代表页面已经准备妥当,可以和视图层进行交互。
-
对界面的设置如wx.setNavigationBarTitle请在onReady之后设置。详见生命周期
onHide: 页面隐藏
onUnload: 页面卸载
-
当redirectTo或navigateBack的时候调用。
四:wx:for
wx:for控制属性绑定一个数组,即可使用数组中各项的数据重复渲染该组件。
内置变量 index(数组遍历的下标), item(数组遍历的每一项)
<view wx:for="{{items}}">
{{index}}: {{item.message}}
</view>
Page({
items: [{
message: 'foo',
},{
message: 'bar'
}]
})
使用wx:for-item可以指定数组当前元素的变量名。
使用wx:for-index可以指定数组当前下标的变量名。
<view wx:for="{{array}}" wx:for-index="idx" wx:for-item="itemName">
{{idx}}: {{itemName.message}}
</view>
wx:key如果列表中项目的位置会动态改变或者有新的项目添加到列表中,并且希望列表中的项目保持自己的特征和状态(如 <input/>中的输入内容,<switch/> 的选中状态),需要使用 wx:key来指定列表中项目的唯一的标识符。
wx:key的值以两种形式提供:
1、字符串,代表在 for 循环的 array 中 item 的某个 property,该 property 的值需要是列表中唯一的字符串或数字,且不能动态改变。
2、保留关键字 *this代表在 for 循环中的 item 本身,这种表示需要 item 本身是一个唯一的字符串或者数字,如:
当数据改变触发渲染层重新渲染的时候,会校正带有 key 的组件,框架会确保他们被重新排序,而不是重新创建,以确保使组件保持自身的状态,并且提高列表渲染时的效率。
如不提供 wx:key,会报一个 warning,如果明确知道该列表是静态,或者不必关注其顺序,可以选择忽略。 |