Vue项目之ES6装饰器在项目实战中的应用

 更新时间:2022年06月08日 16:06:49   作者:柠檬百香果  
作为一个曾经的Java coder,当第一次看到js里面的装饰器Decorator,就马上想到了Java中的注解,当然在实际原理和功能上面,Java的注解和js的装饰器还是有很大差别的,这篇文章主要给大家介绍了关于Vue项目之ES6装饰器在项目实战中应用的相关资料,需要的朋友可以参考下

前言

在面向对象(OOP)的设计模式中,装饰器的应用非常多,比如在 Java 和 Python 中,都有非常多的应用。ES6 也新增了装饰器的功能,本文会介绍 ES6 的装饰器的概念、作用以及在 Vue + ElementUI 的项目实战中的应用。

装饰模式(Decorator)

装饰模式(Decorator Pattern)允许向一个现有的对象添加新的功能,同时又不改变其结构。 这种模式属于结构型模式,它是作为现有的类的一个包装。 这种模式创建了一个装饰类,用来包装原有的类,并在保持类方法签名完整性的前提下,提供了额外的功能。

优点:

  • 不需要通过创建子类的方式去拓展功能(不需要子类化),这样可以避免代码臃肿的问题
  • 装饰类的方法复用性很高
  • 不会影响到原对象的代码结构

ES6 也开始有了装饰器,写法与其他语言的写法保持了统一,就是使用@ + 函数名的方式

ES6 装饰器

关于ES6 装饰器的用法可以参考阮老师的 ECMAScript 6 入门,这里从中展示一下两种用法。

  • 类的装饰

装饰器方法:给对象添加一个 isTestable 属性

function testable(isTestable) {
  return function(target) {
    target.isTestable = isTestable;
  }
}

使用的时候直接用 @ + 函数名,就可以为对象添加 isTestable 属性了

@testable(true)
class MyTestableClass {}

MyTestableClass.isTestable // true
  • 方法的装饰

日志装饰器

function log(target, name, descriptor) {
  var oldValue = descriptor.value;

  descriptor.value = function() {
    console.log(`Calling ${name} with`, arguments);
    return oldValue.apply(this, arguments);
  };
  return descriptor;
}

使用装饰器

class Math {
  @log
  add(a, b) {
    return a + b;
  }
}

const math = new Math();

// Calling add with arguments
math.add(2, 4);

从上面两个简单例子可以看出,装饰器应用在类和类的方法上时非常的方便,有几个优点:

  • 语义化,可以非常清晰看出装饰器为对象添加了什么功能
  • 装饰器不改变原对象的结构,原对象代码简洁、易维护。

接下来将介绍一下我在 Vue 项目中,利用装饰器的功能做的代码优化。

装饰器应用

目前我们了解到,装饰器可以用来注释或修改类和类方法。而且装饰器使用起来非常灵活,只需要用@ + 函数名就可以修改类,可以改善代码结构。那么在做项目的时候,编写代码时是否有些功能可以抽象成装饰器,提高复用性和改善代码结构。

下面的例子所用到的技术栈是 Vue2 + ElementUI + TypeScript + vue-property-decorator

Validate

在很多 UI 组件库中,都有表单组件,其中表单重要的功能之一就是表单校验,以 ElementUI 的 form 举例,首先校验表单是否通过,如果通过,就将表单数据提交给后台,

完整的代码如下:

submitForm() {
  this.$refs['formName'].validate(async (valid) => {
    if (valid) {
      try {
        // 调用接口
        await this.handleTest();
        this.$message.success('Submit Successfully!')
      } catch(error) {
        console.log(error);
      }
    } else {
      console.log('error submit!!');
      return false;
    }
  });
},

这里有几个问题:

  • 这个代码嵌套到第三层才开始进入主逻辑代码,嵌套太多了,万一在主要业务逻辑代码还有很多嵌套,看起来就十分的难受。
  • 记不住,在实际开发中,一般不回特意去记触发校验的写法,通常要去找文档或者找别人的代码,最后抄过来
  • 此功能很常用,每做一个表单都要写一遍,重复写这份代码

分析上面代码,其实主要的代码是在 if (valid) 的条件下,而触发表单校验的代码是可以抽象出来的,因为它非常常用,而且这部分代码是无关业务逻辑的。抽象出去,可以更好地关注到业务逻辑代码。

export function Validate(refName: string) {
  return function (target: any, name: string, descriptor: PropertyDescriptor) {
    const fn = target[name]; // 被装饰的方法
    descriptor.value = function (...args: any[]) {
      // 将触发校验的代码封装在此
      (this as any).$refs[refName].validate((valid: boolean) => {
        if (valid) {
          fn.call(this, ...args); // 在这里调用“被装饰的方法”
        } else {
          console.log('error submit!!');
          return false;
        }
      });
    };
  };
}

然后在使用的时候就非常简单了,只需要在提交方法上方写上 @Validate('refName'),传入表单组件的 ref 名,就可以实现了触发表单校验的功能,这样不但大大优化了代码结构,而且使用起来非常简单,👩 再也不用担心我记不住怎么写了。

