1. 程式人生 > 程式設計 >微信小程式自定義modal彈窗元件的方法詳解

微信小程式自定義modal彈窗元件的方法詳解

微信小程式開發中官方自帶的wx.showModal,這個彈窗API有時候並不能滿足我們的彈窗效果,所以往往需要自定義modal元件。下面我們進行一個自定義modal彈窗元件的開發,並進行元件的引用,元件可自定義底部是一個還是兩個按鈕。效果如下。

在這裡插入圖片描述
在這裡插入圖片描述

首先我們可以在跟目錄下建立一個components資料夾存放所有的元件。新建一個modal資料夾,下面新建modal.js、modal.json、modal.wxml、modal.wxss四個檔案。

奮鬥奮鬥

modal.wxml佈局檔案:

<view class='modal-mask' wx:if='{{show}}' bindtap='clickMask'>
 <view class='modal-content'>
 <scroll-view scroll-y class='main-content'>
  <slot></slot>
 </scroll-view>
 <view class='modal-footer'>
  <view wx:if='{{!single}}' class='cancel-btn' bindtap='cancel'>取消</view>
  <view class='confirm-btn' bindtap='confirm'>確定 </view>
 </view>
 </view>
</view>

modal.wxml檔案中的一些說明:

show變數控制彈窗顯示或隱藏狀態,clickMask是點選遮罩層的事件,可控制點選遮罩是否隱藏modal彈窗,內容中用scroll-view是為了滿足當內容過多時一頁顯示不全時可以上下滾動瀏覽的效果(如果內容很少直接用view標籤也可以),scroll-y表示允許縱向滾動(如果不需要可以刪掉)。****為元件引用時的自定義內容替換掉就好了。single變數控制底部按鈕是一個還是兩個。cancel點選取消繫結的事件,confirm點選確定繫結的事件。

modal.json檔案內容:

{
 "component": true,"usingComponents": {}
}

modal.json檔案內容說明:

“component”: true,表示這是一個元件檔案,usingComponents用於引用別的元件,這裡沒引用其他元件空{}就行。

modal.wxss 檔案樣式

/* components/modal/modal.wxss */
/*遮罩層*/
.modal-mask{
 display: flex;
 justify-content: center;
 align-items: center;
 position: fixed;
 left: 0;
 right: 0;
 top: 0;
 bottom: 0;
 background-color: rgba(0,0.5);
 z-index: 999;
}
/*遮罩內容*/
.modal-content{
 display: flex;
 flex-direction: column;
 width: 80%;
 background-color: #fff;
 border-radius: 10rpx;
 padding: 20rpx;
 text-align: center;
}
/*中間內容*/
.main-content{
 flex: 1;
 height: 100%;
 overflow-y: hidden; 
 max-height: 80vh; /* 內容高度最高80vh 以免內容太多溢位*/
}
/*底部按鈕*/
.modal-footer{
 display: flex;
 flex-direction: row;
 height: 80rpx;
 line-height: 80rpx;
 border-top: 2rpx solid #D2D3D5;
 margin-top: 30rpx;
}
.cancel-btn,.confirm-btn{
 flex: 1;
 height: 100rpx;
 line-height: 100rpx;
 text-align: center;
 font-size: 32rpx;
}
.cancel-btn{
 color: #000;
 border-right: 2rpx solid #D2D3D5;
}
.confirm-btn {
 color: #09BA07
}

以上樣式佈局根據個人需求自行修改調整即可。

modal.js檔案內容

Component({
 /**
 * 元件的屬性列表
 */
 properties: {
 //是否顯示modal彈窗
 show: {
  type: Boolean,value: false
 },//控制底部是一個按鈕還是兩個按鈕,預設兩個
 single: {
  type: Boolean,value: false 
 }
 },/**
 * 元件的初始資料
 */
 data: {

 },/**
 * 元件的方法列表
 */
 methods: {
 // 點選modal的回撥函式
 clickMask() {
  // 點選modal背景關閉遮罩層,如果不需要註釋掉即可
  this.setData({show: false})
 },// 點選取消按鈕的回撥函式
 cancel() {
  this.setData({ show: false })
  this.triggerEvent('cancel') //triggerEvent觸發事件
 },// 點選確定按鈕的回撥函式
 confirm() {
  this.setData({ show: false })
  this.triggerEvent('confirm')
 }
 }
})

到此為止,元件已經定義好了。下面我們可以在其他頁面引用這個元件了。比如我在home這個頁面引用這個自定義modal彈窗。

在這裡插入圖片描述

首先在home.json檔案中引用元件:

home.json檔案內容如下:

{
	"usingComponents": {
 		"modalView": "../../components/modal/modal"
	}
}

這裡modalView為modal彈窗的自定義標籤,可隨便定義。

接著,在home.wxml中將modalView標籤新增到你想要顯示的位置。例如:

home.wxml檔案內容如下

<view>
 <!-- modal彈窗-->
 <modalView show="{{showModal}}" bindcancel="modalCancel" bindconfirm='modalConfirm' single='{{single}}'>
 <view class='modal-content'>
  <scroll-view scroll-y class='main-content'>
  <view>這裡面可替換成你想顯示的其他內容</view>
  <view>這裡面可替換成你想顯示的其他內容</view>
  <text>這裡面可替換成你想顯示的其他內容</text>
  </scroll-view>
 </view>
 </modalView>
</view>

home.js檔案內容如下

Page({

 /**
 * 頁面的初始資料
 */
 data: {
 showModal: true,// 顯示modal彈窗
 single: false // false 只顯示一個按鈕,如果想顯示兩個改為true即可
 },/**
 * 生命週期函式--監聽頁面載入
 */
 onLoad: function (options) {

 },// 點選取消按鈕的回撥函式
 modalCancel(e) {
 // 這裡面處理點選取消按鈕業務邏輯
 console.log('點選了取消')
 },// 點選確定按鈕的回撥函式
 modalConfirm(e) {
 // 這裡面處理點選確定按鈕業務邏輯
 console.log('點選了確定')
 }
})

在js檔案中定義showModal控制modal彈窗的顯示狀態,single設定為false 表示只顯示一個按鈕

在這裡插入圖片描述

如果想顯示兩個按鈕將false改為true即可,如下效果:

在這裡插入圖片描述

兩個函式modalCancel和modalConfirm用於處理點選取消按鈕業務邏輯

和處理點選確定按鈕業務邏輯。比如我這裡點選了確認按鈕可看到控制檯打印出了“點選了確定”。

在這裡插入圖片描述

好了,微信小程式一個自定義modal彈窗的元件封裝和引用方法就這麼搞定了O(∩_∩)O~

到此這篇關於微信小程式自定義modal彈窗元件的文章就介紹到這了,更多相關微信小程式自定義modal彈窗元件內容請搜尋我們以前的文章或繼續瀏覽下面的相關文章希望大家以後多多支援我們!