1. 程式人生 > >手摸手教你微信小程式開發之自定義元件

手摸手教你微信小程式開發之自定義元件

前言

  相信大家在開發小程式時會遇到某個功能多次使用的情況,比如彈出框。這個時候大家首先想到的是元件化開發,就是把彈出框封裝成一個元件,然後哪裡使用哪裡就呼叫,對,看來大家都是有思路的人,但是要怎樣實現呢。可能你會去看官方文件,但是微信的官方文件也是說的不太清楚,所以寫起來也是非常痛苦。今天就帶大家手摸手開發微信元件,坐穩了,馬路殺手要開車了。

具體實現

  我們先實現個簡單的彈窗元件,詳情圖如下:

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

到此就結束,一個簡單的小外掛封裝好了

另外請大家多多提出意見,一起進步。