手摸手教你微信小程序開發之自定義組件

前言

  相信你們在開發小程序時會遇到某個功能屢次使用的狀況，好比彈出框。這個時候你們首先想到的是組件化開發，就是把彈出框封裝成一個組件，而後哪裏使用哪裏就調用，對，看來你們都是有思路的人，可是要怎樣實現呢。可能你會去看官方文檔，可是微信的官方文檔也是說的不太清楚，因此寫起來也是很是痛苦。今天就帶你們手摸手開發微信組件，坐穩了，馬路殺手要開車了。

具體實現

  咱們先實現個簡單的彈窗組件，詳情圖以下：

1.新建component文件夾存放咱們的組件，裏邊存放的就是咱們所用的組件，咱們今天要作的事彈出框，新建文件夾popup存放咱們的組件模板，點擊右鍵選擇新建component，就會自動生成組件的模板wxss、wxml、json、js，如圖

2.咱們能夠寫一些組件樣式和佈局，更頁面寫法相似，我就很少說了，直接把代碼貼出 :

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>

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;
}

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");
    }
  }
})

Component這個能夠本身看微信官方文檔鍛鍊一下自學能力^_^

3.模板文件也建好了，在首頁用這個組件須要配置一下，首先建一個名爲index.json的文件，裏邊配置"usingComponents"，就是須要引入到首頁，直接上代碼：

{
  "usingComponents": {
    "popup": "/component/popup/popup"
  }
}

4.完成這些基本上大功告成了，還有最重要的一步也是最後一步，引入到首頁，看代碼

<!--index.wxml-->
<view class="container">
  <view class="userinfo">
    <button bindtap="showPopup"> 點我 </button>
  </view>
  <popup id='popup' 
      title='小組件' 
      content='學會了嗎' 
      btn_no='沒有' 
      btn_ok='學會了'
      bind:error="_error"  
      bind:success="_success">
  </popup>
</view>

5.配置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();
  }
})

到此就結束，一個簡單的小插件封裝好了

這個小組件我放到了git上https://github.com/Mr-MengBo/MiniApp-module，喜歡的話點個star,謝謝。

另外請你們多多提出意見，一塊兒進步。