• Vue 组件设计


    Vue 组件设计

    Vue 作为 MVVM 框架一员,不管是写业务还是基础服务,都少不了书写组件。本文总结一下书写业务组件的一些心得。

    为什么要写组件?

    我们知道,只要是组件,就需要在引用的时候与 view 或者其他组件进行相关的交互,即 props 传值,$emit 触发事件,
    使用 $refs 调用组件方法等,与写在同一个文件相比,耗费的精力明显更多。那为什么需要拆分出组件呢?我认为有两种目的:
    复用和隔离。

    复用

    在业务代码中,会有大量类似的界面,保证交互唯一,即使我们有了类似 element-ui 或者 iview 这种基础组件库,
    我们同样需要为这些基础组件添加 props 或者 events,只有一处使用时,没有任何问题,当你的业务中出现两次、三次甚至更多时,
    代码中会出现大量重复的代码,而且这些代码在线上可能会慢慢露出一些深层次的 bug,要修复这些 BUG,就需要 n 倍的时间去写同样的代码,
    让人抓狂。所以我们页面同样需要像 js 抽出公用的方法一样抽出公用组件,这就是复用的目的。

    隔离

    复用针对的是代码重复问题,而隔离则是针对代码逻辑过于复杂的问题。通常我们要实现一个复杂的逻辑,它是一个扁平化的多逻辑并行问题,
    人脑对于同时思考是有一定限制的,过于复杂就很难一下考虑全面。
    首先需要抽象出它的目的,然后对实现进行分层,让每一层只解决一个简单的问题,这些层合起来形成一个完整的解决方案;
    或者将问题拆分成几块,每块之间具有一定的联系,每次思考时只需要考虑局部的逻辑即可。
    不管是分层、分块还是混合式,它的目的是对进行隔离,从而简化问题。如果某个页面 js + template 行数非常多(1k+),
    这个时候就可以考虑是不是要对部分功能拆解,便于在后续添加新功能,或者修改 BUG 的时候更为方便定位到问题的代码,
    不会出现改错函数的问题。

    需要注意的是,虽然复用和隔离是让逻辑更为清晰,但使用自己写的组件会让项目的入手难度提高,需要先了解整体的设计,
    才能针对性的修改代码或者添加新的功能,得失各半。

    组件设计的一些理念

    网上有关于组件设计的基本原则:http://www.fly63.com/article/detial/996
    内容比较多,下面进行一些常用的原则归纳。

    单一职责

    之前提到的组件拆分目的:复用与隔离,对于隔离的类型,组件业务必然很重,此时虽然要保证组件尽可能简单,
    而复用类型的,通用性更强,所以功能越单一,使用起来就越方便。我们知道 react 有一个概念:container/component,
    即 component 只是渲染组件,而 container 才是产生业务的组件,我们 Vue 也可以依照这个理念进行设计。
    即把数据处理等带有副作用的工作放在父组件中,而子组件只进行展示或操作,通过事件的方式让父组件进行处理,
    保证逻辑归一,后续维护也更为方便。或者使用 slot 等类似高阶组件的方式来简化当前组件的内容。

    无副作用/引用透明

    和纯函数类似,设计的一个组件不应该对父组件产生副作用,从而达到引用透明(引用多次不影响结果)。
    数据操作前必须进行复制。比如需要添加额外的键值,或者需要对数组类型的数据进行操作,会对原始数据产生影响,
    需要使用解构的方式进行复制:

    const newData = { ...oldData }
    const newList = [...oldList]
    

    注:引用类型的 props 千万不要直接修改对象,虽然能够达到传递数据的目的,但会产生副作用,如果有其他地方用到该数据,可能产生未知的影响。

    入口和出口正确性检查

    Vue 提供了类型检查工具,只在 dev 情况下生效,虽然和 JSON Schema 相比功能比较少,但能够做基本的类型检查了,
    我们只需要在 props 时不使用字符串型,而是为它定义详细的类型, 并为它设置默认值(vue-cli 的 eslint 严格模式已经强制要求):

    ['name1'] // 不规范写法
    {
      name1: {
        type: String,
        default: undefined
      }
    }
    

    组件划分颗粒度

    组件拆分出来之后,拆成几层或者是拆成几块,影响文件的数量。如果层级比较多,各种 props 传递,事件传递,维护成本比较高。
    举例:如果是一个二级的列表,即有多个一级列表,一级列表各有一级列表,这个时候应该怎么拆分呢?
    按单一原则,我们可能需要拆分成以下几个:一级列表卡片本身,二级列表卡片,二级列表承载组件,一级列表承载组件。
    这种划分,组件是三级,两块,数据的传递就会比较困难。如果一级卡片列表不复杂,我们可以将几个 v-for 与组件本身合并,
    即一级列表承载组件+一级列表卡片+二级列表卡片,二级列表卡片。这种处理方式保证所有的数据处理在第一层上,二级卡片只做渲染,
    保证逻辑处理集中在一个组件,维护也比较方便。当然,如果一级卡片非常复杂,或者数据需要大量的处理,需要根据情况把最细的进行合并。

    新功能下添加新属性/新文件

    对于通用类型组件,我们要求它尽可能的短小精悍,调用起来更为简单,所以不能设计太多的参数。基础组件库不能符合这个要求,
    主要是因为基础组件库需要尽可能增加普适性,不会因为没有某个常用的属性,导致该组件需要复制一份重写,再加上日积月累的 pull request,
    属性和参数必然会越来越多。而我们在业务中使用,完全不需要这么多的配置,如果有重大差别,重新复制一份,对于后续的维护反而更方便。
    所以是否新增加属性还是拷贝一份,是根据后续该组件是否会产生比较大的发展方向差异来决定的。

    Vue 组件之间的交互设计

    Vue 组件与 React 组件有比较大的区别,模板的设计更偏向于 HTML,所以要实现类似 react 的高阶组件的需求通常比较少,
    而高阶组件集成度过高,对于业务来说,当业务越来越复杂,组件内部逻辑将拆分困难,未必是件好事,所以我们只讨论普通的组件设计。
    组件设计是考虑组件通讯方式,主要分为以下几个方面:向下传值,向上传值,伪双向绑定,方法调用。

    数据流转

    向下传值

    向下传值就是父级传给子级数据。前面已经提到了,在 props 传值尽量对传入数据进行类型校验,保证尽快发现问题。除此之外,也有一些注意事项。
    传值类型如果是引用类型的 Object 类型,那么尽量给它默认值,防止 undefined。

    default: () => ({})
    

    其次,父级在赋值时,不要使用 a=newData 这种写法,而是使用 Object.assign 来保证能准确触发组件更新。
    还有另外一种方式,但不方便声明所有对象内的数据时,可以使用 this.$set(this, 'key', newData),保证对象一定会被监听到。

    向上传值

    Vue 2.0 需要使用 $emit 进行事件向上冒泡, 父组件进行事件的监听就可以进行处理。

    伪双向绑定

    Vue 2.0 提供了语法糖,支持双向绑定,使得Vue 进行双向传递数据极为方便,不需要既向上传值又向下传值。
    当然它不是真正的绑定,而是封装了之前提到的向下传值和向上传值,简单的语法糖。它分为两类:v-model 和 .sync 修饰符
    数据传递支持各种类型,不过建议传递的数据使用数组而不要使用对象类型,对象类型可能会出现渲染监听失败的问题。

    v-model

    v-model 使用的是 value 属性和 input 事件,父组件会自动把 input 事件的值赋给对应的变量。
    在设计组件中,如果有双向的数据传递,且符合组件设计目的,应该优先使用 v-model 来实现数据的控制,
    这样的组件更符合 Vue 组件的标准。

    要注意的是,如果是自行写 render 函数,双向绑定要自己实现。

    sync

    .sync 修饰符和 v-model 比较类似,不过它的 props 可以是自定义的,而向上传值时方式为:

    this.$emit('update:propsName', val)
    

    本质上和 v-model 是类似的。sync 修饰符相比于 v-model,语义化更好,用起来更方便

    方法调用

    有了 props 和 emit ,我们已经基本能够实现大部分功能了,但总有些子组件的层次控制或者数据控制无法通过这种方式实现,
    这个时候,组件间的交互就需要使用子组件的 Methods 来定义,使用 this.$refs.组件ref 来调用它的方法。
    比如说 el-tree 组件,设置选中和非选中,只靠数据传递,无法保证设计选中状态,所以它提供了一些方法来进行手动选择。
    在设计组件时,使用方法进行控制应该是最后才考虑的,因为我们通常无法一眼看出某个方法是否应该支持外部调用,
    只能通过看文档才能得知相关的方法

    简化与抽离的其他实现

    除组件外,Vue 提供了一些机制用于减少项目中的代码重复率。

    使用插件或者 mixins 实现

    插件机制需要在 Vue 初始化的时候引入。看下 vue-meta 的插件入口写法:

    /**
     * Plugin install function.
     * @param {Function} Vue - the Vue constructor.
     */
    export default function VueMeta (Vue, options = {}) {
      // set some default options
      const defaultOptions = {
        keyName: VUE_META_KEY_NAME,
        contentKeyName: VUE_META_CONTENT_KEY,
        metaTemplateKeyName: VUE_META_TEMPLATE_KEY_NAME,
        attribute: VUE_META_ATTRIBUTE,
        ssrAttribute: VUE_META_SERVER_RENDERED_ATTRIBUTE,
        tagIDKeyName: VUE_META_TAG_LIST_ID_KEY_NAME
      }
      // combine options
      options = assign(defaultOptions, options)
    
      // bind the $meta method to this component instance
      Vue.prototype.$meta = $meta(options)
    
      // store an id to keep track of DOM updates
      let batchID = null
    
      // watch for client side component updates
      Vue.mixin({
        beforeCreate () {
          // Add a marker to know if it uses metaInfo
          // _vnode is used to know that it's attached to a real component
          // useful if we use some mixin to add some meta tags (like nuxt-i18n)
          if (typeof this.$options[options.keyName] !== 'undefined') {
            this._hasMetaInfo = true
          }
          // coerce function-style metaInfo to a computed prop so we can observe
          // it on creation
          if (typeof this.$options[options.keyName] === 'function') {
            if (typeof this.$options.computed === 'undefined') {
              this.$options.computed = {}
            }
            this.$options.computed.$metaInfo = this.$options[options.keyName]
          }
        },
        created () {
          // if computed $metaInfo exists, watch it for updates & trigger a refresh
          // when it changes (i.e. automatically handle async actions that affect metaInfo)
          // credit for this suggestion goes to [Sébastien Chopin](https://github.com/Atinux)
          if (!this.$isServer && this.$metaInfo) {
            this.$watch('$metaInfo', () => {
              // batch potential DOM updates to prevent extraneous re-rendering
              batchID = batchUpdate(batchID, () => this.$meta().refresh())
            })
          }
        },
        activated () {
          if (this._hasMetaInfo) {
            // batch potential DOM updates to prevent extraneous re-rendering
            batchID = batchUpdate(batchID, () => this.$meta().refresh())
          }
        },
        deactivated () {
          if (this._hasMetaInfo) {
            // batch potential DOM updates to prevent extraneous re-rendering
            batchID = batchUpdate(batchID, () => this.$meta().refresh())
          }
        },
        beforeMount () {
          // batch potential DOM updates to prevent extraneous re-rendering
          if (this._hasMetaInfo) {
            batchID = batchUpdate(batchID, () => this.$meta().refresh())
          }
        },
        destroyed () {
          // do not trigger refresh on the server side
          if (this.$isServer) return
          // re-render meta data when returning from a child component to parent
          if (this._hasMetaInfo) {
            // Wait that element is hidden before refreshing meta tags (to support animations)
            const interval = setInterval(() => {
              if (this.$el && this.$el.offsetParent !== null) return
              clearInterval(interval)
              if (!this.$parent) return
              batchID = batchUpdate(batchID, () => this.$meta().refresh())
            }, 50)
          }
        }
      })
    }
    

    要的本质是使用 prototype 设置独立变量,然后使用 mixins 注入相关的方法。可以看到,基本上每个生命周期都会处理到。
    mixin 不仅使用在插件中,直接使用也是可以的。关于 mixins 可看官方文档:https://cn.vuejs.org/v2/guide/mixins.html.

    事件与属性透传

    之前提到组件尽可能参数少,但参数过少,组件无法实现某些定制化的要求,而我们组件可能有多个层次,
    这种情况下我们需要将当前组件的父组件的其他属性透传给子组件,将父组件其他事件监听给子组件,写法如下:

    <div name="main">
      <input v-on='$listeners' v-bind="$attrs" />
    </div>
    

    其他注意事项

    DOM 操作

    正常情况下是不推荐业务组件直接操作 DOM 的,但有时候要写组件监听事件,这种情况下一定要注意在 destroyed 时候进行 removeEventListener。

  • 相关阅读:
    IntelliJ IDEA 2019.2.3 x64版本设置Run Dashboard
    IntelliJ IDEA 使用Tomcat后在控制台出现乱码'中文乱码 “淇℃伅”“涓夋湀”
    window10家庭版管理员权限问题
    用navicat连接数据库报错:1130-host ... is not allowed to connect to this MySql server如何处理
    IntelliJ IDEA导入已有的项目的方法
    从养孩子谈谈 IO 模型(一)
    写作之路,以梦为马,不负韶华
    数据库核心:索引,你知道多少?
    面试:啥是数据倾斜?就是数据歪啦!
    ​面试:业务开发中你用到了哪些算法(续)?
  • 原文地址:https://www.cnblogs.com/dreamless/p/10314408.html
Copyright © 2020-2023  润新知