一、自定义组件-插槽
1.1、什么是插槽
在自定义组件的wxml结构中,可以提供一个<slot>节点(插槽),用于承载组件使用者提供的wxml结构
1.2、单个插槽
在小程序中,默认每个自定义组件中允许使用一个<slot>进行占位,这种个数上的限制叫做单个插槽
组件的封装者
<view class="wrapper"><view>这里是组件的内部节点</view><!-- 对于不确定的内容,可以使用<slot>进行占位,具体的内容由组件的使用者决定 --><slot></slot>
</view>
组件的使用者
<component-tag-name><!-- 这部分内容将被放置在组件<slot>的位置上 --><view>这里是插入到组件slot中的内容</view>
</component-tag-name>
1.3、启用多个插槽
在小程序的自定义组件中,需要使用多<slot>插槽时,可以在组件的.js文件中,通过如下方式进行启用
示例代码如下:
Component({options:{multipleSlots:true // 在组件定义时的选项启用多slot支持},properties:{/* ... */},methods:{/* ... */}
})
1.4、定义多个插槽
可以在组件的.wxml中使用多个<slot>标签,以不同的name来区分不同的插槽,示例代码如下:
组件模板
<view class="wrapper"><!-- name为before的第一个slot插槽 --><slot name="before"></slot><view>这是一段固定的文本内容</view><!-- name为after的第二个slot插槽 --><slot name="after"></slot>
</view>
1.5、使用多个插槽
在使用带有多个插槽的自定义组件时,需要用slot属性来将节点插入到不同的<slot>中,示例代码如下:
引用组件的页面模板
<component-tag-name><!-- 这部分内容将被放置在组件<slot name="before">的位置上 --><view slot="before">这里是插入到组件slot name="before"中的内容</view><!-- 这部分内容将被放置在组件<slot name="after">的位置上 --><view slot="after">这里是插入到组件slot name="after"中的内容</view>
</component-tag-name>
二、自定义组件-父子组件之间的通信
2.1、父子组件之间通信的3种方式
属性绑定:用于父组件向子组件的指定属性设置数据,仅能设置JSON兼容的数据
事件绑定:用于子组件向父组件传递数据,可以传递任意数据
获取组件实例:父组件还可以通过this.selectComponent()获取子组件实例对象,这样就可以直接访问子组件的任意数据和方法
2.2、属性绑定
属性绑定用于实现父向子传值,而且只能传递普通类型的数据,无法将方法传递给子组件,父组件的示例代码如下:
// 父组件的data节点
data:{count:0}
// 父组件的wxml结构
<my-test count="{{count}}"><my-test>
<view>-----</view>
<view>父组件中:count值为:{{count}}</view>
子组件在properties节点中声明对应的属性并使用,示例代码如下:
// 子组件的properties节点
properties:{count:Number
}
// 子组件的wxml结构
<text>子组件中,count值为:{{count}}<text>
2.3、事件绑定
事件绑定用于实现子向父传值,可以传递任何类型的数据,使用步骤如下:
1 在父组件的js中,定义一个函数,这个函数即将通过自定义事件的形式,传递给子组件// 在父组件定义的syncCount方法// 将来,这个方法会被传递给子组件,供子组件进行调用syncCount(){console.log('syncCount')},
2 在父组件的wxml中,通过自定义事件的形式,将步骤1中定义的函数引用,传递给子组件<!-- 使用bind:自定义事件名称 --><my-test count="{{count}}" bind:sync="syncCount"></my-test><!-- 或者bind后面直接写上自定义事件名称 --><my-test count="{{count}}" bindsync="syncCount"></my-test>
3 在子组件的js中,通过调用this.triggerEvent('自定义事件名称',{/*参数对象*/}),将数据发送到父组件// 子组件的wxml结构<text>子组件中,count值为:{{count}}</text><button type="primary" bindtap="addCount">+1</button>// 子组件的js代码methods:{addCount(){this.setData({count:this.properties.count+1})this.triggerEvent('sync',{value:this,properties.count})}}
4 在父组件的js中,通过e.detail获取到子组件传递过来的数据syncCount(e){this.setData({count:e.detail.value})}
2.4、获取组件实例
可在父组件里调用this,selectComponent("id或class选择器"),获取子组件的实例对象,从而直接访问子组
件的任意数据和方法,调用时需要传入一个选择器,例如this.selectComponent(".my-component")
<my-test count="{{count}}" bind:sync="syncCount" class="customA" id="cA"></my-test>
<button bindtap="getChild">获取子组件实例</button>
getChild(){ // 按钮的tap事件处理函数// 切记下面参数不能传递标签选择器"my-test",不然返回的是nullconst child = this.selectComponent('.customA') // 也可以传递id选择器#cAchild.setData({count:child.properties.count+1}) // 调用子组件的setData方法child.addCount() // 调用子组件的addCount方法
}
三、自定义组件-behaviors
3.1、什么是behaviors
behaviors是小程序中,用于实现组件间代码共享的特性,类似于Vue.js中的"mixins"
3.2、behaviors的工作方式
每个behavior可以包含一组属性、数据、生命周期函数和方法,组件引用它时,它的属性、数据和方法会被合并到组件中每个组件可以引用多个behavior,behavior也可以引用其他behavior
3.3、创建behavior
调用Behavior(Object object)方法即可创建一个共享的behavior实例对象,供所有的组件使用:
// 调用Behavior()方法,创建实例对象
// 并使用module.exports将behavior实例对象共享出去
module.exports=Behavior({// 属性节点properties:{},// 私有数据节点data:{username:'zs'},// 事件处理函数和自定义方法节点methods:{},// 其他节点...
})
3.4、导入并使用behavior
在组件中,使用require()方法导入需要的behavior,挂载后即可访问behavior中的数据或方法,示例代码如下:
// 1 使用require()导入需要的自定义behavior模块
const myBehavior=require("../../behaviors/my-behavior")
Component({// 2 将导入的behavior实例对象,挂载到behaviors数组节点中,即可生效behaviors:[myBehavior],// 组件的其他节点...
})
3.5、behavior中所有可用的节点
可用的节点 类型 是否必填 描述
properties Object Map 否 同组件的属性
data Object 否 同组件的数据
methods Object 否 同自定义组件的方法
behaviors String Array 否 引入其他的behavior
created Function 否 生命周期函数
attached Function 否 生命周期函数
ready Function 否 生命周期函数
moved Function 否 生命周期函数
detached Function 否 生命周期函数
3.6、同名字段的覆盖和组合规则
组件和它引用的behavior中可以包含同名的字段,此时可以参考如下3种同名的处理规则
1 同名的数据字段(data)
2 同名的属性(properties)或方法(methods)
3 同名的生命周期函数
关于详细的覆盖和组合规则,大家可以参考微信小程序官方文档给出的说明
四、使用npm包
小程序对npm的支持与限制:
目前,小程序已经支持使用npm安装第三方包,从而提高小程序的开发效率,但是,在小程序中使用
npm包有如下3个限制:
1 不支持依赖于Node.js内置库的包
2 不支持依赖于浏览器内置对象的包
3 不支持依赖于C++插件的包
五、使用npm包-Vant Weapp
5.1、什么是Vant Weapp
Vant Weapp是有赞前端团队开发的一套小程序UI组件库,助力开发者快速搭建小程序应用,它所使用的是
MIT开源许可协议,对商业使用比较友好
官方文档地址:https://youzan.github.io/vant-weapp
5.2、安装Vant组件库
在小程序项目中,安装Vant组件库主要分为如下3步:
1 通过npm安装npm i @vant/weapp -S --production
2 构建npm包
3 修改app.json
5.3、使用Vant组件
安装完Vant组件库之后,可以在app.json的usingComponents节点中引入需要的组件,即可在wxml中
直接使用组件,示例代码如下:
"usingComponents": {"van-button":"@vant/weapp/button/index"
}
<van-button type="primaty">按钮</van-button>
5.4、定制全局主题样式
在app.wxss中,写入css变量,即可对全局生效:
page{/* 定制警告按钮的背景颜色和边框颜色 */--button-danger-background-color:#C00000;--button-danger-border-color:#D60000;
}
六、使用npm包-API Promise化
6.1、基于回调函数的异步API的缺点
默认情况下,小程序官方提供的异步API都是基于回调函数实现的,例如,网络请求的API需要按照如下的方式调用:
wx.request({method:'',url:'',data:{},success:()=>{}, // 请求成功的回调函数fail:()=>{}, // 请求失败的回调函数complete:()=>{} // 请求完成的回调函数
})
6.2、什么是API Promise化
API Promise化,指的是通过额外的配置,将官方提供的。基于回调函数的异步API,升级改造为基于
Promise的异步API,从而提高代码的可读性、维护性,避免回调地狱的问题
6.3、实现API Promise化
在小程序中,实现API Promise化主要依赖于miniprogram-api-promise这个第三方的npm包,它的安装
和使用步骤如下:
npm install --save miniprogram-api-promise@1.0.4
// 在小程序入口文件中(app.js),只需调用一次promisifyAll()方法
// 即刻实现异步API的Promise化
import {promisifyAll} from 'miniprogram-api-promise'
const wxp=wx.p={}
promisifyAll(wx,wxp)
6.4、调用Promise化之后的异步API
async getInfo(){const {data:res}=await wx.p.request({method:"GET",url:"https://www.escook.cn/api/get",data:{name:'zs',age:100}})console.log(res)
},
<van-button type="danger" bindtap="getInfo">vant按钮</van-button>
七、全局数据共享
7.1、什么是全局数据共享
全局数据共享(又叫做:状态管理)是为了解决组件之间数据共享的问题
开发中常用的全局数据共享方案有:Vuex、Redux、MobX等
7.2、小程序中的全局数据共享方案
在小程序中,可使用mobx-miniprogram配合mobx-miniprogram-bindings实现全局数据共享,其中:
mobx-miniprogram用来创建Store实例对象
mobx-miniprogram-bindings用来把Store中的共享数据或方法,绑定到组件或页面中使用
八、全局数据共享-MobX
8.1、安装MobX相关的包
在项目中运行如下的命令,安装MobX相关的包:
npm install --save mobx-miniprogram@4.13.2 mobx-miniprogram-bindings@1.2.1
注意:MobX相关的包安装完毕之后,记得删除miniprogram_npm目录后,重新构建npm
8.2、创建MobX的Store实例
import {observable,action} from 'mobx-miniprogram'
export const store = observable({// 数据字段numA:1,numB:2,// 计算属性get sum(){return this.numA+this.numB},// actions方法,用来修改store中的数据updateNum1:action(function(step){this.numA+=step}),updateNum2:action(function(step){this.numB+=step}),
})
8.3、将Store中的成员绑定到页面中
// 页面的.js文件
import {createStoreBindings} from 'mobx-miniprogram-bindings'
import {store} from '../../store/store'
Page({onLoad:function(){ // 生命周期函数--监听页面加载this.storeBindings=createStoreBindings(this,{store,fields:['numA','numB','sum'],actions:['updateNum1']})},onUnload:function(){ // 生命周期函数--监听页面卸载this.storeBindings.destoyStoreBindings()}
})
8.4、在页面上使用Store中的成员
// 页面的.wxml结构
<view>{{numA}}+{{numB}}={{sum}}</view>
<van-button type="primary" bindtap="btnHandler1" data-step="{{1}}">numA+1</van-button>
<van-button type="danger" bindtap="btnHandler1" data-step="{{-1}}">numA-1</van-button>
// 按钮tap事件的处理函数
btnHandler1(e){this.updateNum1(e.target.dataset.step)}
8.5、将Store中的成员绑定到组件中
import {storeBindingsBehavior} from 'mobx-miniprogram-bindings'
import {store} from '../../store/store'
Component({behaviors:[storeBindingsBehavior], // 通过storeBindingsBehavior来实现自动绑定storeBindings:{store, // 指定要绑定的Storefields:{ // 指定要绑定的字段数据numA:()=>store.numA, // 绑定字段的第1种方式numB:(store)=>store.numB, // 绑定字段的第2种方式sum:'sum' // 绑定字段的第3种方式},actions:{ // 指定要绑定的方法updateNum2:'updateNum2'}}
})
8.6、在组件中使用Store中的成员
// 组件的.wxml结构
<view>{{numA}}+{{numB}}={{sum}}</view>
<van-button type="primary" bindtap="btnHandler2" data-step="{{1}}">numB+1</van-button>
<van-button type="danger" bindtap="btnHandler2" data-step="{{-1}}">numB-1</van-button>
// 组件的方法列表
methods:{btnHandler2(e){this.updateNum2(e.target.dataset.step)}
}