小程序中的自定义组件以及组件通信、数据共享、插槽、behaviors

一、创建组件和使用自定义组件

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并引入路径,此时所有页面都可以使用<my-test>标签

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">+1</button>


	/**
	 * 组件的初始数据
	 */
	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">R</button>
<button size="mini" type="primary" bindtap="btn2">G</button>
<button size="mini" type="warn" bindtap="btn3">B</button>


	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结构中,可以提供一一个<slot>节点(插槽),用于承载组件使用者提供的wxml结构。

2.单个插槽

在小程序中,默认每个自定义组件中只允许使用一一个<slot>进行占位,这种个数上的限制叫做单个插槽。

<view>
	<view>
		我是test组件内容
	</view>
	<slot></slot>
</view>


<my-test4>
<view>我是index页面内容将会显示在my-test4组件页面的插槽区域</view>
</my-test4>

3.启用多个插槽

在小程序的自定义组件中,需要使用多<slot>插槽时,可以在组件的.js文件中,通过如下方式进行启用。

可以在组件的.wxml中使用多个<slot>标签,以不同的name来区分不同的插槽。

在使用带有多个插槽的自定义组件时,需要用slot属性来将节点插入到不同的<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()
},

九、behaviors

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属性名同名的字段覆盖规则,请参考官方文档

behaviors | 微信开放文档 


 

  • 1
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
抖音小程序behaviors是一种行为的定义方式,可以将一些常用的行为抽象出来,然后在多个组件复用。通过behaviors,可以在组件定义一些公共的属性、方法和生命周期函数,然后在需要使用这些行为的组件引用该behaviors。引用\[1\]的文档提供了详细的步骤来配置behaviors。在父组件的js文件,可以定义一个函数,并通过自定义事件的形式传递给子组件\[2\]。在子组件的js文件,可以通过调用this.triggerEvent()方法将数据发送到父组件\[2\]。在父组件的js文件,可以通过e.detail获取子组件传递过来的数据\[2\]。此外,可以使用this.selectComponent()方法获取子组件的实例对象,从而直接访问子组件的任意数据和方法\[2\]。在小程序组件,可以使用data节点定义组件的私有数据,methods节点定义事件处理函数和自定义方法,properties节点定义组件的对外属性\[3\]。data更倾向于存储组件的私有数据,而properties更倾向于存储外界传递到组件的数据\[3\]。可以使用setData方法修改properties的值\[3\]。此外,小程序组件还支持数据监听器,用于监听和响应属性和数据字段的变化\[3\]。通过定义数据监听器,可以在属性或数据字段发生变化时执行特定的操作\[3\]。 #### 引用[.reference_title] - *1* [小程序 | 案例---自定义tabBar](https://blog.csdn.net/muziqwyk/article/details/127325168)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^control_2,239^v3^insert_chatgpt"}} ] [.reference_item] - *2* *3* [小程序自定义组件](https://blog.csdn.net/m0_58190023/article/details/129699536)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v91^control_2,239^v3^insert_chatgpt"}} ] [.reference_item] [ .reference_list ]

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值