阅读 172

vue使用slot插槽技术封装一个dialog弹出框组件(组件化编程思想)

封装dialog组件前的插槽技术复习

为什么要封装组件(组件化开发)

组件化开发(封装组件)的好处

好处显而易见,可以增加代码的复用性、灵活性,从而提高开发效率。试想如果一个项目中在很多页面都能用到一个弹出框,若在每个页面都去写一套弹出框的结构样式和对应js的逻辑。这样的话,开发效率会大打折扣。毕竟现在产品经理都提倡敏捷开发(跑得快游戏)。

组件化开发的理解

假设我们封装好一个公共的弹框组件,哪里需要使用就引用到哪里就行了。

什么???不同页面的弹出框有的数据不太一样?有的是新增数据弹出框、有的是修改数据弹出框、还有的是删除数据弹出框。没关系!根据弹出框文字不同,往里面传不同参就行了。比如新增弹出框,传入‘新增’二字;修改弹出框,就传入‘修改’二字,依次类推。

什么???不同弹出框有的宽一点有的高一点样式略微不同,没关系,使用深度作用域选择器/deep/去设置就行啦

什么???不同弹出框点击确认按钮,最终的业务逻辑不一样,有的是增加一条数据、有的是删除一条数据等。没关系组件间的数据传递,事件的相关触发的语法记住就行啦

封装组件比较常用的技术之一就是插槽,在我们封装dialog组件之前,我们先来再复习一下插槽的相关知识。

为什么要有插槽

插槽api的诞生源自于vue数据传递的需求,因为平常我们使用props父向子传递数据,传递的数据都是对象、数组、字符串等"js类型的数据"。当我们想要传递大量的html类型的片段数据怎么办?

有这样的需求,于是插槽的技术就应运而生了。

组件化编程中,css不怎么需要传递,因为我们可以通过深度作用域选择器,如/deep/去在父组件中选中子组件中的dom元素去设置样式

插槽的分类

  • 默认插槽(又叫:普通插槽、单个插槽,匿名插槽。即不带名字的,不用设置name属性 <slot></slot>这样的)
  • 具名插槽(带个名字的 <slot name="footer"></slot>这样的,拥有name属性的)
  • 作用域插槽(这个是插槽的略微高级点用法,就案例而言,在饿了么UI中的表格中有用到)

插槽可以在饿了么UI或者antD中封装的组件中看到,以el-dialog为例,其使用到了默认插槽和具名插槽。可以这样说,UI组件中基本上都使用了插槽技术,大家没事可以去看看饿了么UI的封装组件的源码,还是很有收获的

路径如下:在vue项目中,打开node_modules,里面有很多的包/组件,找到element-ui下的packages,里面都是饿了么封装的组件

作用域插槽本篇文章暂时用不到,所以先按下不表,后续再单独写一篇关于作用域插槽的文章

匿名(默认)插槽的使用

子组件放置匿名插槽

<template>
  <div class="box">
    <h1>我是子组件</h1>
    <!-- 第一步,在子组件里面,找个地方插入一个槽,因为槽可以盛放东西,又因为子组件会引入到父组件中
                所以子组件插入的这个插槽具体装什么东西,肯定是由父组件去装东西,父组件装html片段,
                在子组件中就可以得到html片段。所以:插槽实现了父组件向子组件传递数据的效果
     -->
    <slot></slot>
    <!-- 子组件写了一个这样的slot标签才能接收到父组件传递过来的html片段。不写的话父组件传了也是白传
            即不会生成DOM,也不会渲染
     -->
  </div>
</template>

<script>
export default {
  name: "DemoChildslot",
};
</script>

<style lang="less" scoped>
.box {
  width: 200px;
  height: 200px;
  background-color: #baf;
}
</style>
复制代码

父组件使用匿名插槽传递HTML

<template>
  <div id="app">
    <!-- 第二步
            使用子组件,在子组件标签中间写入代码,就可以实现插槽的数据传递了。 -->
    <child-slot>
      <i>我是父组件传递过去的</i>
      <!--
		也可以这样写,因为默认就是slot="default",不过一般不这样写,略麻烦
		<i slot="default">我是父组件传递过去的</i> 
	  -->
    </child-slot>
  </div>
</template>

