Vue 2.x折腾记 - (15) 捣鼓一个中规中矩loading组件

前言

最近有一个新的项目，UI大佬不知道从哪里找来了一张GIF丢到蓝湖，

说做为全局的页面loading ，可是本身想了想，仍是选择画一个。

一开始想过用svg,canvas,最终仍是选择了css3+js来实现这个效果。

gif的缺点挺多,至于为何又排除了svg和canvas，是由于css3+js可控性更强，

无论是大小仍是颜色，仍是响应式(个人项目走的vh,vw)那套来适配；

---

效果

UI大佬提供的GIF

实现的效果【在线codesandbox预览】

• 支持环的颜色改变及整个展现大小
• 支持在loading底部显示文字并控制其样式

实现思路

这个东东主要用了这么几个要点来实现完整的效果；

• flex和position来布局
• 伪类的颜色继承(currentColor)
• 边框结合圆角实现环
• 用了transform和animation来实现了整个过渡

效果知道怎么实现了，剩下的就是咱们须要实现的功能点了；

由于是面向移动端的,因此这些常规的东东也要考虑下

• 遮罩层可控
• 防止点击穿透滚动body
• 组件支持函数方法调用

源码

Loading.vue

<template>
  <div id="loading-wrapper">
    <div class="loading-ring" :style="ringStyle">
      <div class="outer" />
      <div class="middle" />
      <div class="inner" />
    </div>
    <div class="text" :style="textStyle" v-if="text">
      {{ text }}
    </div>
  </div>
</template>

<script> export default { name: "Loading", props: { text: { type: String, default: "" }, textStyle: { type: Object, default: function() { return { fontSize: "14px", color: "#fff" }; } }, ringStyle: { type: Object, default: function() { return { width: "100px", height: "100px", color: "#407af3" }; } } }, methods: { preventDefault(e) { // 禁止body的滚动 console.log(e); e.preventDefault(); e.stopPropagation(); } }, mounted() { document .querySelector("body") .addEventListener("touchmove", this.preventDefault); }, destroyed() { document .querySelector("body") .removeEventListener("touchmove", this.preventDefault); } }; </script>

<style lang="scss" scoped> #loading-wrapper { position: fixed; left: 0; top: 0; height: 100vh; width: 100vw; background-color: rgba(0, 0, 0, 0.25); display: flex; justify-content: center; align-items: center; flex-direction: column; .loading-ring { position: relative; width: 200px; height: 200px; .outer, .inner, .middle { position: absolute; left: 50%; top: 50%; transform: translate(-50%, -50%); color: currentColor; &::after { content: ""; display: block; width: 100%; height: 100%; border-radius: 100%; border-left: 10px solid currentColor; border-right: 10px solid currentColor; border-top: 10px solid currentColor; border-bottom: 10px solid transparent; } } .outer { width: 100%; height: 100%; &::after { animation: anticlockwise 1.5s infinite linear; } } .inner { width: calc(100% * 0.6); height: calc(100% * 0.6); &::after { animation: anticlockwise 1.5s infinite linear; } } .middle { width: calc(100% * 0.8); height: calc(100% * 0.8); &::after { animation: clockwise 1.5s infinite linear; } } } .text { color: #fff; font-size: 14px; padding: 30px; width: 250px; text-align: center; } } @keyframes clockwise { 0% { transform: rotate(0deg); } 100% { transform: rotate(360deg); } } @keyframes anticlockwise { 0% { transform: rotate(0deg); } 100% { transform: rotate(-360deg); } } </style>


复制代码

index.js

import Loading from "./Loading.vue";
// 来保持实例，单例模式
let instance;
let el;

Loading.install = function(Vue, options = {}) {
  const defaultOptions = {
    text: "",
    textStyle: {
      fontSize: "14px",
      color: "#fff"
    },
    ringStyle: {
      width: "100px",
      height: "100px",
      color: "#407af3"
    },
    ...options
  };
  Vue.prototype.$loading = {
    show(options = {}) {
      if (!instance) {
        let LoadingInstance = Vue.extend(Loading);
        el = document.createElement("div");
        document.body.appendChild(el);
        instance = new LoadingInstance({
          propsData: { defaultOptions, ...options }
        }).$mount(el);
      } else {
        return instance;
      }
    },
    hide() {
      if (instance) {
        document.body.removeChild(document.getElementById("loading-wrapper"));
        instance = undefined;
      }
    }
  };
};

export default Loading;


复制代码

选项及用法

选项

text: {  // 这个不为空就在loading下面显示文字
      type: String,
      default: ""
    },
    textStyle: {  // loading text 的样式，颜色及字体大小
      type: Object,
      default: function() {
        return {
          fontSize: "14px",
          color: "#fff"
        };
      }
    },
    ringStyle: {  // 最外环的大小，内二环是比例换算的(百分比)
      type: Object,
      default: function() {
        return {
          width: "100px",
          height: "100px",
          color: "#407af3"
        };
      }
    }

复制代码

用法

在主入口use一下即可全局使用

除了常规的引入使用，还支持函数调用,挂载了一个$loading。

this.$loading.show({
        text: "loading",
        textStyle: {
          fontSize: "18px",
          color: "#f00"
        }
      });
      
let st = setTimeout(() => {
        clearTimeout(st);
        this.$loading.hide();
    }, 1000);

复制代码

总结

props的传递没有作增量合并(递归每一个key赋值)，直接浅复制合并的。

对于组件功能的概而全，拓展性，大小须要本身权衡；

到这里，咱们业务须要的一个小组件，该有的功能都有了。

有不对之处请留言，会及时修正。