微信小程序开发-模板与配置
WXML模板
数据绑定
1. 数据绑定的基本原则
- 在data中定义数据(.js中的data对象中)
- 在WXML中使用数据
2. Mustache语法
把data中的数据绑定到页面进行渲染,使用Mastache语法(双大括号)将变量包起来即可。语法格式为:
1 | <view>{{要绑定的数据类型}}</view> |
3. Mustache语法的应用场景
- 绑定内容
- 绑定属性
- 运算(三元运算、算数运算等)
4. 动态绑定内容
5. 动态绑定属性
.js 中的data
1 | Page({ |
.wxml中
1 | <image src="{{imgsrc}}"></image> |
6. 三元运算
页面数据
1 | Page({ |
页面结构
1 | <view>{{randomNum>=5 ? '随机数字大于等于5':'随机数字小于5'}} </view> |
事件绑定
1. 什么是事件
事件是渲染层到逻辑层的通讯方式。通过事件可以将用户在渲染层的行为,反馈到逻辑层进行业务的处理。
2. 小程序中常用事件
类型 | 绑定方式 | 事件描述 |
---|---|---|
tap | bindtap/bind:tap | 手指触摸后马上离开,类似HTML中的click事件 |
input | bindinput/bind:input | 文本框的输入事件 |
change | bindchange/bind:change | 状态改变时触发 |
3. 事件对象的属性列表
当事件回调时,会收到一个事件对象event,它的详细属性如下:
属性 | 类型 | 说明 |
---|---|---|
type | String | 事件类型 |
timeStamp | Int | 页面打开到触发事件经过的毫秒数 |
target | Object | 触发事件的组件的一些属性值集合 |
currentTarget | Object | 当前组件的一些属性值集合 |
detail | Object | 额外的信息 |
touches | Array | 触摸事件,当前停留在屏幕中的触摸点信息的数组 |
changedTouches | Array | 触摸事件,当前变化的触摸点信息的数组 |
4. target与currentTarget区别
target是触发该事件的源头组件,而currentTarget是当前事件所绑定的组件。
???
5. bindtap的语法格式
- 通过bindtap,可以为组件绑定tap触摸事件,语法如下:
1 | <button type="primary" bindtap="btnTapHandler">按钮</button> |
- 在页面的.js文件中定义对应的事件处理函数,事件参数通过形参event(简写为e)来接收
1 | Page({ |
6. 在事件处理函数中为data中的数据赋值
通过调用this.setData(dataObject)方法,可以给页面data中的数据重新赋值,示例(设置按钮按下使data中的count变量+1)如下:
- 设置一个+1按钮
1 | <button type="warn" bind:tap="changecount">+1</button> |
- 在js中编写+1函数
1 | Page({ |
- 编译后点击按钮,观察调试器中的AppData中count变量的值+1
7. 事件传参
可以为组件提供data-*自定义属性传参,其中*代表的是参数的名字,示例如下:
1 | <button bindtap="btnHandler" data-info={{2}}> |
最终
- info会被解析成参数的名字
- 数值2会解析为参数的值
在事件函数中,通过event.target.dataset.参数名即可获取到具体参数的值,实例如下
1 | btnHandler(event){ |
如果想实现一个+2按钮,js文件中btnHandler函数改为
1 | btnHandler(e){ |
8. bindinput的语法格式
在小程序中,通过input事件来响应文本框的输入事件,语法格式如下:
- 通过bindinput,可以为文本框绑定输入事件
1 | <input bindinput="inputHandler"></input> |
- 在页面的js文件中定义事件处理函数:
1 | inputHandler(e){ |
9. 文本框和data的数据同步
步骤:
- 定义数据
- 渲染结构
- 美化样式
- 绑定input事件处理函数
代码
1 | <input value="{{msg}}" bindinput="inputHandler"></input> |
1 | Page({ |
1 | input { |
条件渲染
1. wx:if
在小程序中,使用wx:if="{{condition}}"
来判断是否需要渲染该代码块,
也可以用wx:elif
和wx:else
来添加else判断。
1 | <view wx:if="{{type===1}}">男</view> |
2. 结合<block>使用wx:if
如果要一次性控制多个组件的显示和隐藏,可以使用一个block标签将多个组件包装起来,并在block标签上使用wx:if控制属性,示例如下:
1 | <block wx:if="{{true}}"> |
注意
:block并不是一个组件,只是一个包裹性质的容器,不会在页面中做任何渲染。
3. hidden
直接用hidden=”“也能控制元素的显示和隐藏。
1 | <view hidden="{{condtion}}">条件为true隐藏,条件为false显示</view> |
列表渲染
1. wx:for
通过wx:for可以根据指定的数组,循环渲染重复的组件结构
1 | <view wx:for="{{array}}"> |
举例:
js文件
1 | Page({ |
wxml文件
1 | <view wx:for="{{arr1}}"><!--提高效率可以加入属性wx:key="index"--> |
2. 手动指定索引和当前项的变量名*
- 使用wx:for-index可以指定
当前循环项索引
的变量名 - 使用wx:for-item可以指定
当前项
的变量名
示例如下
1 | <view wx:for="{{arr1}}" wx:for-index="idx" wx-for-item="itemName"> |
3.wx:key的使用
类似于Vue列表渲染中的:key,小程序在实现列表渲染时,也建议为渲染出来的列表项指定唯一的Key值,从而提高渲染的效率,示例代码如下:
1 | data:{ |
1 | <view wx:for="{{userList}}" wx:key="id">{{item.name}}</view> |
WXSS模板样式
什么是WXSS
WXSS(WeiXin Style Sheets)是一套样式语言,用于美化WXML的组件样式,类似于网页开发中的CSS。
WXSS和CSS的关系
WXSS扩展的特性:
- rpx尺寸单位
- @import样式导入
rpx尺寸单位
1. 什么是rpx尺寸单位
rpx(responsive pixel) 是微信小程序独有的,用来解决屏适配的尺寸问题。
2. rpx的实现原理
鉴于不同设备的屏幕大小不同,为了实现屏幕的自动适配,rpx把所有设备的屏幕,在宽度上等分为750份(即当前屏幕的总宽度为750rpx)
3. rpx和px之间的单位换算
在iPhone6中,
$$
1rpx=0.5px
$$
$$
1px=2rpx
$$
样式导入
1. 什么是样式导入
使用wxss提供的@import语法,可以导入外联的样式表。
2. @import的语法格式
@import后跟需要导入的外联样式表的相对路径,用 ; 语句表示结束。示例如下:
新建一个common文件夹,里面新建common.wxss文件
1 | .username{ |
在index.wxss文件中引入样式表
1 | @import "/common/common.wxss"; |
最后在index.wxml里面引入类型看是否成功。
全局样式和局部样式
1. 全局样式
定义在app.wxss中的样式为全局样式,作用于每一个页面。
2. 局部样式
在页面的wxss文件中定义的样式,只作用于当前页面。
当全局样式和局部样式权重(将光标停留在样式名称上时显示)一样时,优先显示局部样式,否则显示权重较大的样式。
全局配置
全局配置文件及常用的配置项
小程序根目录下的app.json
文件是小程序的全局配置文件。常用的配置如下:
- pages
- 记录当前小程序页面的存放路径
- window
- 全局设置小程序窗口的外观
- tabBar
- 设置小程序底部的tabBar效果
- style
- 是否启用新版的组件样式
window
1. 小程序窗口的组成部分
![](https://s1.ax1x.com/2023/08/31/pP0CMSP.jpg)
其中,window可以配置导航栏区域和背景区域。
微信小程序开发-模板与配置