小程序自定义modal弹窗封装实现

前言

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

老规矩先上图

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

如何使用

将下面的 modal.wxmlmodal.wxssmodal.jsmodal.json 四个文件复制到对应位置即可。

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

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

复制代码

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

上面的代码简化一下就是

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

复制代码

需要传四个属性

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

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

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

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

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

开始封装

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

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

先看布局吧

modal.wxml

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

复制代码

布局讲解

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

这里把 slotscroll-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没啥讲的,直接复制过去就行。

注意几个点:

.maskz-index 设置的高一些,确保能在所有布局的最上层。

modal.js


/**
 * 自定义modal浮层
 * 使用方法:
 * "{{showModal}}" height='60%' bindcancel="modalCancel" bindconfirm='modalConfirm'>
     你自己需要展示的内容
  

  属性说明:
  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 中定义两个需传入的属性 showheight ,并指定默认值。

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

modal.json

{
  "component": true,
  "usingComponents": {}
}
复制代码

json 主要是声明 modal 为组件

结语

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

'mask' wx:if='{{show}}' bindtap='clickMask'>
   

复制代码

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

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

你可能感兴趣的:(小程序自定义modal弹窗封装实现)