利用vue实现模态框组件

基本上每个项目都需要用到模态框组件，由于在最近的项目中，alert组件和confirm是两套完全不一样的设计，所以我将他们分成了两个组件，本文主要讨论的是confirm组件的实现。

组件结构

<template>
 <div class="modal" v-show="show" transition="fade">
  <div class="modal-dialog">
   <div class="modal-content">
    <!--头部-->
    <div class="modal-header">
     <slot name="header">
      <p class="title">{{modal.title}}</p>
     </slot>
     <a v-touch:tap="close(0)" class="close" href="javascript:void(0)"></a>
    </div>
    <!--内容区域-->
    <div class="modal-body">
     <slot name="body">
      <p class="notice">{{modal.text}}</p>
     </slot>
    </div>
    <!--尾部,操作按钮-->
    <div class="modal-footer">
     <slot name="button">
      <a v-if="modal.showCancelButton" href="javascript:void(0)" class="button {{modal.cancelButtonClass}}" v-touch:tap="close(1)">{{modal.cancelButtonText}}</a>
      <a v-if="modal.showConfirmButton" href="javascript:void(0)" class="button {{modal.confirmButtonClass}}" v-touch:tap="submit">{{modal.confirmButtonText}}</a>
     </slot>
    </div>
   </div>
  </div>
 </div>
 <div v-show="show" class="modal-backup" transition="fade"></div>
</template> 

模态框结构分为三部分，分别为头部、内部区域和操作区域，都提供了slot，可以根据需要定制。

样式

.modal {
 position: fixed;
 left: 0;
 top: 0;
 right: 0;
 bottom: 0;
 z-index: 1001;
 -webkit-overflow-scrolling: touch;
 outline: 0;
 overflow: scroll;
 margin: 30/@rate auto;
}
.modal-dialog {
 position: absolute;
 left: 50%;
 top: 0;
 transform: translate(-50%,0);
 width: 690/@rate;
 padding: 50/@rate 40/@rate;
 background: #fff;
}
.modal-backup {
 position: fixed;
 top: 0;
 right: 0;
 bottom: 0;
 left: 0;
 z-index: 1000;
 background: rgba(0, 0, 0, 0.5);
}

这里只是一些基本样式，没什么好说的，这次项目是在移动端，用了淘宝的自适应布局方案，@rate是切稿时候的转换率。

接口定义

/**
 * modal 模态接口参数
 * @param {string} modal.title 模态框标题
 * @param {string} modal.text 模态框内容
 * @param {boolean} modal.showCancelButton 是否显示取消按钮
 * @param {string} modal.cancelButtonClass 取消按钮样式
 * @param {string} modal.cancelButtonText 取消按钮文字
 * @param {string} modal.showConfirmButton 是否显示确定按钮
 * @param {string} modal.confirmButtonClass 确定按钮样式
 * @param {string} modal.confirmButtonText 确定按钮标文字
 */
props: ['modalOptions'],
computed: {
 /**
  * 格式化props进来的参数,对参数赋予默认值
  */
 modal: {
  get() {
   let modal = this.modalOptions;
   modal = {
    title: modal.title || '提示',
    text: modal.text,
    showCancelButton: typeof modal.showCancelButton === 'undefined' ? true : modal.showCancelButton,
    cancelButtonClass: modal.cancelButtonClass ? modal.showCancelButton : 'btn-default',
    cancelButtonText: modal.cancelButtonText ? modal.cancelButtonText : '取消',
    showConfirmButton: typeof modal.showConfirmButton === 'undefined' ? true : modal.cancelButtonClass,
    confirmButtonClass: modal.confirmButtonClass ? modal.confirmButtonClass : 'btn-active',
    confirmButtonText: modal.confirmButtonText ? modal.confirmButtonText : '确定',
   };
   return modal;
  },
 },
},

这里定义了接口的参数，可以自定义标题、内容、是否显示按钮和按钮的样式，用一个computed来做参数默认值的控制。

模态框内部方法

