1.创建组件
①在项目的根目录中,鼠标右键,创建components -> 文件夹
②在新建的components -> 文件夹上,鼠标右键,点击“新建Component'
③键入组件的名称之后回车,会自动生成组件对应的4个文件,后缀名分别为js, json,.wxml 和.wxss
2.组件引用
组件的引用方式分为“局部引用”和“全局引用”
局部引用:组件只能在当前被引用的页面内使用
全局引用:组件可以在每个小程序页面中使用
3.局部引用组件
在页面的json配置文件中引用组件的方式,叫做“局部引用”。
- //首先在要需要引入的页面的.json文件引入
- "usingComponents": {
- "my-test":"../../components/test/test"
- },
-
-
- 然后在引入的.wxml文件定义自定义标签
- <my-test>my-test>
4.全局引用
在app.json全局配置文件中引用组件的方式,叫做“全局引用”。
在app.json文件内window平级定义usingComponents并引入路径,此时所有页面都可以使用
5.组件和页面的区别
从表面来看,组件和页面都是由js、json、.wxml 和.WxSS这四个文件组成的。但是,组件和页面的.js与json文件有明显的不同:
●组件的 .json文件中需要声明"component": true属性
●组件的js文件中调用的是Component()函数
●组件的事件 处理函数需要定义到methods节点中
1.组件样式隔离的注意点
app.wxss中的全局样式对组件无效
只有class选择器会有样式隔离效果, id选择器、属性选择器、标签选择器不受样式隔离的影响
建议:在组件和引用组件的页面中建议使用class选择器,不要使用id、属性、标签选择器!
2.修改组件的样式隔离选项
默认情况下,自定义组件的样式隔离特性能够防止组件内外样式互相干扰的问题。但有时,我们希望在外界能够控制组件内部的样式,此时,可以通过stylelsolation修改组件的样式隔离选项,用法如下:
styleIsolation的可选值