<script>
// 引入子组件
import childSlot from "./childSlot";
export default {
  components: {
    childSlot, // 注册子组件
  },
};
</script>

<style lang="less" scoped>
#app {
  width: 100%;
  min-height: 100vh;
  box-sizing: border-box;
  padding: 50px;
}
</style>
复制代码

效果图

3.png

具名插槽的使用

比如我们想要封装一个弹框组件,弹框弹出以后,在弹框的内容区,有弹框头部内容区、弹框主要内容区、弹框底部内容区。弹框主要内容区我们可以使用匿名插槽、如果弹框要指定头部的内容、指定弹框的底部内容,可以通过具名插槽指定具体内容。结构代码如下:

子组件放置具名插槽

<template>
  <div class="box">
    <h1>弹框</h1>
    <div class="dialogHead">
        <!-- 带名字的插槽,作用是指定插槽位置 -->
        <slot name="headhead"></slot>
    </div>
    <div class="dialigMain">
        <slot></slot>
    </div>
    <div class="dialogFoot">
        <!-- 带名字的插槽,作用是指定插槽位置 -->
        <slot name="footfoot"></slot>
    </div>
  </div>
</template>

<script>
export default {
  name: "DemoChildslot",
};
</script>

<style lang="less" scoped>
.box {
  width: 170px;
  height: 200px;
  background-color: #baf;
}
</style>
复制代码

父组件中使用具名插槽传递HTML

<template>
  <div id="app">
    <child-slot>
      <!-- 写法一:slot属性写在标签上
              具名插槽在父组件中传递数据的时候位置无所谓,因为具名插槽的所传递的数据会根据具名插槽的名字
              找对应子组件中的具名插槽。
       -->
      <!-- <p slot="footfoot">底部底部</p>
      <i>我是父组件传递过去的</i>
      <p slot="headhead">头部头部</p> -->

      <!-- 写法二:slot属性写在模板标签上,模板标签不会渲染成DOM -->
        <template slot="headhead">
          <p>模板标签头部</p>
        </template>
        <i>我是父组件传递过去的</i>
        <template slot="footfoot">
          <p>模板标签底部</p>
        </template>
    </child-slot>
  </div>
</template>

<script>
// 引入子组件
import childSlot from "./childSlot";
export default {
  components: {
    childSlot, // 注册子组件
  },
};
</script>

<style lang="less" scoped>
#app {
  width: 100%;
  min-height: 100vh;
  box-sizing: border-box;
  padding: 50px;
}
</style>
复制代码

效果图

1.png

开始封装dialog组件

功能如下

第一步就是封装组件并注册,这个步骤本篇文章就不赘述了,如果忘了步骤的朋友可以先看看我的这边文章,写的有全局组件的封装步骤,也包含组件间的数据传值。附上地址:juejin.cn/post/695252…

  • 弹出框弹出或关闭设置过渡动画
  • 使用默认插槽做主要内容区
  • 使用具名插槽指定对应弹框头部内容和弹框底部内容
  • 弹框遮罩层背景的开启或关闭
  • 点击遮罩层控制弹框的关闭与否
  • 是否显示关闭的叉号小图标
  • 自定义弹框的title标题
  • 等...

代码如下

封装的组件代码

<template>
  <!-- 打开弹框的动画 -->
  <transition name="animation">
    <div
      class="dialogBox"
      :class="{ isShowMask: mask == true }"
      v-show="isShowDialog"
      @click="clickMaskCloseFn"
    >
      <div class="dialogBoxContent" @click.stop>
        <div class="headhead">
          <!-- 这样写可以做到若有传递过来的title就用传递过来的title
          若有传递过来的插槽,就以插槽的为准 -->
          <slot name="header">
            <span>{{ title }}</span>
          </slot>
          <i class="el-icon-close" @click="close" v-show="showCloseIcon"> </i>
        </div>
        <div class="bodybody">
          <!-- 内容区我们使用默认插槽 -->
          <slot></slot>
        </div>
        <div class="footfoot">
          <!-- 底部使用命名插槽 -->
          <slot name="footer"></slot>
        </div>
      </div>
    </div>
  </transition>
</template>

