微信小程序开发整理-mp1

一、基础常识

• app.json   全局json
• app.js   全局js
• app.wxss   全局样式
• project.config.json   公共的配置
• sitemap.json   界面索引，默认全部索引

二、常用的视图容器类组件

1、view

• 普通视图区域·
• 类似于HTML中的div，是一个块级元素
• 常用来实现页面的布局效果

2、scroll-view

• 可滚动的视图区域
• 常用来实现滚动列表效果

3、swiper和swiper-item

• 轮播图容器组件和轮播图item组件

4、通过text 组件的selectable属性，实现长按选中文本内容的效果:

<text selectable>XXXXXXXXXXXX</text>

•  渲染字符串

<rich-text nodes="<h1 style='color: red; '>标题</h1>"></rich-text>

5、button

<button type="primary" size="mini">点击登录</button>
<button type="warn" size="mini">警告</button>
<button type="primary" size="mini" plain>镂空样式</button>

6、img

• mode属性用来指定图片的裁剪和缩放模式

三、API

1、事件监听API

• 特点:以on开头，用来监听某些事件的触发
• 举例:wx.onWindowResize(function callback)监听窗口尺寸变化的事件

2、同步API

• 特点1∶以Sync结尾的API都是同步API
• 特点2∶同步API的执行结果，可以通过函数返回值直接获取，如果执行出错会抛出异常举例:wx.setStorageSync('key' , 'value')向本地存储中写入内容

3、异步API

• 特点:类似于jQuery 中的$.ajax(options)函数，需要通过success、fail、complete接收调用的结果举例: wx.request()发起网络数据请求，通过success回调函数接收数据

四、模板与配置

（一）、数据绑定

1、基本原则

• 在data中定义数据、在WXML中使用数据

2、绑定内容

Page({
    data: i
    //字符串类型的数据
    info: 'init data',
    //数组类型的数据
    msglist:[{msg: 'hello'}，{msg: 'world')])
})

•  Mustache语法（双大括号)     插值表达式

<view>{{要绑定的数据名称}}</view>

Mustache语法的主要应用场景如下︰

• 绑定内容
• 绑定属性
• 运算（三元运算、算术运算等)

3、绑定属性

Page({
    data:{
    imgsrc: 'http: / /ww.itheima. com/images/logo.png'
   }
})

<image src="{{imgSrc)}"></image>

4、运算

Page({
    data:{
    randomNum: Math.random() * 10 //生成 10 以内的随机数
   }
})

<view>{{randomNumber >= 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	lnteger	页面打开到触发事件所经过的毫秒数
target	object	触发事件的组件的一些属性值集合
currentTarget	object	当前组件的一些属性值集合
detail	object	额外的信息
touches	Array	触摸事件，当前停留在屏幕中的触摸点信息的数组
changedTouches	Array	触摸事件，当前变化的触摸点信息的数组

 4、target和currentTarget 的区别

target是触发该事件的源头组件，而 currentTarget则是当前事件所绑定的组件。举例如下:

<view class="outer-view" bindtap="outerHandler">
<button type="primary">按钮</button>
</view>

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

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

5、bindtap的语法格式

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

    (1)通过bindtap，可以为组件绑定tap触摸事件，语法如下:

<button type=""primary" bindtap=""btnTapHandler">按钮</button>

    (2)在页面的.js文件中定义对应的事件处理函数，事件参数通过形参event(一般简写成e）来接收:

Page({
    btnTapHandler(e){ //按钮的 tap事件处理函数
    console.log(e)  //事件参数对象e
    }
})

（三）、事件传参与数据同步

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

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

//页面的.js 文件
Page({
    data:{
        count: 0
    },
    //修改count 的值
    changeCount() {
        this.setData({
            count: this.data.count + 1
        })
    }
})

2、事件传参

注意：小程序中的事件传参比较特殊，不能在绑定事件的同时为事件处理函数传递参数。

可以为组件提供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)
}

3、文本框和data之间的数据同步

（四）、渲染

1、条件渲染

<view wx:if="{{icondition}}"> True </view>

<view wx:if="{{type ===1}}">男</view>
<view wx:elif="{{type === 2}}">女</view>
<view wx:else>保密</view>

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

<block wx:if="{{true}}">
    <view> view1 </view>
    <view> view2 </view>
</block>

• hidden

<view hidden="{{ condition }}">条件为true隐藏，条件为 false 显示</view>

wx:if 与hidden的对比:

• 运行方式不同

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

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

2、列表渲染

通过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>

五、补充：协同工作与发布

（一）、协同工作

1、权限管理

2、人员组成

项目管理者、产品组（提需求）、设计组（出设计方案）、开发组（代码开发）、测试组（项目测试）

（二）、发布