微信小程序组件封装开发教程

2018-11-19 16:46

摘要:自己封装的一个比较简单微信弹窗小组件,主要就是教会大家对微信小组件的用法和理解,因为微信小程序对组件介绍特别少,所以我就把自己的理解分享给大家。

概述

自己封装的一个比较简单微信弹窗小组件,主要就是教会大家对微信小组件的用法和理解,因为微信小程序对组件介绍特别少,所以我就把自己的理解分享给大家。

一前言

相信大家在开发小程序时会遇到某个功能多次使用的情况,比如弹出框。这个时候大家首先想到的是组件化开发,就是把弹出框封装成一个组件,然后哪里使用哪里就调用,对,看来大家都是有思路的人,但是要怎样实现呢。可能你会去看官方文档,但是微信的官方文档也是说的不太清楚,所以写起来也是非常痛苦。今天就和大家一起开发微信组件,坐稳了,老司机要开车了。

二具体实现

我们先实现个简单的弹窗组件,详情图如下:

/

1.新建component文件夹存放我们的组件,里边存放的就是我们所用的组件,我们今天要做的事弹出框,新建文件夹popup存放我们的组件模板,点击右键选择新建component,就会自动生成组件的模板wxss、wxml、json、js,如图

/

2.我们可以写一些组件样式和布局,跟页面写法类似,就不多说了,

样式和布局和布局已经写好了接下来要介绍的就是

Component构造器

Component构造器可用于定义组件,调用Component构造器时可以指定组件的属性、数据、方法等。

/

Tips:

Component 构造器构造的组件也可以作为页面使用。

使用 this.data 可以获取内部数据和属性值,但不要直接修改它们,应使用 setData 修改。

生命周期函数无法在组件方法中通过 this 访问到。

属性名应避免以 data 开头,即不要命名成 dataXyz 这样的形式,因为在 WXML 中, data-xyz= 会被作为节点 dataset 来处理,而不是组件属性。

在一个组件的定义和使用时,组件的属性名和data字段相互间都不能冲突(尽管它们位于不同的定义段中)。

component介绍完后就是最为关键的js了

popup.js:

Component({  

options: {    

multipleSlots: true // 在组件定义时的选项中启用多slot支持  

},  

/**   * 组件的属性列表   */  

properties: {    

title: {            

// 属性名      type: String,     

// 类型(必填),

目前接受的类型包括:String, Number, Boolean, Object, Array, null

(表示任意类型)    

value: \'标题\'     // 属性初始值(可选),如果未指定则会根据类型选择一个 

},    // 弹窗内容    

content: {     

type: String, 

value: \'内容\'  

},    // 弹窗取消按钮文字   

btn_no: {     

type: String,   

value: \'取消\'    },   

// 弹窗确认按钮文字    

btn_ok: {      

type: String,      

value: \'确定\'    }   },  

/**   * 组件的初始数据   */  

data: {   

flag: true,  

},  

/**   * 组件的方法列表   */  

methods: {   

//隐藏弹框    

hidePopup: function () {     

this.setData({       

flag: !this.data.flag    

})    },   

//展示弹框   

showPopup () {    

this.setData({      

flag: !this.data.flag    

})    },    

/*    * 内部私有方法建议以下划线开头    * triggerEvent 用于触发事件    */  

_error () {     

//触发取消回调     

this.triggerEvent(error)    },   

_success () {     

//触发成功回调     

this.triggerEvent(success);  

}})


上边会用到一个triggerEvent下面我们就来介绍下:

自定义组件触发事件时,需要使用 triggerEvent 方法,指定事件名、detail对象和事件选项。

触发事件的选项包括:

/

现在一个弹窗的组件就封装好了接下来就是调用了。调用的时候需要在调用的页面新建一个json文件,json文件里需要配置usingComponents就是引用组件,看代码:

index.json

{

usingComponents: {    

popup: /component/popup/popup  

}}

现在基本上完成了需要的就是在首页引用了,配置index.js加上点击事件

//index.js//获取应用实例

const app = getApp() 

Page({  

onReady: function () {   

//获得popup组件    

this.popup = this.selectComponent(#popup);  

},   

showPopup() {    

this.popup.showPopup();  

},   

//取消事件  

_error() {    

console.log(\'你点击了取消\');    

this.popup.hidePopup();  

},  

//确认事件  

_success() {    

console.log(\'你点击了确定\');    

this.popup.hidePopup();  

}})

至此,一个弹窗组件就完成了。


微信小程序专题推荐: 漫画小程序   门票小程序

参与讨论

发表评论