data() {
 return {
  show: false, // 是否显示模态框
  resolve: '',
  reject: '',
  promise: '', // 保存promise对象
 };
},
methods: {
 /**
  * 确定,将promise断定为完成态
  */
 submit() {
  this.resolve('submit');
 },
 /**
  * 关闭,将promise断定为reject状态
  * @param type {number} 关闭的方式 0表示关闭按钮关闭,1表示取消按钮关闭
  */
 close(type) {
  this.show = false;
  this.reject(type);
 },
 /**
  * 显示confirm弹出,并创建promise对象
  * @returns {Promise}
  */
 confirm() {
  this.show = true;
  this.promise = new Promise((resolve, reject) => {
   this.resolve = resolve;
   this.reject = reject;
  });
  return this.promise; //返回promise对象,给父级组件调用
 },
},

在模态框内部定义了三个方法，最核心部分confirm方法，这是一个定义在模态框内部，但是是给使用模态框的父级组件调用的方法，该方法返回的是一个promise对象，并将resolve和reject存放于modal组件的data中，点击取消按钮时，断定为reject状态，并将模态框关闭掉，点确定按钮时，断定为resolve状态，模态框没有关闭，由调用modal组件的父级组件的回调处理完成后手动控制关闭模态框。

调用

<!-- template -->
<confirm v-ref:dialog :modal-options.sync="modal"></confirm>
<!-- methods -->
this.$refs.dialog.confirm().then(() => {
 // 点击确定按钮的回调处理
 callback();
 this.$refs.dialog.show = false; 
}).catch(() => {
 // 点击取消按钮的回调处理
 callback();
});

用v-ref创建一个索引,就很方便拿到模态框组件内部的方法了。这样一个模态框组件就完成了。

其他实现方法

在模态框组件中，比较难实现的应该是点击确定和取消按钮时，父级的回调处理，我在做这个组件时，也参考了一些其实实现方案。

使用事件转发

这个方法是我的同事实现的，用在上一个项目，采用的是$dispatch和$broadcast来派发或广播事件。

首先在根组件接收dispatch过来的transmit事件，再将transmit事件传递过来的eventName广播下去

events: {
 /**
  * 转发事件
  * @param {string} eventName 事件名称
  * @param {object} arg  事件参数
  * @return {null}
  */
 'transmit': function (eventName, arg) {
  this.$broadcast(eventName, arg);
 }
},

其次是模态框组件内部接收从父级组件传递过来的确定和取消按钮所触发的事件名，点击取消和确定按钮的时候触发

// 接收事件，获得需要取消和确定按钮的事件名
events: {
 'tip': function(obj) {
  this.events = {
   cancel: obj.events.cancel,
   confirm: obj.events.confirm
  }
 }
}
// 取消按钮
cancel：function() {
 this.$dispatch('transmit',this.events.cancel);
}
// 确定按钮
submit: function() {
 this.$dispatch('transmit',this.events.submit);
}

在父级组件中调用模态框如下：

