# 简单的弹窗组件实现

最近在使用element-ui框架,用到了Dialog对话框组件,大致实现的效果,跟我之前自己在移动端项目里面弄的一个弹窗组件差不太多。然后就想着把这种弹窗组件的实现方式与大家分享一下,下面本文会带着大家手摸手实现一个弹窗组件。

本文主要内容会涉及到弹窗遮罩的实现,slot插槽的使用方式,props$emit传参,具体组件代码也传上去了。如果喜欢的话可以点波赞/关注,支持一下,希望大家看完本文可以有所收获。


# 组件最后实现的效果

# 实现步骤

  1. 先搭建组件的html和css样式,遮罩层和内容层。
  2. 定制弹窗内容:弹窗组件通过slot插槽接受从父组件那里传过来弹窗内容。
  3. 定制弹窗样式:弹窗组件通过props接收从父组件传过来的弹窗宽度,上下左右的位置。
  4. 组件开关:通过父组件传进来的props控制组件的显示与隐藏,子组件关闭时通过事件$emit触发父组件改变值。

# 1.搭建组件的html和css样式。

html结构:一层遮罩层,一层内容层,内容层里面又有一个头部title和主体内容和一个关闭按钮。

下面是组件中的html结构,里面有一些后面才要加进去的东西,如果看不懂的话可以先跳过,

<template>
   <div class="dialog">
       <!--外层的遮罩 点击事件用来关闭弹窗,isShow控制弹窗显示 隐藏的props-->
       <div class="dialog-cover back"  v-if="isShow"  @click="closeMyself"></div>
       <!-- transition 这里可以加一些简单的动画效果 -->
       <transition name="drop">
           <!--style 通过props 控制内容的样式  -->
         <div class="dialog-content" :style="{top:topDistance+'%',width:widNum+'%',left:leftSite+'%'}"  v-if="isShow">
           <div class="dialog_head back">
               <!--弹窗头部 title-->
               <slot name="header">提示信息</slot>
           </div>
           <div class="dialog_main" :style="{paddingTop:pdt+'px',paddingBottom:pdb+'px'}">
             <!--弹窗的内容-->
             <slot name="main">弹窗内容</slot>
           </div>
           <!--弹窗关闭按钮-->
           <div  class="foot_close" @click="closeMyself">
               <div class="close_img back"></div>
           </div>
         </div>
     </transition>
   </div>
</template>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

下面是组件中的主要的css样式,里面都做了充分的注释,主要通过z-indexbackground达到遮罩的效果,具体内容的css可以根据自己的需求来设置。

<style lang="scss" scoped>
  /* 最外层 设置position定位  */
  .dialog {
    position: relative;
    color: #2e2c2d;
    font-size: 16px;
  }
  /* 遮罩 设置背景层,z-index值要足够大确保能覆盖,高度 宽度设置满 做到全屏遮罩 */
  .dialog-cover {
    background: rgba(0,0,0, 0.8);
    position: fixed;
    z-index: 200;
    top: 0;
    left: 0;
    width: 100%;
    height: 100%;
  }
  /* 内容层 z-index要比遮罩大,否则会被遮盖, */
  .dialog-content{
    position: fixed;
    top: 35%;
    /* 移动端使用felx布局  */
    display: flex;
    flex-direction: column;
    justify-content: center;
    align-items: center;
    z-index: 300;
  }
</style>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

# 2. 通过slot定制弹窗内容

这一步,只要理解了slot的作用以及用法,就没有问题了。

# 单个插槽:

<slot>这是在没有slot传进来的时候,才显示的弹窗内容</slot>
1

上面是单个插槽也叫默认插槽,在父组件中使用插槽的正确姿势:

<my-component>
  <!--在my-component里面的所有内容片段都将插入到slot所在的DOM位置,并且会替换掉slot标签-->
  <!--这两个p标签,将替换整个slot标签里面的内容-->
  <p>这是一些初始内容</p>
  <p>这是更多的初始内容</p>
</my-component>
1
2
3
4
5
6

ps:如果子组件里面包含slot插槽,那么上面的p标签的内容将会被丢弃。

# 具名插槽:

所谓的具名插槽,即为slot标签赋一个name属性,具名插槽可以父组件中不同的内容片段放到子组件的不同地方,具名插槽还是可以拥有一个默认插槽。下面可以看一下弹窗组件插槽的使用方式:

