美文网首页让前端飞Web前端之路JavaScript 进阶营
Vue实现移动端 message-box 与 alert 弹框

Vue实现移动端 message-box 与 alert 弹框

作者: 郝晨光 | 来源:发表于2019-06-30 21:37 被阅读51次
    GIF.gif

    前言

    最近在做移动端的项目,需要制作移动端的alert弹框和message-box提示信息;之前使用Vue框架的element-ui时,就记得element-ui的弹框,今天深入的研究了一下源码,然后简单制作了一点小demo

    用到的知识点

    Vue组件的定义,Vue的extend

    Vue.extend(options)

    options参数是一个对象,一个Vue组件配置项的对象,例如

    // 创建一个构造器,
    const Profile = Vue.extend({
    // 模板使用参数内的template模板
      template: `<div>{{message}}</div>`,
    // data内的为默认数据
      data() {
          return {
              message: ''  
          }
      }
    })
    // 创建一个基于构造器的Vue实例,并且给data重新赋值
    const Message = new Profile({
        data: {
            message: 'message'
        }
    })
    // 将这个实例挂载到 id 为 app 的DOM节点上
    Message.$mount('#app');
    

    正文

    看完了基本原理,大部分同学应该就已经可以明白这个东西是怎么实现的了吧!,接着我带着大家来看看具体的实现步骤

    首先需要先定义一个Vue的组件,这个组件不直接挂载到任何DOM节点中,而是作为一个模板,一个构造器来使用

    <template>
        <transition name="fade">
                <!-- 使用fade淡入淡出动画,使用type变量来控制class类名,达到更改type值就可以修改样式的效果 -->
            <div :class="['plugins-message-box',type]" v-show="visible">
                <!-- 使用iconClass来控制icon的类名,我使用的是阿里的字体图标库iconfont,可以根据个人爱好来更换 -->
                <div :class="['message-icon','iconfont',iconClass]"></div>
                <!-- 输出消息 -->
                <div class="message-container">{{message}}</div>
            </div>
        </transition>
    </template>
    
    <script>
          // 定义每一个type对应的class类名
        const typeClass = {
            success: 'icon-success',
            error: 'icon-error',
            default: 'icon-success'
        };
        export default {
            name: "messageMain",
                // 定义的是默认数据,默认值
            data() {
                return {
                    visible: false, // 控制DOM显示隐藏
                    type: 'default', // 默认type值为default
                    icon: '', // 默认使用icon为空,则使用type值对应的icon
                    message: '', // 默认的message为空,由外部传入
                    duration: 2000 // 默认显示时间为2000ms
                }
            },
            computed: {
                          // 如果外部传入icon则使用外部的icon,如果没有。则使用type值对应的icon
                iconClass() {
                    if(this.icon) {
                        return this.icon;
                    }else {
                        return typeClass[this.type];
                    }
                }
            }
        }
    </script>
    

    可以看到这是一个非常简单的Vue组件模板,使用的是vue-cli工具构建的,最终它抛出了一个对象,而我们接着就应该来定义构造器

    import Vue from 'vue'; // 引入Vue
    import MessageMain from './messageMain'; // 引入上边定义好的message模板
    
    const MessageBox = Vue.extend(MessageMain); // 使用Vue.extend来创建一个构造器
    let instance; // instance 变量用来保存实例
    let timer = null; // timer 变量用来保存定时器
    
    // 定义一个function,参数为options,默认为一个对象
    const Message = function(options = {}) {
        // 如果当前处在服务器端,则直接返回
        if(Vue.prototype.$isServer) return;
        // 如果当前定时器已开启,说明页面上已经有一个message-box了,则不能再继续创建新的message-box
        if(timer) return;
        // 对options做处理,如果直接传入string,则使其保存在options的message属性上
        if(typeof options === 'string') {
            options = {
                message: options
            }
        }
        // 初始化实例,并将options作为新的data传入,Vue会将options合并到原有的data上,覆盖原有的默认值,但是,在options中没有设置的是不会被改变的
        instance = new MessageBox({
            data: options
        });
        // 调用$mount方法,将当前实例渲染为真实DOM,生成$el,,如果不执行这一步,将拿不到 $el 的值,但是不指定DOM节点接管当前实例
        instance.vm = instance.$mount();
        // 使用原生js的API将当前实例的真实DOM追加到body中
        document.body.appendChild(instance.vm.$el);
        // 实例上的vm就是我们的Vue组件,所以我们可以通过vm访问到当前实例中的所有属性
        // 将visible设置为true,即显示当前message-box
        instance.vm.visible = true;
        // 开启定时器
        timer = setTimeout(() => {
           // 在时间结束后将当前实例手动卸载
            instance.vm.$destroy();
           // 使用原生API将当前实例生成的DOM节点在真实的DOM树中删除
            instance.vm.$el.parentNode.removeChild(instance.vm.$el);
           // 清除定时器
            timer = null;
        }, instance.vm.duration);
        // 定时器的时间使用vm中定义的时间
        return instance.vm;
    };
    
    // 最终抛出一个对象,对象上我们可以使用 install 来扩展Vue的插件
    // 当我们的对象上有install方法的时候,它接收第一个参数为Vue,
    // 我这里为了方便使用,还在当前抛出的对象上定义了一个message方法,为了方便在axios的拦截器中使用;
    export default {
        message: Message,
        install(Vue) {
            Vue.prototype.$message = Message;
            Vue.message = Message;
        }
    };
    

    接着来看一下使用方法,首先要在main.js中将这个插件安装到Vue上

    import Message from './plugins/Message';
    
    Vue.use(Message); // 因为我们的对象上定义了install方法,所以可以直接调用Vue的use方法
    

    安装完成之后,我们就可以在任意组件内使用了,这个是我们刚刚在文章开头看到的页面,现在只有调用message-box的方法;

    我们直接使用this.$message就可以调用我们的message-box,并且显示都没有任何问题,当然,也可以通过传入icon和duration来修改图标和时间

    <template>
        <div class="test">
            <div class="test-message">
                <button @click="messageClick('default')">
                    default
                </button>
                <button @click="messageClick('success')">
                    success
                </button>
                <button @click="messageClick('error')">
                    error
                </button>
            </div>
        </div>
    </template>
    
    <script>
        export default {
            name: "test",
            methods: {
                messageClick(type) {
                    this.$message({
                        type,
                        message: type
                    })
                }
            }
        }
    </script>
    
    GIF.gif

    看完了message-box,我想你对alert的做法也有了一定的想法了吧!接着我们来看一下alert的做法

    在alert中,我们不需要定义type,也不需要修改样式,

    对于alert来说,我们需要有一个头部,一个内容区,还有一个确认按钮,

    而我们的内容区,使用的是v-html来渲染内容,便于我们可以使用原生的DOM标签来实现一些简单的样式

    而我们在这个组件内,当点击确定按钮的时候,我们将卸载当前组件,并将当前组件从DOM结构删除

    <template>
        <transition name="fade">
            <div class="plugins-alert-box" v-show="visible">
                <div class="plugins-alert-container">
                    <div class="alert-box-title">
                        {{title}}
                    </div>
                    <div class="alert-box-message" v-html="message">
                    </div>
                    <div class="alert-box-btn">
                        <button @click="btnClick">确定</button>
                    </div>
                </div>
            </div>
        </transition>
    </template>
    
    <script>
        export default {
            name: "alertMain",
            data() {
                return {
                    visible: false,
                    message: '',
                    title: '提示'
                }
            },
            methods: {
              // 点击确定按钮的时候,首先隐藏当前元素,然后将当前元素从DOM结构中删除,并手动卸载当前实例
                btnClick() {
                    this.visible = false;
                    this.$el.parentNode.removeChild(this.$el);
                    this.$destroy();
                }
            }
        }
    </script>
    
    

    接着我们再来看定义构造器的代码

    import Vue from 'vue'; // 引入Vue
    import alertMain from './alertMain'; // 引入定义好的alert的模板
    
    const AlertBox = Vue.extend(alertMain); // 创建一个构造器
    let instance; // instance 变量用来保存实例
    
    // 定义 Alert函数,接收options参数,默认为一个对象
    const Alert = function(options = {}) {
        if(Vue.prototype.$isServer) return; // 判断当前如果是在服务器端渲染的话,直接返回
        // 同样的,我们还要处理options
        if(typeof options === 'string') {
            options = {
                message: options
            }
        }
        // 创建一个alert-box实例 ,将options作为新的data传入
        instance = new AlertBox({
            data: options
        });
        // 调用$mount方法,创建真实DOM,获取到vm
        instance.vm = instance.$mount();
        // 调用原生API将当前实例的真实DOM追加到body中
        document.body.appendChild(instance.vm.$el);
        // 让当前DOM显示
        instance.vm.visible = true;
        return instance.vm;
    };
    
    // 抛出对象,以及install方法,原理我们在上边已经讲过了
    export default {
        alert: Alert,
        install(vue) {
            vue.prototype.$alert = Alert;
        }
    }
    
    

    接着就是alert-box的使用方法了,同样是需要先use一下

    import Alert from './plugins/Alert';
    
    Vue.use(Alert);
    

    最后来使用一下这个alert-box

    <template>
        <div class="test">
            <div class="test-message">
                <button @click="alertClick">alert</button>
            </div>
        </div>
    </template>
    
    <script>
        export default {
            name: "test",
            methods: {
                alertClick() {
                    this.$alert({
                        message: `<b>加粗文字</b>`
                    })
                }
            }
        }
    </script>
    
    GIF.gif

    结言

    我没有帖出css样式文件,因为样式文件其实没有多少东西,我觉得你写的会比我写的更优秀,更完美
    看完这篇文章不知道你有没有什么收获,如果可以理解的话,希望你通过这篇文章写一个dialog组件,巩固一下知识,顺手点个关注
    感谢您的查阅,代码冗余或者有错误的地方望不吝赐教;菜鸟一枚,请多关照

    相关文章

      网友评论

        本文标题:Vue实现移动端 message-box 与 alert 弹框

        本文链接:https://www.haomeiwen.com/subject/spxicctx.html