this.$dispatch('transmit','tip',{
 events: {
  confirm: 'confirmEvent'
 }
});
this.$once('confirmEvent',function() {
 callback();
}

先是传递tip事件，将事件名传递给模态框，再用$once监听确定或取消按钮所触发的事件，事件触发后进行回调。

这种方法看起来是不是很晕？所以vue 2.0取消了$dispatch和$broadcast，我们在最近的项目中虽然还在用1.0，但是也不再用$dispatch和$broadcast，方便以后的升级。

使用emit来触发

这种方法来自vue-bootstrap-modal,点击取消和确定按钮的时候分别emit一个事件，直接在组件上监听这个事件，这种做法的好处是事件比较容易追踪。

// 确定按钮
ok () {
 this.$emit('ok');
 if (this.closeWhenOK) {
  this.show = false;
 }
},
// 取消按钮
cancel () {
 this.$emit('cancel');
 this.show = false;
},

调用：

<modal title="Modal Title" :show.sync="show" @ok="ok" @cancel="cancel">
 Modal Text
</modal>

但是我们在使用的时候经常会遇到这样的场景，在一个组件的内部，经常会用到多个对话框，对话框可能只是文字有点区别，回调不同，这时就需要在template中为每个对话框都写一次，有点麻烦。

参考资料

vue.js dynamic create nest modal
es6 Promise对象
vue-bootstrap-modal

本文已被整理到了《Vue.js前端组件学习教程》，欢迎大家学习阅读。

关于vue.js组件的教程，请大家点击专题vue.js组件学习教程进行学习。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

# vue模态框组件  # vue实现模态框  # vue组件  # Vue.js弹出模态框组件开发的示例代码  # vue+element 模态框表格形式的可编辑表单实现  # vue+element模态框中新增模态框和删除功能  # vue实现模态框的通用写法推荐  # vue.extend实现alert模态框弹窗组件  # 详解如何用VUE写一个多用模态框组件模版  # vue移动端模态框(可传参)的实现  # 详解vue父子组件关于模态框状态的绑定方案  # Vue.extend 登录注册模态框的实现  # Vue dialog模态框的封装方法  # 模态  # 回调  # 的是  # 对话框  # 并将  # 再用  # 经常会  # 默认值  # 也不  # 是在  # 我在  # 成了  # 这种方法  # 还在  # 多个  # 已被  # 不是很  # 请大家  # 这是一个  # 用了 

相关文章： 如何做网站制作流程,*游戏网站怎么搭建？  如何零基础开发自助建站系统？完整教程解析  矢量图网站制作软件,用千图网的一张矢量图做公司app首页，该网站并未说明版权等问题，这样做算不算侵权？应该如何解决？  图册素材网站设计制作软件,图册的导出方式有几种？  如何在IIS中新建站点并配置端口与IP地址？  大连企业网站制作公司,大连2025企业社保缴费网上缴费流程？  网站规划与制作是什么,电子商务网站系统规划的内容及步骤是什么？  学校免费自助建站系统：智能生成+拖拽设计+多端适配  制作营销网站公司,淘特是干什么用的？  建站之星IIS配置教程：代码生成技巧与站点搭建指南  如何在IIS服务器上快速部署高效网站？  如何在企业微信快速生成手机电脑官网？  C#如何使用XPathNavigator高效查询XML  建站之星如何一键生成手机站？  济南网站制作的价格,历城一职专官方网站？  如何快速查询网站的真实建站时间？  中山网站制作网页,中山新生登记系统登记流程？  如何在阿里云完成域名注册与建站？  建站之星后台密码如何安全设置与找回？  如何零基础在云服务器搭建WordPress站点？  宿州网站制作公司兴策,安徽省低保查询网站？  如何制作新型网站程序文件,新型止水鱼鳞网要拆除吗？  佛山企业网站制作公司有哪些,沟通100网上服务官网？  高性能网站服务器部署指南：稳定运行与安全配置优化方案  南京网站制作费用,南京远驱官方网站？  详解jQuery停止动画——stop()方法的使用  网站制作公司排行榜,抖音怎样做个人官方网站  如何用景安虚拟主机手机版绑定域名建站？  韩国服务器如何优化跨境访问实现高效连接？  如何通过智能用户系统一键生成高效建站方案？  油猴 教程,油猴搜脚本为什么会网页无法显示？  如何在建站之星绑定自定义域名？  合肥制作网站的公司有哪些,合肥聚美网络科技有限公司介绍？  智能起名网站制作软件有哪些,制作logo的软件？  如何选择域名并搭建高效网站？  制作网站的公司有哪些,做一个公司网站要多少钱？  建站主机与虚拟主机有何区别？如何选择最优方案？  西安市网站制作公司,哪个相亲网站比较好?西安比较好的相亲网站？  建站上传速度慢？如何优化加速网站加载效率？  微课制作网站有哪些,微课网怎么进？  c# 在ASP.NET Core中管理和取消后台任务  香港服务器网站推广：SEO优化与外贸独立站搭建策略  如何通过FTP服务器快速搭建网站？  青浦网站制作公司有哪些,苹果官网发货地是哪里？  制作网站软件推荐手机版,如何制作属于自己的手机网站app应用？  制作农业网站的软件,比较好的农业网站推荐一下？  如何快速完成中国万网建站详细流程？  建站中国官网：模板定制+SEO优化+建站流程一站式指南  如何用PHP工具快速搭建高效网站？  如何快速打造个性化非模板自助建站？