<div class="dialog_head back ">
 <!--弹窗头部 title-->
 <slot name="header">提示信息</slot>
 </div>
 <div class="dialog_main " :style="{paddingTop:pdt+'px',paddingBottom:pdb+'px'}">
   <!--弹窗的内容-->
 <slot name="main">弹窗内容</slot>
</div>
1
2
3
4
5
6
7
8

在父组件中的使用方式:

  1. 将弹窗组件引入要使用的组件中,并通过components注册成为组件。
  2. 父组件中弹窗组件插槽的使用方法如下。
<dialogComponent>
    <div slot="header">插入到name为header的slot标签里面</div>
      <div class="dialog_publish_main" slot="main">
        这里是内容插入到子组件的slot的name为main里面,可以在父组件中添加class定义样式,事件类型等各种操作
      </div>
</dialogComponent>
1
2
3
4
5
6

关于组件中用到的插槽的介绍就到这里了,插槽在弹窗组件中的应用是一个典型的栗子,可以看到插槽作用相当强大,而插槽本身的使用并不难,同学们爱上插槽了没有?


# 3.通过props控制弹窗显隐&&定制弹窗style

psops是Vue中父组件向子组件传递数据的一种方式,不熟悉的小伙伴们可以看一下props文档

因为弹窗组件都是引到别的组件里面去用的,为了适合不同组件场景中的弹窗,所以弹窗组件必须具备一定的可定制性,否则这样的组件将毫无意义,下面介绍一下props的使用方式,以弹窗组件为例:

  1. 首先需要在被传入的组件中定义props的一些特性,验证之类的。
  2. 然后在父组件中绑定props数据。
<script>
export default {
  props: {
    isShow: { 
    //弹窗组件是否显示 默认不显示
      type: Boolean,
      default: false,
      required:true, //必须
    },
    //下面这些属性会绑定到div上面 详情参照上面的html结构
    // 如: :style="{top:topDistance+'%',width:widNum+'%'}"
    widNum:{ 
    //内容宽度
      type: Number,
      default:86.5
    },
    leftSite:{
      // 左定位
      type: Number,
      default:6.5
    },
    topDistance: {
        //top上边距
      type: Number,
      default:35
    },
    pdt:{
      //上padding
      type: Number,
      default:22
    },
    pdb:{
      //下padding
      type: Number,
      default:47
    }
  },
}
</script>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

父组件中使用方式:

<dialogComponent :is-show="status.isShowPublish" :top-distance="status.topNum">
</dialogComponent>
1
2

ps:props传递数据不是双向绑定的,而是单向数据流,父组件的数据变化时,也会传递到子组件中,这就意外着我们不应该在子组件中修改props。所以我们在关闭弹窗的时候就需要通过$emit来修改父组件的数据,然后数据会自动传到子组件中。

现在基本上弹窗组件都已实现的差不多了,还差一个弹窗的关闭事件,这里就涉及到子组件往父组件传参了。

# 4.$emit触发父组件事件修改数据,关闭弹窗

Vue中在子组件往父组件传参,很多都是通过$emit来触发父组件的事件来修改数据。

在子组件中,在点击关闭,或者遮罩层的时候触发下面这个方法:

methods: {
  closeMyself() {
    this.$emit("on-close"); 
    //如果需要传参的话,可以在"on-close"后面再加参数,然后在父组件的函数里接收就可以了。
  }
} 
1
2
3
4
5
6

父组件中的写法:

<dialogComponent :is-show="status.isShowPublish" :top-distance="status.topNum"  @on-close="closeDialog"> 
</dialogComponent>
//"on-close是监听子组件的时间有没有触发,触发的时候执行closeDialog函数
methods:{
  closeDialog(){
    // this.status.isShowPublish=false;
    //把绑定的弹窗数组 设为false即可关闭弹窗
  },
}
1
2
3
4
5
6
7
8
9

可以用弹窗组件实现下列这种信息展示,或者事件交互:

# 弹窗组件代码

上面是把弹窗的每个步骤拆分开来,一步步解析的,每一步都说的比较清楚了,具体连起来的话,可以看看代码,再结合文章就能理的很清楚了。

# 小结:

这个弹窗组件,实现起来一点都不难,我这里主要是提供了一个实现方式,当项目中有需要的话,大家也可以自己撸一个出来,以上就是本文的内容了,希望同学们看完能有所收获。

以上2018.4.21

# 参考资料:

Vue文档-插槽

# 点个Star支持我一下~

最后更新时间: 8/2/2019, 12:38:18 PM