概述

自己封裝的一個(gè)比較簡(jiǎn)單微信彈窗小組件，主要就是教會(huì)大家對(duì)微信小組件的用法和理解，因?yàn)槲⑿判〕绦驅(qū)M件介紹特別少，所以我就把自己的理解分享給大家。

一前言

相信大家在開(kāi)發(fā)小程序時(shí)會(huì)遇到某個(gè)功能多次使用的情況，比如彈出框。這個(gè)時(shí)候大家首先想到的是組件化開(kāi)發(fā)，就是把彈出框封裝成一個(gè)組件，然后哪里使用哪里就調(diào)用，對(duì)，看來(lái)大家都是有思路的人，但是要怎樣實(shí)現(xiàn)呢。可能你會(huì)去看官方文檔，但是微信的官方文檔也是說(shuō)的不太清楚，所以寫(xiě)起來(lái)也是非常痛苦。今天就和大家一起開(kāi)發(fā)微信組件，坐穩(wěn)了，老司機(jī)要開(kāi)車了。

二具體實(shí)現(xiàn)

我們先實(shí)現(xiàn)個(gè)簡(jiǎn)單的彈窗組件，詳情圖如下：

1.新建component文件夾存放我們的組件，里邊存放的就是我們所用的組件，我們今天要做的事彈出框，新建文件夾popup存放我們的組件模板，點(diǎn)擊右鍵選擇新建component，就會(huì)自動(dòng)生成組件的模板wxss、wxml、json、js，如圖

2.我們可以寫(xiě)一些組件樣式和布局，跟頁(yè)面寫(xiě)法類似，我就不多說(shuō)了，直接把代碼貼出 :

popup.wxml

<view class="wx-popup" hidden="{{flag}}">  <view class='popup-container'>    <view class="wx-popup-title">{{title}}</view>    <view class="wx-popup-con">{{content}}</view>    <view class="wx-popup-btn">      <text class="btn-no" bindtap='_error'>{{btn_no}}</text>      <text class="btn-ok" bindtap='_success'>{{btn_ok}}</text>    </view>  </view></view>復(fù)制代碼

popup.wxss

/* component/popup.wxss */.wx-popup {  position: absolute;  left: 0;  top: 0;   width: 100%;  height: 100%;  background: rgba(0, 0, 0, .5);} .popup-container {  position: absolute;  left: 50%;  top: 50%;   width: 80%;  max-width: 600rpx;  border: 2rpx solid #ccc;  border-radius: 10rpx;  box-sizing: bordre-box;  transform: translate(-50%, -50%);   overflow: hidden;  background: #fff;} .wx-popup-title {  width: 100%;  padding: 20rpx;  text-align: center;  font-size: 40rpx;  border-bottom: 2rpx solid red;} .wx-popup-con {  margin: 60rpx 10rpx;  text-align: center;} .wx-popup-btn {  display: flex;  justify-content: space-around;  margin-bottom: 40rpx;} .wx-popup-btn text {  display: flex;  align-items: center;  justify-content: center;  width: 30%;  height: 88rpx;  border: 2rpx solid #ccc;  border-radius: 88rpx;}復(fù)制代碼

樣式和布局和布局已經(jīng)寫(xiě)好了接下來(lái)要介紹的就是

Component構(gòu)造器

Component構(gòu)造器可用于定義組件，調(diào)用Component構(gòu)造器時(shí)可以指定組件的屬性、數(shù)據(jù)、方法等。

定義段	類型	是否必填	描述
properties	Object Map	否	組件的對(duì)外屬性，是屬性名到屬性設(shè)置的映射表，屬性設(shè)置中可包含三個(gè)字段， type 表示屬性類型、 value 表示屬性初始值、 observer 表示屬性值被更改時(shí)的響應(yīng)函數(shù)
data	Object	否	組件的內(nèi)部數(shù)據(jù)，和 properties 一同用于組件的模版渲染
methods	Object	否	組件的方法，包括事件響應(yīng)函數(shù)和任意的自定義方法，關(guān)于事件響應(yīng)函數(shù)的使用，參見(jiàn)組件事件
behaviors	String Array	否	類似于mixins和traits的組件間代碼復(fù)用機(jī)制，參見(jiàn)behaviors
created	Function	否	組件生命周期函數(shù)，在組件實(shí)例進(jìn)入頁(yè)面節(jié)點(diǎn)樹(shù)時(shí)執(zhí)行，注意此時(shí)不能調(diào)用 setData
attached	Function	否	組件生命周期函數(shù)，在組件實(shí)例進(jìn)入頁(yè)面節(jié)點(diǎn)樹(shù)時(shí)執(zhí)行
ready	Function	否	組件生命周期函數(shù)，在組件布局完成后執(zhí)行，此時(shí)可以獲取節(jié)點(diǎn)信息（使用SelectorQuery ）
moved	Function	否	組件生命周期函數(shù)，在組件實(shí)例被移動(dòng)到節(jié)點(diǎn)樹(shù)另一個(gè)位置時(shí)執(zhí)行
detached	Function	否	組件生命周期函數(shù)，在組件實(shí)例被從頁(yè)面節(jié)點(diǎn)樹(shù)移除時(shí)執(zhí)行
relations	Object	否	組件間關(guān)系定義，參見(jiàn)組件間關(guān)系
externalClasses	String Array	否	組件接受的外部樣式類，參見(jiàn)外部樣式類
options	Object Map	否	一些組件選項(xiàng)，請(qǐng)參見(jiàn)文檔其他部分的說(shuō)明

Tips:

• Component 構(gòu)造器構(gòu)造的組件也可以作為頁(yè)面使用。

• 使用 this.data 可以獲取內(nèi)部數(shù)據(jù)和屬性值，但不要直接修改它們，應(yīng)使用 setData 修改。

• 生命周期函數(shù)無(wú)法在組件方法中通過(guò) this 訪問(wèn)到。

• 屬性名應(yīng)避免以 data 開(kāi)頭，即不要命名成 dataXyz 這樣的形式，因?yàn)樵?WXML 中， data-xyz="" 會(huì)被作為節(jié)點(diǎn) dataset 來(lái)處理，而不是組件屬性。

