前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >微信小程序:WXML模板语法

微信小程序:WXML模板语法

作者头像
岳泽以
发布2023-03-17 08:30:18
2K0
发布2023-03-17 08:30:18
举报
文章被收录于专栏:岳泽以博客岳泽以博客

数据绑定

数据绑定基本原则

  1. data中定义数据
  2. WXML中使用数据

在data中定义页面的数据

在页面对应的.js文件中,把数据定义到data对象中即可:

代码语言:javascript
复制
Page({
  data: {
    //字符串类型的数据
    info:'init data',
    //数组类型的数据
    msgList:[{msg:'hello'},{msg:'world'}]
  },
})

Mustache语法的格式

把data中的数据绑定到页面中渲染,使用Mustache语法(双大括号)将变量包起来即可。

主要应用场景:

  • 绑定内容
  • 绑定属性
  • 运算(三元运算、算术运算等)
动态绑定内容
代码语言:javascript
复制
<view>{{要绑定的数据名称}}</view>
动态绑定属性

页面的数据如下:

代码语言:javascript
复制
Page({
  data: {
    imgSrc:'/images/1.png'
  },
})  

页面的结构如下:

代码语言:javascript
复制
<image src="{{imgSrc}}">
三元运算
算数运算

页面的数据如下:

代码语言:javascript
复制
Page({
  data: {
    randomNum2:Math.random().toFixed(2),
  },
})

页面的结构如下:

代码语言:javascript
复制
<view>{{randomNum2 * 100}}</view>

事件绑定

事件是渲染层到逻辑层的通讯方式。通过事件可以将用户在渲染层产生的行为,反馈到逻辑层进行业务的处理。

小程序中常用的事件

类型

绑定方式

事件描述

tap

bindtap或bingd:tap

手指触摸后马上离开,类似于HTML中的click事件

input

bindinput或bind:input

文本框的输入事件

change

bindchange或bind:change

状态改变时触发

事件对象的属性列表

当事件回调触发的时候,会收到一个事件对象event,它的详细属性如下表所示:

属性

类型

说明

type

String

事件类型

timeStamp

Integer

页面打开到触发事件所经过的毫秒数

target

Object

触发事件的组件的一些属性值集合

currentTarget

Object

当前组件的一些属性值集合

detail

Object

额外的信息

touches

Array

触摸事件,当前停留在屏幕中的触摸点信息的数组

changedTouches

Array

触摸事件,当前变化的触摸点信息的数组

target和currentTarger的区别

target是触发该事件的源头组件,而currentTarget则是当前事件所绑定的组件。

点击内部的按钮时,点击事件以冒泡的方式向外扩撒,也会触发外层viewtap事件处理函数。

此时,对于外层的view来说:

  • e.target指向的是触发事件的源头组件,因此,e.target是内部的按钮组件
  • e.currentTarget指向的是当前正在触发事件的哪个组件,因此,e.currentTarget是当前的view组件

bindtap的语法格式

在小程序中,不存在HTML中的onclick鼠标点击事件,而是通过tap事件来相应用户的触摸行为。

  1. 通过bindtap,可以为组件绑定tap触摸事件,语法格式如下:
代码语言:javascript
复制
<button type="primary" bindtap="btnTapHandler">按钮</button>
  1. 在页面的.js文件中定义对应的事件处理函数,事件参数通过形参event(一般简写e)来接收:
代码语言:javascript
复制
Page({
  btnTapHandler(e){ //按钮的tap事件处理函数
    console.log(e) //事件参数对象e
  }
})

在事件处理函数中为data中的数据赋值

通过调用this.seData(dataObject)方法,可以给页面data中的数据重新赋值,示例如下:

代码语言:javascript
复制
Page({
  data:{
    count:0
  },
  //修改count的值
  changeCount(){
    this.setData({
      count:this.data.count+1
    })
  }
})

页面结构:

代码语言:javascript
复制
<button type="primary" bindtap="changeCount">+1</button>

事件传参

小程序中的事件传参比较特殊,不能在绑定事件的同时为事件处理函数传递参数。例如,下面的代码将不能正常工作:

代码语言:javascript
复制
<button type="primary" bindtap="btnTapHandler(123">事件传参</button>

因为小程序会把bindtap的属性值,统一当作事件名称来处理,相当于要调用一个名称为btnHandler(123)的事件处理函数。

可以为组件提供data-参数名字自定义属性传参,示例如下:

代码语言:javascript
复制
<button bindtap="btnHandler" data-info="{{2}}">事件传参</button>

最终:

  • info会被解析为参数的名字
  • 数值2会被解析为参数的值

在事件处理函数中,通过event.target.dataset.参数名即可获取到具体参数值。

代码语言:javascript
复制
  btnHandler(e){
    console.log(e.target.dataset);
    console.log(e.target.dataset.info);
  }

传参并且count自增加2

代码语言:javascript
复制
  btnHandler(e){
    this.setData({
      count:this.data.count+e.target.dataset.info
    })
  }

bindinput的语法格式

在小程序中,通过input事件来响应文本框的输入事件,语法格式如下:

  1. 通过bindinput,可以为文本框绑定输入事件:
代码语言:javascript
复制
<input bindinput="inputHandler"/>
  1. 在页面的.js文件中定义事件处理函数:
代码语言:javascript
复制
  inputHandler(e){
    //e.detail.value是变化过后,文本框最新的值
    console.log(e.detail.value);
  }

实现文本框和data之间的数据同步

实现步骤:

  1. 定义数据
代码语言:javascript
复制
Page({ 
  data:{
    msg:'你好,'
  },
})  
  1. 渲染结构
代码语言:javascript
复制
<input value="{{msg}}" bindinput="iptHandler"/>
  1. 美化样式
代码语言:javascript
复制
input{
  border: 1px solid #eee;
  padding: 5px;
  margin: 5px;
  border-radius: 3px;
}
  1. 绑定input事件处理函数
代码语言:javascript
复制
  iptHandler(e){
    this.setData({
      msg:e.detail.value
    })
  }

条件渲染

wx:if

在小程序中,使用wx:if="{condition}"来判断是否需要渲染该代码块:

代码语言:javascript
复制
<view wx:if="{{condition}}">
  True
</view>

也可以用wx:elif和wx:else来添加else判断:

代码语言:javascript
复制
<view wx:if="{{type===1}}">
  男
</view>
<view wx:elif="{{type===2}}">
  女
</view>
<view wx:else>
 保密
</view>

结合<block>使用wx:if

如果要一次性控制多个组件的展示与隐藏,可以使用一个<block></block> 标签将多个组件包装起来,并在<block>标签上使用wx:if控制属性,示例如下:

代码语言:javascript
复制
<block wx:if="{{true}}">
  <view>
    view1
  </view>
  <view>
    view2
  </view>
</block>

注意:block并不是一个组件,它只是一个包裹性质的容器,不会在页面中做任何渲染。

hidden

在小程序中,直接使用hidden="{{condition}}"也能控制元素的显示与隐藏。

代码语言:javascript
复制
<view hidden="{{condition}}">
  条件为true的时候隐藏元素,否则显示
</view>

wx:if与hidden的对比

运行方式不同

  • wx:if以动态创建和移除元素的方式,控制元素的展示与隐藏
  • hidden以切换样式的方式(display:none/block),控制元素的显示与隐藏

使用建议

  • 频繁切换时,建议使用hidden
  • 控制条件复杂时,建议使用wx:if搭配wx:elifwx:else进行展示与隐藏的切换

列表渲染

wx:for

通过wx:for可以根据指定的数组,循环渲染重复的组件结构,语法示例如下:

代码语言:javascript
复制
<view wx:for="{{array}}">
  索引是:{{index}} 当前项是:{{item}}
</view>

默认情况下,当前循环项的索引用index表示,当前循环项用item表示。

页面数据:

代码语言:javascript
复制
  data:{
    arr1:['苹果','华为','小米']
  },

页面结构:

代码语言:javascript
复制
<view wx:for="{{arr1}}">
  索引是:{{index}} 当前项是:{{item}}
</view>

手动指定索引和当前项的变量名

  • 使用wx:for-index可以指定当前循环项的索引的变量名
  • 使用wx:for-item可以指定当前项的变量名

示例代码如下:

代码语言:javascript
复制
<view wx:for="{{arr1}}" wx:for-index="idx" wx:for-item="name">
  索引是:{{idx}}当前项是{{name}}
</view>

wx:key

类似于Vue列表渲染中的:key,小程序在实现列表渲染时,也建议为渲染出的列表项指定唯一的key值,从而提高渲染的效率,示例代码如下:

页面数据:

代码语言:javascript
复制
    userList:[
      {id:1,name:'小红'},
      {id:2,name:'小兰'},
      {id:3,name:'小分'},
    ]

页面结构:

代码语言:javascript
复制
<view wx:for="{{userList}}" wx:key="id">
  {{item.name}}
</view>
本文参与 腾讯云自媒体分享计划,分享自作者个人站点/博客。
原始发表:2023 年 03 月,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 作者个人站点/博客 前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 数据绑定
    • 在data中定义页面的数据
      • Mustache语法的格式
        • 动态绑定内容
        • 动态绑定属性
        • 三元运算
        • 算数运算
    • 事件绑定
      • 小程序中常用的事件
        • 事件对象的属性列表
          • target和currentTarger的区别
            • bindtap的语法格式
              • 在事件处理函数中为data中的数据赋值
                • 事件传参
                  • bindinput的语法格式
                    • 实现文本框和data之间的数据同步
                    • 条件渲染
                      • wx:if
                        • 结合<block>使用wx:if
                          • hidden
                            • wx:if与hidden的对比
                            • 列表渲染
                              • wx:for
                                • wx:key
                                相关产品与服务
                                云开发 CloudBase
                                云开发(Tencent CloudBase,TCB)是腾讯云提供的云原生一体化开发环境和工具平台,为200万+企业和开发者提供高可用、自动弹性扩缩的后端云服务,可用于云端一体化开发多种端应用(小程序、公众号、Web 应用等),避免了应用开发过程中繁琐的服务器搭建及运维,开发者可以专注于业务逻辑的实现,开发门槛更低,效率更高。
                                领券
                                问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档