小程序模板網(wǎng)

(干貨)微信小程序組件封裝

發(fā)布時間:2018-05-30 11:39 所屬欄目:小程序開發(fā)教程

概述

自己封裝的一個比較簡單微信彈窗小組件,主要就是教會大家對微信小組件的用法和理解,因為微信小程序?qū)M件介紹特別少,所以我就把自己的理解分享給大家。

一前言

相信大家在開發(fā)小程序時會遇到某個功能多次使用的情況,比如彈出框。這個時候大家首先想到的是組件化開發(fā),就是把彈出框封裝成一個組件,然后哪里使用哪里就調(diào)用,對,看來大家都是有思路的人,但是要怎樣實現(xiàn)呢??赡苣銜タ垂俜轿臋n,但是微信的官方文檔也是說的不太清楚,所以寫起來也是非常痛苦。今天就和大家一起開發(fā)微信組件,坐穩(wěn)了,老司機要開車了。

二具體實現(xiàn)

我們先實現(xiàn)個簡單的彈窗組件,詳情圖如下:

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

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

Component構(gòu)造器

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

Tips:

  • Component 構(gòu)造器構(gòu)造的組件也可以作為頁面使用。
  • 使用 this.data 可以獲取內(nèi)部數(shù)據(jù)和屬性值,但不要直接修改它們,應(yīng)使用 setData 修改。
  • 生命周期函數(shù)無法在組件方法中通過 this 訪問到。
  • 屬性名應(yīng)避免以 data 開頭,即不要命名成 dataXyz 這樣的形式,因為在 WXML 中, data-xyz="" 會被作為節(jié)點 dataset 來處理,而不是組件屬性。
  • 在一個組件的定義和使用時,組件的屬性名和data字段相互間都不能沖突(盡管它們位于不同的定義段中)。

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

popup.js:

Component({
  options: {
    multipleSlots: true // 在組件定義時的選項中啟用多slot支持
  },
  /**
   * 組件的屬性列表
   */
  properties: {
    title: {            // 屬性名
      type: String,     // 類型(必填),目前接受的類型包括:String, Number, Boolean, Object, Array, null(表示任意類型)
      value: '標題'     // 屬性初始值(可選),如果未指定則會根據(jù)類型選擇一個
    },
    // 彈窗內(nèi)容
    content: {
      type: String,
      value: '內(nèi)容'
    },
    // 彈窗取消按鈕文字
    btn_no: {
      type: String,
      value: '取消'
    },
    // 彈窗確認按鈕文字
    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)部私有方法建議以下劃線開頭
    * triggerEvent 用于觸發(fā)事件
    */
    _error () {
      //觸發(fā)取消回調(diào)
      this.triggerEvent("error")
    },
    _success () {
      //觸發(fā)成功回調(diào)
      this.triggerEvent("success");
    }
  }
})

上邊會用到一個 triggerEvent下面我們就來介紹下:

自定義組件觸發(fā)事件時,需要使用 triggerEvent 方法,指定事件名、detail對象和事件選項。

觸發(fā)事件的選項包括:

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

調(diào)用的時候需要在調(diào)用的頁面新建一個json文件,json文件里需要配置usingComponents就是引用組件,看代碼:

index.json

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

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

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

配置index.js加上點擊事件

//index.js
//獲取應(yīng)用實例
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();
  }
})

一個彈窗組件就完成了,看下效果:

如果覺得文章還不錯并對你有幫助的話,請分享給你的小伙伴,并點贊,有什么不懂得可以在底下留言哦。


本文地址:http://22321a.com/wxmini/doc/course/24491.html 復(fù)制鏈接 如需定制請聯(lián)系易優(yōu)客服咨詢:800182392 點擊咨詢
QQ在線咨詢