可参考:
使用详情
https://blog.csdn.net/lepaitianshi/article/details/82818815
https://www.jianshu.com/p/9d06d41322b0
小程序登录,登录态,授权,用户信息可参考:
https://blog.csdn.net/bobobocai/article/details/77651566?locationNum=5&fps=1
小程序demo:
WXML
一、 定义:
WXML(WeiXin Markup Language)是框架设计的一套标签语言,结合基础组件、事件系统,可以构建出页面的结构。
二、 语法
<标签 属性key=“属性Value”></标签>
三、功能
- 数据绑定
- 列表渲染
- 条件渲染
- 模板引用
- 事件
3-1数据绑定
WXML 中的动态数据均来自对应 Page 的 data。数据绑定使用 Mustache 语法(双大括号)将变量包起来,可以作用于:
.wxml
<view> {{ message }} </view>
.js
Page({
data: {
message: 'Hello World!'
}
})
.wxml
<view id="item-{{id}}"> </view>
js
Page({
data: {
id: 0
}
})
.wxml
true:boolean 类型的 true,代表真值。
false: boolean 类型的 false,代表假值。
<checkbox checked="{{false}}"> </checkbox>
不要直接写 checked=“false”,其计算结果是一个字符串,转成 boolean 类型后代表真值。
可以在 {{}} 内进行简单的运算
<view hidden="{{flag ? true : false}}"> Hidden </view>
.wxml
<view> {{a + b}} + {{c}} + d </view>
.js
Page({
data: {
a: 1,
b: 2,
c: 3
}
})
view中的内容为 3 + 3 + d。
<view wx:if="{{length > 5}}"> </view>
<view wx:if="{{type==1}}">初中</view>
<view wx:elif="{{type==2}}">高中</view>
<view wx:else>大学</view>
当我们data中有一个type值,不同的值要显示不同的字,例如type有1,2,3三种值,分别表示初中,高中,大学。那么当服务端返回值后,我们该如何将type值转换为对应的字符显示呢。在这里提供三种方式:
<!--方式1,使用三元表达式-->
<
view
>{{type==1 ?'初中':(type==2?'高中':'大学')}}</
view
>
<!--方式2,使用条件渲染-->
<
view
wx:if
=
"{{type==1}}"
>初中</
view
>
<
view
wx:elif
=
"{{type==2}}"
>高中</
view
>
<
view
wx:else>大学</
view
>
<!--方式3,js对数据预处理,jsdata中增加typeName-->
js文件相应预处理: (以下处理必须放在js的
onLoad方法中)
onLoad: function(option) {
var typeName = ''
if (this.data.types == 1) {
typeName = '初中'
} else if (this.data.types == 2) {
typeName = '高中'
} else {
typeName = '大学'
}
this.setData({
typeName: typeName
})
}
WXML:中显示
<
view
>{{typeName}}</
view
>
3-2 列表渲染
wx:for
在组件上使用 wx:for 控制属性绑定一个数组,即可使用数组中各项的数据重复渲染该组件。类似 block wx:if,也可以将 wx:for 用在标签上,以渲染一个包含多节点的结构块。
默认数组的当前项的下标变量名默认为 index,数组当前项的变量名默认为 item
wx:for-item
可以指定数组当前元素的变量名,
如果列表中项目的位置会动态改变或者有新的项目添加到列表中,并且希望列表中的项目保持自己的特征和状态(如 中的输入内容, 的选中状态),需要使用 wx:key 来指定列表中项目的唯一的标识符。
wx:key 的值以两种形式提供
字符串,代表在 for 循环的 array 中 item 的某个 property,该 property 的值需要是列表中唯一的字符串或数字,且不能动态改变。
保留关键字 *this 代表在 for 循环中的 item 本身,这种表示需要 item 本身是一个唯一的字符串或者数字,如:
当数据改变触发渲染层重新渲染的时候,会校正带有 key 的组件,框架会确保他们被重新排序,而不是重新创建,以确保使组件保持自身的状态,并且提高列表渲染时的效率。
wx:for-index 可以指定数组当前下标的变量名
.js
Page(
{
data:{
array: [{
message: 'hello',
}, {
message: 'world'
}]
}
}
)
<view>
<block wx:for="{{array}}">
<view>{{index}}:{{item.message}}</view>
</block>
</view>
wx:for 绑定在需要循环的元素上就可以,下面拿值的时候,直接通过 {{item.id}}这种来拿值
界面显示:
0:hello
1:world
例如:
如果需要对proList的数据进行处理,例如,新增一个name的属性,或者对proList中的数据重新处理的话,则可以使用以下办法解决:
//通过setData来重新复制
onLoad: function(option) {
var data = this.data.proList;
for (var k in data) {
data[k]['names'] = "小小小"
}
console.log(data)
console.log(this.data.proList)
this.setData({
proList: data
})
}
这时候就可以在wxml中这样使用了,就能拿到names这个属性了
3-3条件渲染
wx:if
使用 wx:if="{{condition}}" 来判断是否需要渲染该代码块:
<view wx:if="{{condition}}"> True </view>
也可以用 wx:elif 和 wx:else 来添加一个 else 块:
<view wx:if="{{length > 5}}"> 1 </view>
<view wx:elif="{{length > 2}}"> 2 </view>
<view wx:else> 3 </view>
block wx:if
因为 wx:if 是一个控制属性,需要将它添加到一个标签上。如果要一次性判断多个组件标签,可以使用一个 标签将多个组件包装起来,并在上边使用 wx:if 控制属性。
并不是一个组件,它仅仅是一个包装元素,不会在页面中做任何渲染,只接受控制属性。
<block wx:if="{{true}}">
<view> view1 </view>
<view> view2 </view>
</block>
wx:if vs hidden
因为 wx:if 之中的模板也可能包含数据绑定,所以当 wx:if 的条件值切换时,框架有一个局部渲染的过程,因为它会确保条件块在切换时销毁或重新渲染。
同时 wx:if 也是惰性的,如果在初始渲染条件为 false,框架什么也不做,在条件第一次变成真的时候才开始局部渲染。
相比之下,hidden 就简单的多,组件始终会被渲染,只是简单的控制显示与隐藏。
一般来说,wx:if 有更高的切换消耗而 hidden 有更高的初始渲染消耗。因此,如果需要频繁切换的情景下,用 hidden 更好,如果在运行时条件不大可能改变则 wx:if 较好。
3-4 模板引用
描述
WXML提供模板(template),可以在模板中定义代码片段,然后在不同的地方调用。
声明
在wxml中使用template标签,使用 name 属性,作为模板的名字。然后在内定义代码片段,如:
<template name="msgItem">
<view>
<text> {{index}}: {{msg}} </text>
<text> Time: {{time}} </text>
</view>
</template>
使用
使用导入模板,使用 is 属性,声明需要的使用的模板
使用@import "wxss路径“导入模板的样式。
<template is="msgItem" data="{{...item}}"/>
作用域
模板拥有自己的作用域,只能使用 data 传入的数据以及模版定义文件中定义的 模块。
3-5
3-5-1 什么是事件
- 事件是视图层到逻辑层的通讯方式。
- 事件可以将用户的行为反馈到逻辑层进行处理。
- 事件可以绑定在组件上,当达到触发事件,就会执行逻辑层中对应的事件处理函数。
- 事件对象可以携带额外信息,如 id, dataset, touches。
3-5-2 使用方式
在组件中绑定一个事件处理函数,然后在相应的Page定义中写上相应的事件处理函数,参数是event。
3-5-3 分类
事件分为冒泡事件和非冒泡事件:
1.冒泡事件:当一个组件上的事件被触发后,该事件会向父节点传递。
2.非冒泡事件:当一个组件上的事件被触发后,该事件不会向父节点传递。
3-5-4 事件绑定和冒泡
事件绑定的写法同组件的属性,以 key、value 的形式。
- key 以bind或catch开头,然后跟上事件的类型,如bindtap、catchtouchstart。自基础库版本 1.5.0 起,在非原生组件中,bind和catch后可以紧跟一个冒号,其含义不变,如bind:tap、catch:touchstart。
- value 是一个字符串,需要在对应的 Page 中定义同名的函数。不然当触发事件的时候会报错。
如在下边这个例子中,点击 inner view 会先后调用handleTap3和handleTap2(因为tap事件会冒泡到 middle view,而 middle view 阻止了 tap 事件冒泡,不再向父节点传递),点击 middle view 会触发handleTap2,点击 outer view 会触发handleTap1。
<view id="outer" bindtap="handleTap1">
outer view
<view id="middle" catchtap="handleTap2">
middle view
<view id="inner" bindtap="handleTap3">
inner view
</view>
</view>
</view>
bind事件绑定不会阻止冒泡事件向上冒泡,catch事件绑定可以阻止冒泡事件向上冒泡。