微信小程序——自定义组件的使用以及组件之间的传值
自定义组件
创建
- 在项目的根目录中,鼠标右键,创建
components
->test
文件夹 - 在新建的
components
->test
文件夹上,鼠标右键,点击新建 Component
- 键入组件的名称之后回车,会自动生成组件对应的 4 个文件,后缀名分别为
.js
,.json
,.wxml
和.wxss
- 注意:为了保证目录结构的清晰,建议把不同的组件,存放到单独目录中
局部使用
在页面的 .json
配置文件中引用组件的方式,叫做 局部引用
"usingComponents": {"组件名":"组件位置""my-test":"/components/test/test"
}
全局使用
在 app.json
全局配置文件中引用组件的方式,叫做 全局引用
{"pages":[],"window":{},"style": "v2","sitemapLocation": "sitemap.json","usingComponents": {"组件名":"组件位置""my-test1" :"/components/test/test"}
}
- 如果某组件
在多个页面中经常被用到
,建议进行全局引用
- 如果某组件只
在特定的页面中被用到
,建议进行局部引用
组件与页面的区别
组件和页面都是由 .js
、 .json
、 .wxml
和 .wxss
这四个文件组成的
组件和 页面的 .js
与 .json
文件有明显的不同:
- 组件的 .json 文件中需要声明
"component": true
属性 - 组件的 .js 文件中调用的是
Component()
函数- 整个程序启动调用的是
App()
- 某个页面的渲染调用的是
Page()
- 某个组件的渲染调用的是
Component()
- 整个程序启动调用的是
- 组件的事件处理函数需要定义到
methods
节点中
组件的样式隔离
- 默认情况下,自定义组件的样式只对当前组件生效,不会影响到组件之外的 UI 结构
- 组件的样式不会影响页面的样式
- 组件A的样式也不会影响组件C的样式
好处
- 防止外界的样式影响组件内部的样式
- 防止组件的样式破坏外界的样式
注意点
- app.wxss中全局样式对组件无效
- 只有class选择器会有隔离效果,属性选择器、标签选择器不受隔离的的影响
- 在组件和引用组件的页面中建议使用class选择器,不要使用id、属性、标签选择器
修改组件隔离
默认情况下,自定义组件的
样式隔离特性
能够防止组件内外样式互相干扰的问题
。但有时,我们希望在外界能够控制组件内部的样式,此时,可以通过styleIsolation
修改组件的样式隔离选项
Component({options:{styleIsolation:'isolated'}
})
可选值 | 默认值 | 描述 |
---|---|---|
isolated | 是 | 表示启用样式隔离 |
apply-shared | 否 | 表示页面wxss样式将会影响到自定义组件 |
shared | 否 | 表示页面wxss样式和自定义组件wxss的样式会相互影响 |
组件的数据、方法和属性
data数据
- 在小程序组件中,用于组件模板渲染的私有数据,需要定义到
data
节点中
// components/test/test.js
Component({/*** 组件的初始数据*/data: {count:0}
})
methods方法
- 在小程序组件中,事件处理函数和自定义方法需要定义到
methods
节点中
// components/test/test.js
Component({/*** 组件的方法列表*/methods: {//事件处理函数addCount(){//do something},//自定义方法_showCount(){//do something}}
})
- 自定义方法建议以
_
开头
properties属性
- 在小程序组件中,
properties
是组件的对外属性,用来接收外界(父组件)传递到组件中的数据
// components/test/test.js
Component({/*** 组件的属性列表*/properties: {//第一种写法max:{type:Number,//属性的数据类型value:10 //属性默认值},//第二种写法min:Number
})
data与properties的区别
在小程序的组件中, properties
属性和 data
数据的用法相同,它们都是可读可写的,只不过:
data
更倾向于存储组件的私有数据properties
更倾向于存储外界传递到组件中的数据- 所以, 也不太建议修改
properties
数据,如果要修改properties
的数据, 最好通过子组件通信给父组件的方式实现
console.log(this.data===this.properties) //true
//指向同一块内存地址
数据监听器(observers)
数据监听器用于监听和响应任何属性和数据字段的变化,从而执行特定的操作。它的作用类似于 vue
中的 watch
侦听器。
Components({observers:{"字段A,字段B" : function(字段A的新值,字段B的新值){//do something}}
})
监听对象属性的变化
数据监听器支持监听对象中单个或多个属性的变化
Components({observers:{"obj.a, obj.b" : function(newa,newb){//do somethingthis.setData({'obj.a':newa,'obj.b':newb})}}
})
监听对象中所有的属性的变化
Components({observers:{"obj.**" : function(obj){//do somethingthis.setData({'obj.a':obj.a,'obj.b':obj.b})}}
})
纯数据字段
纯数据字段
指的是那些不用于界面渲染的 data 字段
- 某些
data
中的字段既不会被展示在界面上,也不会传递给其他组件
,仅仅在当前组件内部使用。带有这种特性的data
字段适合被设置为纯数据字段 - 纯数据字段
有助于提升页面更新的性能
使用
在
Component
构造器的options
节点中,指定pureDataPattern
为一个正则表达式
,字段名符合这个正则表达式的字段将会被视为纯数据字段
Component({options:{pureDataPattern:/^_/},data:{a:1,//普通字段_b:2 //纯数据字段}
} )
生命周期
生命周期 | 参数 | 描述 |
---|---|---|
created
|
无
|
在组件实例刚刚被创建时执行
|
attached
|
无
|
在组件实例进入页面节点树时执行
|
ready | 无 | 在组件在视图层布局完成后执行 |
moved | 无 | 在组件实例被移动到节点树另一个位置时执行 |
detached
|
无 |
在组件实例被从页面节点树移除时执行
|
error |
Object Error
|
每当组件方法抛出错误时执行 |
- 组件实例刚刚被创建好时,
created
生命周期被触发- 此时还不能调用
setData
- 通常情况下,这个生命周期只应该用于给组件 this 添加一些自定义属性字段
- 此时还不能调用
- 在组件完全初始化完毕、进入页面节点树后,
attached
生命周期被触发this.data
已被初始化完毕- 这个生命周期很有用,绝大多数初始化工作可以在这个时机进行
- 在组件离开页面节点树后,
detached
生命周期被触发- 退出一个页面时,会触发页面内每个自定义组件的
detached
生命周期被触发 - 如果组件还在页面节点树中,则
detached
会被触发。 - 此时适合做一些清理性质的工作
- 退出一个页面时,会触发页面内每个自定义组件的
lifetimes节点
生命周期方法可以直接定义在
Component
构造器的第一级参数中,组件的的生命周期也可以在lifetimes
字段内进行声明(这是推荐的方式,其优先级最高)
lifetimes: {attached () {},detached () {console.log('在组件实例被从页面节点树移除')}
},attached () {console.log('~~~~~在组件实例进入页面节点树')
},
detached () {console.log('~~~~~在组件实例被从页面节点树移除')
},
组件所在页面的生命周期
自定义组件的行为依赖于页面状态的变化,此时就需要用到组件所在页面的生命周期
生命周期 | 参数 | 描述 |
---|---|---|
show | 无 | 组件所在的页面被展示时执行 |
hide | 无 | 组件所在的页面被隐藏时执行 |
resize |
Object Size
|
组件所在的页面尺寸变化时执行 |
pageLifetimes
组件所在页面的生命周期函数,需要定义在 pageLifetimes
节点中
Components({pageLifetimes:{show:function(){}, //页面被展示hide:function(){}, //页面被隐藏resize:function(size){} //页面尺寸变化}
})
插槽slot
在自定义组件的 wxml
结构中,可以提供一个 节点(插槽),用于承载组件使用者提供的 wxml
结构
- 作为组件的封装者占位符
单个插槽
- 默认情况下,一个组件的
wxml
中只能有一个slot
- 需要使用多
slot
时,可以在组件js
中声明启用 - 注意:小程序中目前只有默认插槽和多个插槽,暂不支持作用域插槽
<!--test组件-->
<view>
<view>这是组件的内部节点</view><slot></slot> <!--插槽-->
</view>
<!--需要用到自定义组件的页面例如:page/home/home-->
<my-test>
<view>这是插槽的内容</view>
</my-test>
多个插槽
启用多个插槽
在小程序的自定义组件中,需要使用多 插槽时,可以在组件的 .js
文件中
Component({options:{multipleSlots:true//开启多个插槽}
})
使用
<!--test组件-->
<view>
<slot name='before'></slot> <!--插槽-->
<view>这是组件的内部节点</view><slot name='after'></slot> <!--插槽-->
</view>
<!--需要用到自定义组件的页面例如:page/home/home-->
<my-test>
<view slot="before">这是before插槽的内容</view><view>---------------</view>
<view slot="after">这是after插槽的内容</view>
</my-test>
父子组件的通讯
属性绑定
- 用于父组件向子组件的指定属性设置数据,仅能设置
JSON
兼容的数据(只能传递数据,不能传递方法)
- 用于父组件向子组件的指定属性设置数据,仅能设置
事件绑定
- 用于子组件向父组件传递数据,可以传递任意数据(包括数组和方法)
获取组件实例
- 父组件还可以通过
this.selectComponent()
获取子组件实例对象这样就可以直接访问子组件的任意数据和方法
- 父组件还可以通过
属性绑定
属性绑定用于实现父向子传值,而且只能传递普通类型的数据,无法将方法传递给子组件
<!--test组件-->
<view><view>自定义组件</view>
</view>
properties:{
count:Number
}
<!--需要用到自定义组件的页面例如:page/home/home-->
data:{
count:0
}
<my-test count="{{count}}">
</my-test>
事件绑定
- 在
父组件
的js
中,定义一个函数,这个函数即将通过自定义事件的形式,传递给子组件
//在父组件中自定义一个函数
syncCount(){}
- 在
父组件
的wxml
中,通过自定义事件的形式,将步骤 1 中定义的函数引用,传递给子组件
<my-test count="{{count}}" bind:sync="syncCount"></my-test>
- 在
子组件
的js
中,通过调用this.triggerEvent('自定义事件名称', {/* 参数对象 */})
,将数据发送到父组件
addCount(){this.setData({count:this.properties.count+1})//调用this.triggerEvent()this.triggerEvent('sync',{value:this.properties.count})
}
- 在父组件的
js
中,通过e.detail
获取到子组件传递过来的数据
syncCount(e){console.log(e);//是一个对象里面包含组件实例this.setData({count:e.detail.value//改变父组件的值})
}
获取组件实例
在父组件里调用 this.selectComponent("id或class选择器")
,获取子组件的实例对象,从而直接访问子组件的任意数据和方法。调用时需要传入一个选择器
<!-- 父组件-->
<my-test count="{{count}}" bind:sync="syncCount" class="customA" id='customB'></my-test>
<button bindtap="getChild"></button>
getChild(){const child= this.selectComponent('.customA')console.log(child);//组件实例child.setData({count:child.properties.count})child.addCount()//调用方法
}
behaviors
behaviors
是小程序中,用于实现组件间代码共享的特性
,类似于Vue.js
中的mixins
- 每个
behaviors
可以包含一组属性、数据、生命周期函数和方法。组件引用它时,它的属性、数据和
方法会被合并到组件中 - 每个组件可以引用多个
behaviors
,behaviors
也可以引用其它behaviors
- 只有当组件共享的代码(数据、方法),就可以使用
behaviors
来共享,如果是组件私有的代码,就不需要放在behaviors
中
创建
调用
behaviors(Object object)
方法即可创建一个共享的 behaviors 实例对象
在项目的根目录新建文件behaviors——>mybehaviors.js文件
// mybehaviors.jsmodule.exports = Behavior({data: {username: 'zs'},properties: {},methods: {}
})
使用
在组件中,使用
require()
方法导入需要的behaviors
,挂载后即可访问 behaviors 中的数据和方法
const mybehaviors = require('../../behaviors/mybehaviors')
Component({behaviors:[mybehaviors]
})<view>{{username}}</view>
微信小程序——自定义组件的使用以及组件之间的传值相关推荐
- 微信小程序自定义select下拉选择组件
微信小程序自定义select下拉选择组件 微信小程序原生开发中,常用到的是从底部弹起的滚动选择器(picker),而有些项目需要用到下拉选择,话不多说,下面就可以把下拉选择封装成一个自定义组件: 1. ...
- 微信小程序自定义canvas手写签名组件
需求如下图展示,因为小程序中有好几个地方使用签名,所以做成组件. 1.创建组件 signature.js const app = getApp(); Component({/*** 组件的属性列表*/ ...
- 微信小程序自定义封装环形进度条组件
我们先看效果-选不了视频没办法了 说明:此组件对圆的宽度,进度条的宽度.颜色.旋转方向,还有进度条的值,还有两端是否要圆角都进行了动态化,无坑可放心用,参数解释在注释里,我就不写了 .效果图看到尾部的 ...
- 微信小程序 自定义带金额的日历组件
// component/dateSelect/dateSelect.jsComponent({/*** 组件的属性列表*/properties: {timeData: {type: Array,va ...
- 微信小程序自定义组件方案
前言:小程序已于11月初开放了小程序组件功能,但事件方面还不是很完善,有的组件暂时可能还是要用其他方式来实现,这里简单记录下开发小程序自定义组件的要点. 在小程序官方开发组件开发功能之前,自定义组件的 ...
- 微信小程序自定义组件,提示组件
微信小程序自定义组件,这里列举了一个常用的提示自定义组件,调用自定义组件中的方法和字段.仅供参考和学习. 编写组件: 在根目录下添加"components"目录,然后像添加Page ...
- 微信小程序项目实战知识点总结(swiper组件自适应高度,自定义弹出层,悬浮按钮,虚拟键盘)...
1.小程序 swiper 组件默认高度150px,并且如果子元素过高,swiper不会自适应高度 height:100vh; 2.微信小程序自定义弹出层,参考网址:https://blog.cs ...
- 微信小程序自定义组件(二)
微信小程序自定义组件 ps 由于作业部落貌似出了点问题,耽误了点时间,找了一个stackedit.io准备写.无奈,这是要自己建编辑器的节奏啊.没有一个能靠的注 为何存在组件 组件间的关系 使用rel ...
- 微信小程序下拉框插件_微信小程序自定义select下拉选项框组件的实现代码_清玖_前端开发者...
知识点:组件,animation,获取当前点击元素的索引与内容 微信小程序中没有select下拉选项框,所以只有自定义.自定义的话,可以选择模板的方式,也可以选择组件的方式来创建. 这次我选择了组件, ...
- 微信小程序—自定义(城市选择)弹窗组件,将弹窗组件的值传给调用页面并显示(图文)
微信小程序-自定义(城市选择)弹窗组件,并传值 1.新建component文件夹用来存放自定义组件,并在其文件夹内新建cityModal Component,注意不是新建Page 新建完成之后出现四个 ...
最新文章
- 开启Windows7的隐藏功能:虚拟WiFi和SoftAP(即虚拟无线AP)
- 论文精读——CenterNet :Objects as Points
- MySQL乱码问题解决步骤详解
- 这么烂的游戏也能卖2000万吗?
- anaconda新建python2环境安装不了jupyterlab_Anaconda 5.0.0 JupyterLab 0.27.0 中配置多Python环境支持...
- 月活675万 三翼鸟以三大能力“重建”行业赛道
- TinyMCE 5 正式版发布,重磅更新!!!
- 递归函数(九):最小不动点定理
- Ubuntu apt-get和pip源更换
- 拳王虚拟项目公社:闲鱼操作卖资源如何赚钱?闲鱼怎么卖虚拟资源?卖什么资源赚钱?
- C++编程基础一 27-二维数组
- 7-9 成绩转换 (15 分)
- 2020年度软件和信息技术服务竞争力前百家企业名单出炉 —— 旋极信息再次荣登榜单
- 阿里云商标注册购物车功能怎么用?在哪查看?
- 11.1.4 子线程与主线程通信实例
- 用计算机刻录光盘,刻录光盘,教您如何使用计算机将文件刻录到光盘上.
- 图像处理的一些相关知识(Related knowledge for IQA)
- win7中如何获取IE8的缓存视频文件
- linux移动文件夹
- 防止私自接交换机_H3C S3100-SI系列交换机利用DHCP Snooping防止内网私自接入DHCPServer...