• 在一個(gè)組件的定義和使用時(shí)，組件的屬性名和data字段相互間都不能沖突（盡管它們位于不同的定義段中）。

component介紹完后就是最為關(guān)鍵的js了

popup.js:

Component({  options: {    multipleSlots: true // 在組件定義時(shí)的選項(xiàng)中啟用多slot支持  },  /**   * 組件的屬性列表   */  properties: {    title: {            // 屬性名      type: String,     // 類型（必填），目前接受的類型包括：String, Number, Boolean, Object, Array, null（表示任意類型）      value: '標(biāo)題'     // 屬性初始值（可選），如果未指定則會(huì)根據(jù)類型選擇一個(gè)    },    // 彈窗內(nèi)容    content: {      type: String,      value: '內(nèi)容'    },    // 彈窗取消按鈕文字    btn_no: {      type: String,      value: '取消'    },    // 彈窗確認(rèn)按鈕文字    btn_ok: {      type: String,      value: '確定'    }   },   /**   * 組件的初始數(shù)據(jù)   */  data: {    flag: true,  },   /**   * 組件的方法列表   */  methods: {    //隱藏彈框    hidePopup: function () {      this.setData({        flag: !this.data.flag      })    },    //展示彈框    showPopup () {      this.setData({        flag: !this.data.flag      })    },    /*    * 內(nèi)部私有方法建議以下劃線開(kāi)頭    * triggerEvent 用于觸發(fā)事件    */    _error () {      //觸發(fā)取消回調(diào)      this.triggerEvent("error")    },    _success () {      //觸發(fā)成功回調(diào)      this.triggerEvent("success");    }  }})復(fù)制代碼

上邊會(huì)用到一個(gè)triggerEvent下面我們就來(lái)介紹下：

自定義組件觸發(fā)事件時(shí)，需要使用 triggerEvent 方法，指定事件名、detail對(duì)象和事件選項(xiàng)。

觸發(fā)事件的選項(xiàng)包括：

選項(xiàng)名	類型	是否必填	默認(rèn)值	描述
bubbles	Boolean	否	false	事件是否冒泡
composed	Boolean	否	false	事件是否可以穿越組件邊界，為false時(shí)，事件將只能在引用組件的節(jié)點(diǎn)樹(shù)上觸發(fā)，不進(jìn)入其他任何組件內(nèi)部
capturePhase	Boolean	否	false	事件是否擁有捕獲階段

現(xiàn)在一個(gè)彈窗的組件就封裝好了接下來(lái)就是調(diào)用了。

調(diào)用的時(shí)候需要在調(diào)用的頁(yè)面新建一個(gè)json文件，json文件里需要配置usingComponents就是引用組件，看代碼：

index.json

{  "usingComponents": {    "popup": "/component/popup/popup"  }}復(fù)制代碼

現(xiàn)在基本上完成了需要的就是在首頁(yè)引用了。

<!--index.wxml--><view class="container">  <view class="userinfo">    <button bindtap="showPopup"> 點(diǎn)我 </button>  </view>  <popup id='popup'       title='小組件'       content='學(xué)會(huì)了嗎'       btn_no='沒(méi)有'       btn_ok='學(xué)會(huì)了'      bind:error="_error"        bind:success="_success">  </popup></view>復(fù)制代碼

配置index.js加上點(diǎn)擊事件

//index.js//獲取應(yīng)用實(shí)例const app = getApp() Page({  onReady: function () {    //獲得popup組件    this.popup = this.selectComponent("#popup");  },   showPopup() {    this.popup.showPopup();  },   //取消事件  _error() {    console.log('你點(diǎn)擊了取消');    this.popup.hidePopup();  },  //確認(rèn)事件  _success() {    console.log('你點(diǎn)擊了確定');    this.popup.hidePopup();  }})復(fù)制代碼

一個(gè)彈窗組件就完成了，看下效果：