微信小程序实现自定义modal弹窗封装的方法

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

image

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

点击某个按钮，弹出 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没啥讲的，直接复制过去就行。注意：将 .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 也可以，小程序都支持。具体怎么实现看具体的业务需求吧，自定义的组件就是灵活性非常高，可以根据业务需求进行调整。