{"usingComponents": {"text1":"../components/text/text"}
}
建议:在组件和引用组件的页面中建议使用class选择器,不要使用id选择器、属性选择器、标签选择器
有时候是需要外界能够控制组件内部的样式,此时可以修改stylelsolation修改组件的样式隔离选项。
Component({options:{styleIsolation:"isolated"}
})
"styleisolation":"isolated"
默认是isolated,可选值有以下:
可选值 | 说明 |
---|---|
isolated | 表示启用样式隔离,在自定义组件内外,使用class指定的样式将不会相互影响 |
apply-shared | 表示页面wxss样式将影响到自定义组件,但自定义组件中wxss不会影响到页面 |
shared | 表示页面wxss会影响到自定义组件的样式,自定义组件的样式也会影响到页面和其他设置了apply-shared或 shared的自定义组件 |
是组件的对外属性,用来接收外界传递到组件中的数据,在方法中使用时是this.properties.max
properties:{max:{ //完整定义属性的方式【需要指定属性默认值时使用】type:Number, //默认值数据类型value:10},max:Number //简化定义属性的方式【不需要定义默认值时使用】}
在小程序的组件中,properties属性和data数据的用法相同,他们都是可读可写的,区别是:
data
更倾向于存储组件的私有数据properties
更倾向于存储外界传递到组件中的数据由于data数据和properties属性在本质上没有任何区别,因此properties属性的值也可以用于页面渲染,或使用setData为properties中的属性重新赋值
changeMax(){this.setData({max:this.properties.max+1})}
数据监听器用于监听和响应任何属性和数据字段的变化,从而执行特定的操作。它的作用类似于vue中的watch监听器。
监听字段的变化:
observers:{'字段A,字段B':function(字段A的新值,字段B的新值){// do something}}
data:{n1:1,n2:2,all:0},methods:{changeMax(){this.setData({max:this.properties.max+1,n1:this.data.n1+1,n2:this.data.n2+1,})}},observers:{'n1,n2':function(newn1,newn2){this.setData({all:newn1+newn2})}}
监听对象属性的变化:
observers:{'对象.属性A,对象.属性B':function(对象.属性A的新值,对象.属性A的新值){//触发此监听的三种情况://为属性A赋值,使用setData设置this.data.对象.属性A时触发//为属性B赋值,使用setData设置this.data.对象.属性B时触发//为对象赋值,使用setData设置this.data.对象时触发// do something}}
data:{jianting:{a:1,b:1,sun:0},},methods:{changeA(){this.setData({'jianting.a':this.data.jianting.a+1})},changeB(){this.setData({'jianting.b':this.data.jianting.b+1})}},observers:{'jianting.a,jianting.b':function(a,b){this.setData({'jianting.sun':a+b})}}
纯数据字段指的是那些不用于界面渲染的data字段。
应用场景:例如有些情况下,某些data中的字段既不会展示在界面上,也不会传递给其他组件,仅仅在当前组件内部使用。带有这种特性的data字段适合被设置为纯数据字段。
好处:纯数据字段有助于提升页面更新性能。
在Component构造器的options
节点中,指定pureDatapattern
为一个正则表达式,字段名符合这个正则表达式的字段将成为纯数据字段
// 指定所有以_开头的数据为纯数据字段options:{pureDataPattern:/^_/},data:{_b:1 //纯数据字段},
生命周期函数 | 说明 |
---|---|
created | 在组件实例刚刚被创建时执行 |
attached | 在组件实例进入页面节点树时执行 |
ready | 在组件在视图层布局完成后执行 |
moved | 在组件实例被移动到节点树另一个位置时执行 |
detached | 在组件实例被从页面节点树移除时执行 |
error | 每当组件方法抛出错误时执行 |
组件主要的生命周期函数主要有created、attached、detached
created
:组件实例刚被创建好的时候触发
attached
:在组件完全初始化完毕、进入页面节点树后触发
detached
在组件离开节点树后触发
生命周期函数定义在lifetimes字段中
lifetimes:{created(){}}
有时,自定义组件的行为依赖于页面的状态的变化,此时就需要用到组件所在页面的生命周期。
show
组件所在的页面被展示时执行hide
组件所在的页面被隐藏时执行resize
组件所在的页面尺寸变化时执行pageLifetimes
**节点中 pageLifetimes:{show(){}}
在自定义组件的wxml结构中,可以提供一个
节点(插槽),用于承载组件使用者提供的wxml结构。
作为组件的封装者在封装组件时,通过
提供的内容的占位符。
进行占位,这种个数上的限制叫做单个插槽。
这是通过插槽填充的内容
options:{multipleSlots:true},
标签,以不同的name来区分不同的插槽。
属性中。
这是通过插槽填充的内容1
这是通过插槽填充的内容2
{username}}">
// 组件内部.js文件进行接收properties:{username:String},
username的值是:{{username}}
在子组件中可以对接收的父组件的值进行修改
methods: {changeUser(){this.setData({username:this.properties.username + 1})}}
事件绑定,用于子组件向父组件传递数据,可以传递任意属性
1‘在父组件的js中,定义一个函数,这个函数即将通过自定义事件的形式,传递给子组件
syncUser(){console.log("传递username")}
2’ 在父组件的wxml中,通过自定义事件的形式,将步骤1中定义的函数引用,传递给子组件
{username}}" bind:sync="syncUser">
{username}}" bindsync="syncUser">
3‘在子组件的js中,通过调用this.triggerEvent('自定义事件名称',{/**参数对象/})
,将数据发送到父组件
changeUser(){this.setData({username:this.properties.username + 1})this.triggerEvent('sync',{value:this.properties.username})}
4’ 在父组件的js中,通过e.detail获取到子组件传递过来的数据
syncUser(e){console.log("传递username")this.setData({username:e.detail.value})}
this.selectComponent()
获取子组件实例对象,这样就可以直接访问子组件的任意数据和方法。可在父组件里调用this.selectComponent("id或class选择器")
,获取子组件的实例对象,从而直接访问子组件的任意数据和方法。调用时需要传入一个选择器,例如this.selectComponent(".my-commonent")
。{username}}" bind:sync="syncUser" class="zuzjian">
getUser(){const zizujian = this.selectComponent('.zuzjian')zizujian.setData({count:zizujian.data.count + 1})zizujian.changeUser()}
behaviors是小程序中,用于实现组件间代码共享的特性,类似于Vue.js中的“mixins”。每个 behaviors可以包含一组属性、数据、生命周期函数和方法。组件引用它是,它的属性和方法会被合并到组件中。每个组件可以引用多个 behavior, behavior也可以引用其他 behavior
module.exports = Behavior({data:{username:"lw"},properties:{},methods:{},behavior:{}
})
const myBehavior = require('../../behaviors/behavior1')
Component({
behavior:[myBehavior]
})