import { Validate } from '@/utils/decorator'
export default class TestForm extends Vue {

  @Validate('formName')
  async submitForm() {
    try {
      // 调用接口
      await this.handleTest();
      this.$message.success('Submit Successfully!')
    } catch(error) {
      console.log(error);
    }
  }
}

这样是不是好多了!特别是在业务逻辑非常复杂的场景,减少嵌套和非业务逻辑的代码,可以让业务逻辑代码更加清晰。

CatchError

在写代码的时候经常用 try catch 去捕获程序中的错误,但是 try catch 会加深了代码嵌套层级,而且很常用,我们可以将 try catch 的部分抽象出去,作为装饰器的功能。

比如原来的代码是这样的:

export default class TestForm extends Vue {

  async submitForm() {
    try {
      await this.handleTest();
      this.$message.success('Submit Successfully!')
    } catch(error) {
      console.log(error);
    }
  }
}

try catch 的功能作为装饰函数

export function CatchError() {
  return function (target: any, name: string, descriptor: PropertyDescriptor) {
    const fn = target[name];
    descriptor.value = async function (...args: any[]) {
      try {
        await fn.call(this, ...args);
      } catch (error) {
        console.log('error', error);
      }
    };
    return descriptor;
  };
}

使用起来后,就少了一层 try catch 的嵌套了,而且错误也被捕获到了,CatchError 的命名也很好理解,并且你可以统一处理捕获到的错误。

import { CatchError } from '@/utils/decorator'
export default class TestForm extends Vue {
  @CatchError()
  async submitForm() {
    await this.handleTest();
    this.$message.success('Submit Successfully!')
  }
}

现在目前有 Validate 和 CatchError 两种装饰器,分别是表单校验和错误捕捉的作用,而表单提交都有用到这两种功能,装饰器可以同时满足它,因为一个方法可以拥有多个装饰器。

如果同一个方法有多个装饰器,会像剥洋葱一样,先从外到内进入,然后由内向外执行。

那么提交表单的函数最终可以被装饰器优化成这样:

import { CatchError, Validate } from '@/utils/decorator'
export default class TestForm extends Vue {
  @CatchError()
  @Validate('ruleForm')
  async submitForm() {
    await this.handleTest();
    this.$message.success('Submit Successfully!')
  }
}

发现了没有,提交表单的代码中,完完全全只有业务逻辑代码了!而其他的功能作为装饰器引入并作用到这个方法上。而且这些装饰功能就像是个语法糖一样,当我下次还需要用到的时候,只需要引用在我的方法上即可,十分方便。

Confirmation

确认消息:提示用户确认其已经触发的动作,并询问是否进行此操作时会用到此对话框。这种场景十分常见,在点击提交表单确认、点击删除的时候,都会弹出提示框,在用户点击确认后,再提交。其中最终我们只需要点击确认那一下按钮提交的功能,其他的功能属于交互功能。

代码实现:

<template>
  <div>
    <el-button type="text" @click="handleDelete"
      >点击打开 Message Box 提示是否删除</el-button
    >
  </div>
</template>

<script>
import { Vue, Component } from "vue-property-decorator";
@Component
export default class DecoratorTest extends Vue {
  handleDelete() {
    this.$confirm("此操作将永久删除该文件, 是否继续?", "提示", {
      confirmButtonText: "确定",
      cancelButtonText: "取消",
      type: "warning",
      showCancelButton: true,
      beforeClose: (action, instance, done) => {
        if (action === "confirm") {
          instance.confirmButtonLoading = true;
          setTimeout(() => {
            done();
            setTimeout(() => {
              instance.confirmButtonLoading = false;
            }, 300);
          }, 2000);
        } else {
          done();
        }
      },
    }).then(() => {
      this.$message({
        type: "success",
        message: "删除成功!",
      });
    });
  }
}
</script>

同样的问题,实现这样一个通用的功能,需要太多与业务逻辑无关的代码了。代码嵌套很深,主要业务逻辑代码不够清晰可见。因此对于这种通用的功能,也可以抽离出去作为装饰器。

同样我们把 confirm 的功能封装起来,instance.confirmButtonLoading 控制的是按钮的 loading,done() 是关闭弹窗的方法,这两个功能很好用,因此我们把 instancedone 作为参数传给被装饰的方法。

import Vue from "vue";
interface ConfirmationConfig {
  title: string;
  message: string;
  // eslint-disable-next-line @typescript-eslint/ban-types
  options?: object;
  type?: string;
}
export function Confirmation(config: ConfirmationConfig) {
  return function (target: any, name: string, descriptor: PropertyDescriptor) {
    const fn = target[name];
    let _instance: any = null;
    descriptor.value = function (...args: any[]) {
      Vue.prototype
        .$confirm(
          config.message,
          config.title,
          Object.assign(
            {
              beforeClose: (action: string, instance: any, done: any) => {
                _instance = instance;
                if (action === "confirm") {
                  instance.confirmButtonLoading = true;
                  fn.call(this, instance, done, ...args);
                } else {
                  done();
                }
              },
            },
            config.options || {}
          )
        )
        .then(() => {
          _instance.confirmButtonLoading = false;
        });
    };
    return descriptor;
  };
}