<script>
export default {
  name: "dialogComponent",
  props: {
    // 控制是否展示或隐藏对话框
    isShowDialog: {
      type: Boolean,
      default: false,
    },
    // 父组件传过来的标题值
    title: {
      type: String,
      default: "",
    },
    // 是否显示关闭小图标
    showCloseIcon: {
      type: Boolean,
      default: true,
    },
    // 是否开启背景遮罩层
    mask: {
      type: Boolean,
      default: true,
    },
    // 是否点击遮罩层mask关闭弹出框
    clickMaskClose: {
      type: Boolean,
      default: false,
      require:true
    },
  },
  data() {
    return {};
  },
  methods: {
    // 关闭弹出框
    close() {
      this.$emit("beforeClose", false);
    },
    // 点击遮罩层关闭弹框
    clickMaskCloseFn() {
      if (this.clickMaskClose == true) {
        this.$emit("beforeClose", false);
      } else {
        /* 这里要控制一下冒泡事件,注意第十行使用@click.stop
           不控制冒泡的话,点击内容区也会导致弹出框关闭*/ 
        return;
      }
    },
  },
};
</script>

<style lang="less" scoped>
.dialogBox {
  width: 100%;
  height: 100%;
  position: fixed;
  top: 0;
  left: 0;
  display: flex;
  justify-content: center;
  align-items: center;
  .dialogBoxContent {
    width: 600px;
    height: 400px;
    border: 2px solid #e9e9e9;
    border-radius: 2px;
    background-color: #fff;
    .headhead {
      width: 100%;
      height: 60px;
      line-height: 60px;
      border-bottom: 1px solid #e9e9e9;
      box-sizing: border-box;
      padding: 20px;
      display: flex;
      justify-content: space-between;
      align-items: center;
      span {
        font-size: 24px;
      }
      i {
        font-size: 24px;
        cursor: pointer;
      }
    }
    .bodybody {
      width: 100%;
      height: calc(100% - 120px);
    }
    .footfoot {
      width: 100%;
      height: 60px;
      line-height: 60px;
      box-sizing: border-box;
      border-top: 1px solid #e9e9e9;
      padding: 0 20px;
      .el-button {
        margin-left: 12px;
      }
    }
  }
}
.isShowMask {
  background-color: rgba(0, 0, 0, 0.3);
}
.animation-enter,
.animation-leave-to {
  opacity: 0;
}
.animation-enter-active,
.animation-leave-active {
  transition: opacity 0.3s;
}
</style>
复制代码

使用组件传参与事件代码

<template>
  <div id="app">
    <my-dialog
      :isShowDialog.sync="isShowDialog"
      title="设置标题"
      :showCloseIcon="true"
      @beforeClose="beforeClose"
      :mask="true"
      :clickMaskClose="true"
    >
      <!-- 要与组件的具名插槽对应 -->
      <template slot="header"> 具名插槽 </template>
      <template> 默认插槽 </template>
      <!-- 要与子组件的插槽对应 -->
      <template slot="footer">
        <el-button size="small" @click="isShowDialog = false">取消</el-button>
        <el-button type="primary" size="small" @click="isShowDialog = false"
          >确认</el-button
        >
      </template>
    </my-dialog>
    <br />
    <br />
    <br />
    <el-button @click="isShowDialog = true" type="primary">
      打开弹框
    </el-button>
  </div>
</template>

<script>
export default {
  data() {
    return {
      isShowDialog: false,
    };
  },
  methods: {
    // 关闭前的回调
    beforeClose(flag) {
      //   this.$confirm("是否关闭", "提示", {
      //     confirmButtonText: "确认关闭",
      //     cancelButtonText: "取消",
      //     type: "warning",
      //   })
      //     .then(() => {
      this.isShowDialog = flag;
      // })
      // .catch(() => {
      //   // 不关闭
      // });
    },
  },
};
</script>

<style lang="less" scoped>
#app {
  width: 100%;
  min-height: 100vh;
  box-sizing: border-box;
  padding: 50px;
}
</style>
复制代码

最终效果图

GIF 2021-4-24 14-33-13.gif

总结

代码中注释写的比较全了,比较方便的方式就是新建一个vue的项目,然后把代码分别粘过去,注意封装的myDialog组件别忘了要注册一下哦

本文阐述封装组件化插槽使用流程思想,具体业务场景灵活修改就行啦。

文章分类
前端
文章标签