php封装弹窗组件,小程序自定义modal弹窗封装实现

前言

小程序官方提供了 wx.showModal 方法，但样式比较固定，不能满足多元化需求，自定义势在必行~

老规矩先上图

点击某个按钮，弹出 modal框，里面的内容可以自定义，可以是简单的文字提示，也可以输入框等复杂布局。操作完点击取消或确定关闭 modal.

如何使用

将下面的 modal.wxml 、modal.wxss 、modal.js 、modal.json 四个文件复制到对应位置即可。

封装完之后调用起来也很简单，看看调用的代码吧

在modal中定义了 slot，所以可以将需要展示的任何布局包裹在 modal 中。

上面的代码简化一下就是

你自己的布局

需要传四个属性

show ：用来控制 modal 的显示隐藏。

height : 定义 modal 的高度，可以是百分比，也可以是具体单位如 600rpx。

bindcancel ：点击取消按钮的回调。

bindconfirm ：点击确定按钮的回调。

自己的布局用一个 view 包起来放到 modal 标签里即可。

开始封装

首先在你存放自定义组件的文件夹里新建个 modal 文件夹，个人习惯将所有组件都放在 components 下面。

然后右键新建 component，注意是 component 不是 page ，因为要作为组件引入到页面中。

先看布局吧

modal.wxml

取消

确定

布局讲解

最外层是半透明的 mask 蒙版，覆盖了整个页面。里面是包裹内容的 view ，内容区有两层，上面是放置传入布局的主内容区，下面是取消和确定两个按钮。

这里把 slot 用 scroll-view 包裹了起来，处理了传入的布局高度超出内容区域的问题，如果超出将会滚动。所以不必担心传入的布局高度，大胆用就行。

内容区的高度通过属性传入的 height 确定，默认是 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讲解

css没啥讲的，直接复制过去就行。

注意几个点：

将 .mask 的 z-index 设置的高一些，确保能在所有布局的最上层。

modal.js

/**

* 自定义modal浮层

* 使用方法：

*

你自己需要展示的内容

属性说明：

show： 控制modal显示与隐藏

height：modal的高度

bindcancel：点击取消按钮的回调函数

bindconfirm：点击确定按钮的回调函数

使用模块：

场馆 -> 发布 -> 选择使用物品

*/

Component({

/**

* 组件的属性列表

*/

properties: {

//是否显示modal

show: {

type: Boolean,

value: false

},

//modal的高度

height: {

type: String,

value: '80%'

}

},

/**

* 组件的初始数据

*/

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 中定义两个需传入的属性 show 和 height ，并指定默认值。

在 methods 中写点击取消和确定按钮的回调，点击按钮后先通过 this.setData({ show: false }) 将 modal 隐藏掉，再通过 this.triggerEvent('confirm') 将点击事件传递出去。

modal.json

{

"component": true,

"usingComponents": {}

}

json 主要是声明 modal 为组件

结语

以上就是简单的 modal 弹窗封装。如果不想要下面的确定取消两个按钮，内容区的所有内容都要外部传入，可以这样写

如果需要多个 slot 也可以，小程序都支持。

具体怎么实现看具体的业务需求吧，自定义的组件就是灵活性非常高，可以根据业务需求进行调整。