1.data数据
在小程序组件中,用于组件模板渲染的私有数据,需要定义到组件的data节点中。
2.methods方法
在小程序组件中,事件处理函数和自定义方法需要定义到methods节点中。
- <view>
- {{count}}
- view>
- <button bindtap="addCount">+1button>
-
-
- /**
- * 组件的初始数据
- */
- data: {
- count:0
- },
-
- /**
- * 组件的方法列表
- */
- methods: {
- addCount(){
- this.setData({
- count:this.data.count+1
- }),
- this._showCount()
- },
- // 自定义方法弹出提示
- _showCount(){
- wx.showToast({
- title: 'count的值是'+this.data.count,
- icon:"none"
- })
- }
- }
3.properties属性
在小程序组件中,properties 是组件的对外属性,用来接收外界传递到组件中的数据。
- <my-test max="10">my-test>
-
-
- /**
- * 组件的属性列表
- */
- properties: {
- // 第一种简化定义属性,不需要指定默认值时可以使用
- max:Number,
- // 第二种,当需要指定默认值时,建议使用这种
- max:{
- type:Number,
- value:10 //属性默认值,如果传值会默认被覆盖掉
- }
- },
-
-
- methods: {
- addCount(){
- // 判断如果自增的值大于等于定义的max的值,就停止
- if(this.data.count>=this.properties.max)return
- this.setData({
- count:this.data.count+1
- }),
- this._showCount()
- },
- // 自定义方法弹出提示
- _showCount(){
- wx.showToast({
- title: 'count的值是'+this.data.count,
- icon:"none"
- })
- }
- }
4.data和properties的区别
在小程序的组件中,properties 属性和data数据的用法相同,它们都是可读可写的,两者全等。
●data 更倾向于存储组件的私有数据
●properties更倾向于存储外界传递到组件中的数据
数据监听器用于监听和响应任何属性和数据字段的变化,从而执行特定的操作。它的作用类似于vue中的watch侦听器。
- //methods平级,监听的多个参数可以通过,分隔开
- observers:{
- "n1,n2":function(val1,val2){
- this.setData({
- sum:val1+val2
- })
- }
- }
监听对象属性的变化
数据监听器支持监听对象中单个或多个属性的变化(可以监听对象中的某一属性的变化,也可以今天整个对象)
- //methods平级,监听的多个参数可以通过,分隔开
- observers:{
- "obj.n1,obj.n2":function(val1,val2){
- this.setData({
- sum:val1+val2
- })
- }
- }
监听对象中所有属性的变化
如果某个对象中需要被监听的属性太多,为了方便,可以使用通配符**来监听对象中所有属性的变化。
- <view class="colorBox" style="background-color:rgb({{fullColor}})">
- 颜色值{{fullColor}}
- view>
- <button size="mini" type="default" bindtap="btn1">Rbutton>
- <button size="mini" type="primary" bindtap="btn2">Gbutton>
- <button size="mini" type="warn" bindtap="btn3">Bbutton>
-
-
- data: {
- rgb:{
- r:0,
- g:0,
- b:0,
- },
- fullColor:"0,0,0"
- },
- methods:{
- btn1(){
- this.setData({
- "rgb.r":this.data.rgb.r+5>255?255:this.data.rgb.r+5
- })
- },
- btn2(){
- this.setData({
- "rgb.g":this.data.rgb.g+5>255?255:this.data.rgb.g+5
- })
- },
- btn3(){
- this.setData({
- "rgb.b":this.data.rgb.b+5>255?255:this.data.rgb.b+5
- })
- },
- },
- observers:{
-
- "rgb.**":function(rgb){
- this.setData({
- fullColor:`${rgb.r},${rgb.g},${rgb.b}`
- })
- }
- }
纯数据字段指的是那些不用于界面渲染的data字段。
应用场景:例如有些情况下,某些data中的字段既不会展示在界面上,也不会传递给其他组件,仅仅在当前组件内部使用。带有这种特性的data字段适合被设置为纯数据字段。
好处:纯数据字段有助于提升页面更新的性能。
使用规则:
在Component构造器的options节点中,指定pureDataPattern为-个正则表达式,字段名符合这个正则表达式的字段将成为纯数据字段,示例代码如下:
- Component({
- options:{
- //指定所有_开头的数据字段为纯数据字段
- pureDataPattern:/^_/
-
- },
- data:{
- _b:true //纯数据字段
- }
-
- })
1.组件的生命周期函数
2.组件的主要生命周期函数
在小程序组件中,最重要的生命周期函数有3个,分别是created、attached.、detached。 它们各自的特点如下:
① 组件实例刚被创建好的时候,created 生命周期函数会被触发
●此时还不能调用setData
●通常在这个生命周期函数中,只应该用于给组件的this添加一-些自定义的属性字段
② 在组件完全初始化完毕、进入页面节点树后,attached生命周期函数会被触发
●此时, this.data已被初始化完毕
●这个生命周期很有用, 绝大多数初始化的工作可以在这个时机进行(例如发请求获取初始数据)
③在组件离开页面节点树后,detached 生命周期函数会被触发
●退出一个页面时, 会触发页面内每个自定义组件的detached生命周期函数
●此时适合做一 些清理性质的工作
3.lifetimes节点
在小程序组件中,生命周期函数可以直接定义在Component构造器的第一级参数中, 可以在lifetimes字段内进行声明(这是推荐的方式,其优先级最高)
- //methods平级
- lifetimes:{
- created(){
- console.log(111);
- },
- attached(){
- console.log(222);
- }
- }
4.组件所在页面的生命周期函数
有时,自定义组件的行为依赖于页面状态的变化,此时就需要用到组件所在页面的生命周期函数。

