手摸手教你微信小程式開發之自定義元件
阿新 • • 發佈:2019-02-06
前言
相信大家在開發小程式時會遇到某個功能多次使用的情況,比如彈出框。這個時候大家首先想到的是元件化開發,就是把彈出框封裝成一個元件,然後哪裡使用哪裡就呼叫,對,看來大家都是有思路的人,但是要怎樣實現呢。可能你會去看官方文件,但是微信的官方文件也是說的不太清楚,所以寫起來也是非常痛苦。今天就帶大家手摸手開發微信元件,坐穩了,馬路殺手要開車了。
具體實現
我們先實現個簡單的彈窗元件,詳情圖如下:
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();
}
})
到此就結束,一個簡單的小外掛封裝好了
另外請大家多多提出意見,一起進步。