微信小程序?qū)崿F(xiàn)自定義modal彈窗封裝的方法

小程序官方提供了 wx.showModal 方法,但樣式比較固定,不能滿足多元化需求,自定義勢在必行。

image
 ![image](https://upload-images.jianshu.io/upload_images/5444221-7b99afe228c17d67.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)

點(diǎn)擊某個(gè)按鈕,彈出 modal框,里面的內(nèi)容可以自定義,可以是簡單的文字提示,也可以輸入框等復(fù)雜布局。操作完點(diǎn)擊取消或確定關(guān)閉 modal。

如何使用

將下面的 modal.wxml 、modal.wxss 、modal.js 、modal.json 四個(gè)文件復(fù)制到對應(yīng)位置即可。封裝完之后調(diào)用起來也很簡單,看看調(diào)用的代碼。

<modal show="{{showModal}}" height='60%' bindcancel="modalCancel" bindconfirm='modalConfirm'>
  <view class='modal-content'> 
    <formrow wx:for='{{goodsList}}' wx:key='{{index}}' title="{{item.name}}" placeholder='庫存{{item.store}}' mode='input' rowpadding='10rpx' currentId="{{index}}" bindinput='goodsInput'></formrow>
  </view>
</modal>

在modal中定義了 slot,所以可以將需要展示的任何布局包裹在 modal 中。上面的代碼簡化一下就是:

<modal show="{{showModal}}" height='60%' bindcancel="modalCancel" bindconfirm='modalConfirm'>
  <view class='modal-content'>你自己的布局</view>
</modal>

需要傳四個(gè)屬性

  • show :用來控制 modal 的顯示隱藏。
  • height : 定義 modal 的高度,可以是百分比,也可以是具體單位如 600rpx。
  • bindcancel :點(diǎn)擊取消按鈕的回調(diào)。
  • bindconfirm :點(diǎn)擊確定按鈕的回調(diào)。

自己的布局用一個(gè) view 包起來放到 modal 標(biāo)簽里即可。

開始封裝
首先在你存放自定義組件的文件夾里新建個(gè) modal 文件夾,個(gè)人習(xí)慣將所有組件都放在 components 下面。然后右鍵新建 component,注意是 component 不是 page ,因?yàn)橐鳛榻M件引入到頁面中。

modal.wxml

<view class='mask' wx:if='{{show}}' bindtap='clickMask'>
  <view class='modal-content' style='height:{{height}}'>
    <scroll-view scroll-y class='main-content'>
      <slot></slot>
    </scroll-view>
    <view class='modal-btn-wrapper'>
      <view class='cancel-btn' style='color:rgba(7,17,27,0.6)' bindtap='cancel'>取消</view>
      <view class='confirm-btn' style='color:#13b5f5' bindtap='confirm'>確定</view>
    </view>
  </view>
</view>

最外層是半透明的 mask 蒙版,覆蓋了整個(gè)頁面。里面是包裹內(nèi)容的 view ,內(nèi)容區(qū)有兩層,上面是放置傳入布局的主內(nèi)容區(qū),下面是取消和確定兩個(gè)按鈕。這里把 slot 用 scroll-view 包裹了起來,處理了傳入的布局高度超出內(nèi)容區(qū)域的問題,如果超出將會滾動(dòng)。所以不必?fù)?dān)心傳入的布局高度,大膽用就行。內(nèi)容區(qū)的高度通過屬性傳入的 height 確定,默認(rèn)是 80%

modal.wxss

.mask{ position: absolute; left: 0; right: 0; top: 0; bottom: 0; display: flex; justify-content: center; align-items: center; background-color: rgba(0,0,0,0.4); z-index: 9999;
} .modal-content{ display: flex; flex-direction: column; width: 90%;
  /* height: 80%; */ background-color: #fff; border-radius: 10rpx;
} .modal-btn-wrapper{ display: flex; flex-direction: row; height: 100rpx; line-height: 100rpx; border-top: 2rpx solid rgba(7,17,27,0.1);
} .cancel-btn, .confirm-btn{ flex: 1; height: 100rpx; line-height: 100rpx; text-align: center; font-size: 32rpx;
} .cancel-btn{ border-right: 2rpx solid rgba(7,17,27,0.1);
} .main-content{ flex: 1; height: 100%; overflow-y: hidden; 
}

css沒啥講的,直接復(fù)制過去就行。注意:將 .mask 的 z-index 設(shè)置的高一些,確保能在所有布局的最上層。

modal.js

/**
* 自定義modal浮層
* 使用方法:
* <modal show="{{showModal}}" height='60%' bindcancel="modalCancel" bindconfirm='modalConfirm'>
<view>你自己需要展示的內(nèi)容</view>
</modal>

屬性說明:
show: 控制modal顯示與隱藏
height:modal的高度
bindcancel:點(diǎn)擊取消按鈕的回調(diào)函數(shù)
bindconfirm:點(diǎn)擊確定按鈕的回調(diào)函數(shù)

使用模塊:
場館 -> 發(fā)布 -> 選擇使用物品 */ Component({/**
  * 組件的屬性列表
  */ properties: {//是否顯示modal
    show: {
      type: Boolean,
      value: false },//modal的高度
    height: {
      type: String,
      value: '80%' }
  },/**
  * 組件的初始數(shù)據(jù)
  */ data: {

  },/**
  * 組件的方法列表
  */ methods: {
    clickMask() {// this.setData({show: false})
    },

    cancel() {
      this.setData({ show: false })this.triggerEvent('cancel')
    },

    confirm() {
      this.setData({ show: false })this.triggerEvent('confirm')
    }
  }
});

Js 代碼也很簡單,在 properties 中定義兩個(gè)需傳入的屬性 show 和 height ,并指定默認(rèn)值。在 methods 中寫點(diǎn)擊取消和確定按鈕的回調(diào),點(diǎn)擊按鈕后先通過 this.setData({ show: false }) 將 modal 隱藏掉,再通過 this.triggerEvent('confirm') 將點(diǎn)擊事件傳遞出去。

modal.json

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

json 主要是聲明 modal 為組件

結(jié)語

以上就是簡單的 modal 彈窗封裝。如果不想要下面的確定取消兩個(gè)按鈕,內(nèi)容區(qū)的所有內(nèi)容都要外部傳入,可以這樣寫

<view class='mask' wx:if='{{show}}' bindtap='clickMask'>
<slot></slot>
</view>

如果需要多個(gè) slot 也可以,小程序都支持。具體怎么實(shí)現(xiàn)看具體的業(yè)務(wù)需求吧,自定義的組件就是靈活性非常高,可以根據(jù)業(yè)務(wù)需求進(jìn)行調(diào)整。

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容