一、创建自定义组件
.js中注册Component函数
.json使用"component": true
Component({})
{
"component": true
}
二、使用自定义组件
全局配置、页面配置均可,全局配置就写在app.json中,页面配置就写在页面对应的json中。
配置之后,在页面中以组件形式引入。
<page-search />
{
"usingComponents": {
"page-search":"/components/my_search/my_search"
}
}
三、自定义组件样式
小程序的样式是默认隔离(默认情况下页面的样式无法影响自定义组件的样式)的,允许外部文件修改组件样式的方法:
1、设置addGlobalClass
.js 文件中传入 options: { addGlobalClass: true }
注意:尽量不要使用标签、ID、属性选择器(会影响到全局)。
// components/my-nav/my-nav.js
Component({
// 小程序组件默认样式是隔离,addGlobalClass设置为true可允许外部修改样式
options: {
addGlobalClass: true
}
})
// 组件内容
<view class="navigation-bar custom-class">
<view class="navigation-bar-title title-class">
自定义标题
</view>
</view>
// 组件样式
.navigation-bar {
background-color: #fff;
height: 88rpx;
/* 顶部刘海预留 */
padding-top: 100rpx;
display: flex;
justify-content: center;
}
.navigation-bar-title {
font-weight: 600;
}
// 使用组件的页面
<app-nav></app-nav>
.navigation-bar {
background-color: gold !important;
}
.nav_title {
color: #fff !important;
}
// 使用组件的js
{
"navigationStyle": "custom"
}
2、设置externalClasses
.js 文件中传入 externalClasses: [ xxx, yyy]
// components/my-nav/my-nav.js
Component({
externalClasses: ["custom-class"],
})
// 使用组件的页面
<app-nav custom-class="nav_title"></app-nav>
.navigation-bar {
background-color: gold !important;
}
.nav_title {
color: #fff !important;
}
四、自定义插槽
小程序默认只能使用一个slot,需要多个插槽或需要使用具名插槽的时候,需要传入multipleSlots: true
。
创建插槽:在组件的任一位置使用<slot />占位,slot一定要是闭合标签。
// components/my-nav/my-nav.js
Component({
options: {
// 只要使用到具名插槽,都需要将multipleSlots设置为true
multipleSlots: true
},
})
<view class="navigation-bar custom-class">
<view class="navigation-bar-title title-class">
<slot name="left"></slot>自定义标题<slot name="right"></slot>
</view>
</view>
<app-nav custom-class="nav_title">
<text slot="left">◀</text>
<text slot="right">▶</text>
</app-nav>
五、组件生命周期
1、created
组件创建时触发,相当于vue的created,但是由于无法使用this.setData({}),所以,一般不用。
2、attached
组件初始完毕时触发,相当于vue的mounted,最常使用。
<view class="navigation-bar custom-class" style="padding-top: {{statusBarHeight}}px;">
<view class="navigation-bar-title title-class">
<slot name="left"></slot>自定义标题<slot name="right"></slot>
</view>
</view>
// components/my-nav/my-nav.js
Component({
options: {
multipleSlots: true
},
data: {
statusBarHeight: 0
},
// 生命周期
lifetimes: {
created(){},
attached() {
const { statusBarHeight } = wx.getSystemInfoSync()
console.log(wx.getSystemInfoSync())
console.log(statusBarHeight)
this.setData({
statusBarHeight: statusBarHeight
})
}
}
})