- app.json 全局json
- app.js 全局js
- app.wxss 全局样式
- project.config.json 公共的配置
- sitemap.json 界面索引,默认全部索引
<text selectable>XXXXXXXXXXXXtext>
<rich-text nodes="标题
">rich-text>
- <button type="primary" size="mini">点击登录button>
- <button type="warn" size="mini">警告button>
- <button type="primary" size="mini" plain>镂空样式button>
- Page({
- data: i
- //字符串类型的数据
- info: 'init data',
- //数组类型的数据
- msglist:[{msg: 'hello'},{msg: 'world')])
- })
<view>{{要绑定的数据名称}}view>
Mustache语法的主要应用场景如下︰
- 绑定内容
- 绑定属性
- 运算(三元运算、算术运算等)
- Page({
- data:{
- imgsrc: 'http: / /ww.itheima. com/images/logo.png'
- }
- })
<image src="{{imgSrc)}">image>
- Page({
- data:{
- randomNum: Math.random() * 10 //生成 10 以内的随机数
- }
- })
<view>{{randomNumber >= 5 ?'随机数字大于或等于5'︰'随机数字小于5'}}view>
事件是渲染层到逻辑层的通讯方式。通过事件可以将用户在渲染层产生的行为,反馈到逻辑层进行业务的处理。
| 类型 | 绑定方式 | 事件描述 |
| tap | bindtap 或 bind:tap | 手指触摸后马上离开,类似于HTML中的click事件 |
| input | bindinput 或 bind:input | 文本框的输入事件 |
| change | bindchange 或 bind:change | 状态改变时触发 |
当事件回调触发的时候,会收到一个事件对象event,它的详细属性如下表所示:
| 属性 | 类型 | 说明 |
| type | String | 事件类型 |
| timeStamp | lnteger | 页面打开到触发事件所经过的毫秒数 |
| target | object | 触发事件的组件的一些属性值集合 |
| currentTarget | object | 当前组件的一些属性值集合 |
| detail | object | 额外的信息 |
| touches | Array | 触摸事件,当前停留在屏幕中的触摸点信息的数组 |
| changedTouches | Array | 触摸事件,当前变化的触摸点信息的数组 |
target是触发该事件的源头组件,而 currentTarget则是当前事件所绑定的组件。举例如下:
- <view class="outer-view" bindtap="outerHandler">
- <button type="primary">按钮button>
- view>
点击内部的按钮时,点击事件以冒泡的方式向外扩散,也会触发外层view的 tap事件处理函数。
在小程序中,不存在HTML中的onclick鼠标点击事件,而是通过tap事件来响应用户的触摸行为。
(1)通过bindtap,可以为组件绑定tap触摸事件,语法如下:
<button type=""primary" bindtap=""btnTapHandler">按钮button>
(2)在页面的.js文件中定义对应的事件处理函数,事件参数通过形参event(一般简写成e)来接收:
- Page({
- btnTapHandler(e){ //按钮的 tap事件处理函数
- console.log(e) //事件参数对象e
- }
- })
通过调用this.setData(dataObject)方法,可以给页面data中的数据重新赋值,示例如下:
- //页面的.js 文件
- Page({
- data:{
- count: 0
- },
- //修改count 的值
- changeCount() {
- this.setData({
- count: this.data.count + 1
- })
- }
- })
注意:小程序中的事件传参比较特殊,不能在绑定事件的同时为事件处理函数传递参数。
可以为组件提供data-*自定义属性传参,其中*代表的是参数的名字,示例代码如下:
<button bindtap="btnHandler" data-info="{{2}}">事件传参button>
在事件处理函数中,通过event.target.dataset.参数名即可获取到具体参数的值:
- btnHandler(event){
- // dataset是一个对象,包含了所有通过data-*传递过来的参数项
- console.log(event.target.dataset)
- //通过dataset可以访问到具体参数的值
- console.log(event.target. dataset.info)
- }
<view wx:if="{{icondition}}"> True view>
- <view wx:if="{{type ===1}}">男view>
- <view wx:elif="{{type === 2}}">女view>
- <view wx:else>保密view>
如果要一次性控制多个组件的展示与隐藏,可以使用一个
标签将多个组件包装起来,并在 标签上使用wx:if 控制属性,示例如下:
- <block wx:if="{{true}}">
- <view> view1 view>
- <view> view2 view>
- block>
<view hidden="{{ condition }}">条件为true隐藏,条件为 false 显示view>
wx:if 与hidden的对比:
- 运行方式不同
wx:if 以动态创建和移除元素的方式,控制元素的展示与隐藏
hidden 以切换样式的方式(display: none/block;),控制元素的显示与隐藏
- 使用建议
频繁切换时,建议使用hidden
控制条件复杂时,建议使用wx:if 搭配 wx:elif、wx:else进行展示与隐藏的切换
通过wx:for可以根据指定的数组,循环渲染重复的组件结构,语法示例如下:
- <view wx : for=" {{array}}">
- 索引是: {{index}}当前项是: {{item}}
- view>
手动指定索引和当前项的变量名*
使用wx:for-index 可以指定当前循环项的索引的变量名
使用wx:for-item可以指定当前项的变量名
- <view wx:for="{{array}}" wx:for-index="idx" wx:for-item="itemName">
- 索引是: {{idx}}当前项是:{{itemName}}
- view>
wx:key的使用
类似于Vue列表渲染中的:key,小程序在实现列表渲染时,也建议为渲染出来的列表项指定唯一的 key值,从而提高渲染的效率,示例代码如下:
- data: {
- userList: [
- { id: 1,name: '小红’},
- { id: 2,name: '小黄'},
- { id: 3,name: '小白’}
- ]
- }
-
-
- //wxml结构
- <view wx:for="{{userList}}" wx:key="id">{{item.name}}view>
项目管理者、产品组(提需求)、设计组(出设计方案)、开发组(代码开发)、测试组(项目测试)