完成封装 confirm 之后,这么使用即可:

<template>
  <div>
    <el-button type="text" @click="handleDelete"
      >点击打开 Message Box 提示是否删除</el-button
    >
  </div>
</template>

<script lang="ts">
import { Vue, Component } from "vue-property-decorator";
import { Confirmation } from "@/utils/decorator";
@Component
export default class DecoratorTest extends Vue {
  @Confirmation({
    title: "提示",
    message: "此操作将永久删除该文件, 是否继续?",
  })
  handleDelete(instance: any, done: any) {
    setTimeout(() => {
      done();
      setTimeout(() => {
        instance.confirmButtonLoading = false;
        this.$message({
          type: "success",
          message: "删除成功!",
        });
      }, 300);
    }, 2000);
  }
}
</script>

最终这样减少了很多代码和嵌套,并且将这个常用的功能封装起来了,以后遇到可以直接复用起来,使用也很方便,只需要引入并传入 title 和 message 就可以了。

总结

装饰器可用于给类和类的方法添加功能,且不会影响原对象的结构。可用于拓展原对象的功能。在实际业务项目开发中,常常会把功能性代码和业务性代码耦合在一起,可以将功能性代码抽象出去,作为装饰器装饰业务功能代码,这样就能专注于业务组件的业务逻辑代码,优化代码结构,减少代码嵌套等。

到此这篇关于Vue项目之ES6装饰器在项目实战中应用的文章就介绍到这了,更多相关Vue ES6装饰器在实战应用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

代码示例已经发布到 github 上了代码地址 ,也可以把项目来下来跑跑看。

参考

ECMAScript 6 入门

相关文章

  • vue3版本网页小游戏设计思路

    vue3版本网页小游戏设计思路

    最近火爆全网的羊了个羊小程序,背景是根据官方介绍,“羊了个羊”是一款闯关消除小游戏,通关率不到0.1%。主要玩法为重叠的各类方块,需要在下方7个栏内完成消除,其特点就是“极难”,也因此成为热门挑战,对vue3版本网页小游戏设计思路感兴趣的朋友跟随小编一起看看吧
    2022-12-12
  • 利用Vue.js指令实现全选功能

    利用Vue.js指令实现全选功能

    最近做了两个vue的项目,都需要实现全选反选的功能,两个项目用了两种实现方法,第一个项目用vue的computed,第二个项目用指令来实现,用起来,发觉指令更加方便。下面就来介绍如何利用指令来实现全选。
    2016-09-09
  • vuedraggable实现拖拽功能

    vuedraggable实现拖拽功能

    这篇文章主要为大家详细介绍了vuedraggable实现拖拽功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2022-04-04
  • Vue3中watch监听对象的属性值(监听源必须是一个getter函数)

    Vue3中watch监听对象的属性值(监听源必须是一个getter函数)

    这篇文章主要介绍了Vue3中watch监听对象的属性值,监听源必须是一个getter函数,本文结合示例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-12-12
  • vue.js中v-on:textInput无法执行事件问题的解决过程

    vue.js中v-on:textInput无法执行事件问题的解决过程

    大家都知道vue.js通过v-on完成事件处理与绑定,但最近使用v-on的时候遇到了一个问题,所以下面这篇文章主要给大家介绍了关于vue.js中v-on:textInput无法执行事件问题的解决过程,需要的朋友可以参考下。
    2017-07-07
  • vue2中less的安装以及使用教程

    vue2中less的安装以及使用教程

    less是css预处理器,对原先css进行了扩展和补充,下面这篇文章主要给大家介绍了关于vue2中less的安装以及使用的相关资料,文中通过实例代码介绍的非常详细,需要的朋友可以参考下
    2022-12-12
  • vue3 中使用 reactive 的问题小结

    vue3 中使用 reactive 的问题小结

    在 Vue 3 中,如果你使用 reactive 来定义一个响应式对象,那么这个对象的属性是不能被重新赋值的,因为 reactive 会将对象的属性转换为 getter/setter,这样 Vue 才能追踪到属性的变化,这篇文章主要介绍了vue3 中使用 reactive 的问题,需要的朋友可以参考下
    2024-03-03
  • 关于vue3 解决getCurrentInstance 打包后线上环境报错问题

    关于vue3 解决getCurrentInstance 打包后线上环境报错问题

    这篇文章主要介绍了vue3 解决getCurrentInstance 打包后线上环境报错问题,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-05-05
  • vue项目之数量占比进度条实现方式

    vue项目之数量占比进度条实现方式

    这篇文章主要介绍了vue项目之数量占比进度条实现方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-12-12
  • vue模板配置与webstorm代码格式规范设置

    vue模板配置与webstorm代码格式规范设置

    这篇文章主要介绍了vue模板配置与webstorm代码格式规范设置详细的相关资料,需要的朋友可以参考一下文章得具体内容,希望对你有所帮助
    2021-10-10

最新评论