微信小程序实现自定义modal弹窗封装的方法
前言
小程序官方提供了 wx.showmodal
方法,但样式比较固定,不能满足多元化需求,自定义势在必行~
老规矩先上图
点击某个按钮,弹出 modal框,里面的内容可以自定义,可以是简单的文字提示,也可以输入框等复杂布局。操作完点击取消或确定关闭 modal.
如何使用
将下面的 modal.wxml 、modal.wxss 、modal.js 、modal.json 四个文件复制到对应位置即可。
封装完之后调用起来也很简单,看看调用的代码吧
<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>
需要传四个属性
show :用来控制 modal 的显示隐藏。
height : 定义 modal 的高度,可以是百分比,也可以是具体单位如 600rpx。
bindcancel :点击取消按钮的回调。
bindconfirm :点击确定按钮的回调。
自己的布局用一个 view 包起来放到 modal 标签里即可。
开始封装
首先在你存放自定义组件的文件夹里新建个 modal 文件夹,个人习惯将所有组件都放在 components 下面。
然后右键新建 component,注意是 component 不是 page ,因为要作为组件引入到页面中。
先看布局吧
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 蒙版,覆盖了整个页面。里面是包裹内容的 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浮层 * 使用方法: * <modal show="{{showmodal}}" height='60%' bindcancel="modalcancel" bindconfirm='modalconfirm'> <view>你自己需要展示的内容</view> </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 弹窗封装。如果不想要下面的确定取消两个按钮,内容区的所有内容都要外部传入,可以这样写
<view class='mask' wx:if='{{show}}' bindtap='clickmask'> <slot></slot> </view>
如果需要多个 slot 也可以,小程序都支持。
具体怎么实现看具体的业务需求吧,自定义的组件就是灵活性非常高,可以根据业务需求进行调整。
以上所述是小编给大家介绍的微信小程序实现自定义modal弹窗封装的方法,希望对大家有所帮助