5.pageLifetimes节点
组件所在页面的生命周期函数,需要被定义在pageLifetimes节点中。
- Component({
-
- pageLifetimes:{
- show:function(){}
- hide:function(){}
- resize:function(){}
- }
-
- })
1.插槽
在自定义组件的wxml结构中,可以提供一一个
2.单个插槽
在小程序中,默认每个自定义组件中只允许使用一一个
- <view>
- <view>
- 我是test组件内容
- view>
- <slot>slot>
- view>
-
-
- <my-test4>
- <view>我是index页面内容将会显示在my-test4组件页面的插槽区域view>
- my-test4>
3.启用多个插槽
在小程序的自定义组件中,需要使用多
可以在组件的.wxml中使用多个
在使用带有多个插槽的自定义组件时,需要用slot属性来将节点插入到不同的
- Component({
- options:{
- multipleSlots:true //启用多slot支持
- }
- })
- <view>
- <view>
- 我是test组件内容
- view>
- <slot name="one">slot>
- <slot name="two">slot>
- view>
-
-
-
- <my-test4>
- <view slot="one">我是index页面内容将会显示在my-test4组件页面的插槽区域view>
- <view slot="two">
- 我是第二个
- view>
- my-test4>
① 属性绑定
用于父组件向子组件的指定属性设置数据,仅能设置json兼容的数据
② 事件绑定
用于子组件向父组件传递数据,可以传递任意数据
③ 获取组件实例
父组件还可以通过this.selectComponent()获取子组件实例对象
这样就可以直接访问子组件的任意数据和方法
1.属性绑定
属性绑定用于实现父向子传值,而且只能传递普通类型的数据,无法将方法传递给子组件。
子组件在properties节点中声明对应的属性并使用。
- <my-test4 count="{{count}}">my-test4>
- <view>
- 父组件中count值:{{count}}
- view>
-
- //子组件
- properties: {
- count:Number
- },
-
- <view>
- 子组件count值: {{count}}
- view>
2.事件绑定
事件绑定用于实现子向父传值,可以传递任何类型的数据。步骤如下:
①在父组件的js中,定义一个函数,这个函数即将通过自定义事件的形式,传递给子组件
- //bindsync自定义事件
- <my-test4 count="{{count}}" bindsync="syncCount">my-test4>
- <view>
- 父组件中count值:{{count}}
- view>
- //自定义函数,data平级
- syncCount(e){
- this.setData({
- count:e.detail.value
- })
- },
②在父组件的wxml中,通过自定义事件的形式,将步骤1中定义的函数引用,传递给子组件
③在子组件的js中,通过调用this.triggerEvent('自定义事件名称',{/*参数对象*/}) ,将数据发送到父组件
- methods: {
- addCount(){
- this.setData({
- count:this.properties.count+1
- }),
- this.triggerEvent("sync",{
- value:this.properties.count
- })
- }
- }
④在父组件的js中,通过e.detail获取到子组件传递过来的数据
3.获取组件实例
可在父组件里调用this.selectComponent("id或class选择器"),获取子组件的实例对象,从而直接访问子组件的任意数据和方法。调用时需要传入一个选择器,例如this.selectComponent(".my-component")。
- <my-test4 count="{{count}}" bindsync="syncCount" class="customA" id="cA">my-test4>
- <button bindtap="getChild">获取子组件的实例对象button>
-
- getChild(){
- const child=this.selectComponent(".customA")
- console.log(child);
- // 第一种子组件的值发生变化
- // child.setData({
- // count:child.properties.count+1
- // })
- // 第二种,父子组件都发生变化
- child.addCount()
- },
1.behaviors
behaviors是小程序中,用于实现组件间代码共享的特性,类似于Vue.js中的"mixins"。

2.behaviors的工作方式
每个behavior可以包含一组属性、 数据、生命周期函数和方法。组件引用它时,它的属性、数据和方法会被合并到组件中。
每个组件可以引用多个behavior, behavior 也可以引用其它behavior。
3.创建并使用behaviors
调用Behavior(Object object)方法即可创建一个共享的behavior实例对象,供所有的组件使用。
在组件中,使用require()方法导入需要的behavior,挂载后即可访问behavior中的数据或方法。
- //首先创建一个behaviors文件夹,在文件夹下创建my-behaviors.js文件
- module.exports=Behavior({
- data:{
- username:"zs"
- },
- properties:{},
- methods:{}
- })
-
-
- //在组件的.js文件Component同级定义变量接收
- const myBehaviors=require("../behaviors/my-behaviors")
- //然后在Component内定义
- behaviors:[myBehaviors],
- //最后页面可以直接渲染
- <view>
- behaviors文件定义的数据:{{username}}
- view>
4.behaviors中所有可用节点如下

5.behaviors属性名同名的字段覆盖规则,请参考官方文档