Vue3.x 从零开始（二）—— 重新认识 Vue 组件

Vue 3 更新了许多组件中的语法，包括生命周期、filter、setup、teleport 等

为了介绍这些特性，需要先了解一下 Vue 组件的基本玩法

这篇文章介绍的内容基本都是沿用 Vue 2 的语法，只在一些细节上有所调整

 

一、单文件组件

通过 Vue.createApp() 创建的应用，可以使用 component 方法创建自定义组件

const app = Vue.createApp({});
app.component('my-component', {
  data() {
    return {
      name: 'Wise.Wrong'
    }
  },
  template: `<div>hello {{name}}</div>`,
});

不过在实际项目中，都是使用“单文件组件”，也就是以 .vue 文件的形式开发

比如上面组件，改写成单文件组件就是这样的：

<template>
  <div>hello {{ name }}</div>
</template>

<script lang="ts">
/* 当前文件路径: src/components/my-component.vue */
import { defineComponent } from 'vue';

export default defineComponent({
  name: 'MyComponent',
  data() {
    return {
      name: 'Wise.Wrong',
    };
  },
});
</script>

这里的 data 必须通过函数的形式返回一个对象，而不能直接使用对象

// 2.x 可以接收对象，但 3.x 的 data 只能是 function 

 

假如现在还有另一个组件 <home> ，我们希望在 <home> 组件中使用 <my-component>

可以直接在 <home> 中引入 my-component.vue 文件，然后通过 components 属性注册组件

上面的代码中，我在 components 中使用的是大驼峰命名组件，而在 <template> 中使用的是短线命名

这是因为 HTML 本身不区分大小写，Vue 更建议我们在 DOM 中使用全小写的短线命名的方式

 

二、Props

现在我们有了一个父组件 <home> 与子组件 <my-component>

如果我想在父组件中向子组件传递参数，可以通过 Props

首先在子组件定义 props

然后父组件传入对应的 props 属性值

最终结果

除了定义数组形式的 props 之外，还可以使用对象类型，这样就能对 props 做更多限制

export default defineComponent({
  // ...
  props: {
    likes: String, // 仅限定类型
    years: {
      type: [String, Number],
      required: true, // 必填
    },
    info: {
      type: Object,
      default: () => ({ // 对象和数组类型的默认值只能用函数返回
        title: '这里是对象类型的 prop',
      }),
    },
    type: {
      // 自定义校验函数
      validator: (val: string) => (
        ['success', 'warning', 'danger'].indexOf(val) !== -1
      ),
    },
  },
  // ...
});

如果父组件传参不符合子组件中 props 定义的规则，Vue 会在控制台抛错

更多关于 Props 的使用可以查看官方文档

 

三、无状态组件

在子组件中，props 和 data 一样都是直接挂载到 this 对象下的，可以通过 this.xxx 的方式取值

对于某些功能型组件，只需要 props 不需要 data。比如这样的一个提示框组件：

<template>
  <div :class="['alert', type]">
    <div class="alert-content">{{content}}</div>
  </div>
</template>

<script lang="ts">
import { defineComponent } from 'vue';

export default defineComponent({
  name: 'Alert',
  props: ['type', 'content'],
});
</script>

这种只接收 props，没有定义 data、methods、computed 等响应数据的组件，被称为无状态组件

在 Vue 2 中，无状态组件的初始化比普通组件快得多，所以经常会作为性能优化的一个考量

为了创建一个无状态组件，必须在 <template> 中声明 functional

<template functional>
Vue 2
</template>

但是在 Vue 3 中，无状态组件不再需要声明 functional

只需要像一个普通组件一样定义，只是不要添加 data 等响应数据，就像上面的提示框组件那样

官方文档是这样解释的：

However, in Vue 3, the performance of stateful components has improved to the point that the difference is negligible.

但是，在Vue 3中，有状态组件的性能已提高到比肩无状态组件的程度。

emmmmmm... 相当的膨胀...

不过我喜欢~

 

四、Mixin

与无状态组件相对应的是有状态组件，也就是带有 data 等响应数据的组件，我们工作中写的组件大部分都是有状态组件

而随着业务的不断扩大，整个应用变得非常臃肿，这时候组件共用和逻辑抽取就尤为重要，这时候可以使用 mixin

 

假如我们有三个组件，它们的 js 部分都包含以下内容：

<script>
export default {
  // ...
  data() {
    return {
      // ...
      company: {
        name: 'Perfect World',
        address: 'Chongqing China',
      },
      loading: false,
    }
  },
  props: {
    // ...
    title: String
  },
  methods: {
    // ...
    fetchCompanyInfo(data) {
      this.loading = true;
      return fetch('/api')
        .then(res => res.json())
        .then(res => {
          this.company = { ...res.data };
        })
        .finally(_ => { 
          this.loading = false;
        })
    }
  },
};
</script>

三个组件都包含响应数据(data) loading 和 company，以及相应的查询方法(methods) fetchInfo，还有一个来自父组件的参数(props) title

这些逻辑完全一样，如果要在三个组件中各写一份完全一样的代码，就会非常难受，不利于维护

有了 mixin 之后，我们就能把这些逻辑写在一个对象里面并导出

/* mixin-test.js */
export default {
  data: () => ({
    loading: false
  }),
  props: {
    title: String
  },
  methods: {
    fetchCompanyInfo(data) {
      // ...
    }
  }
}

然后在需要用到这部分逻辑的组件中引入，并注册到 mixins

mixins 接收的是一个数组，也就是说可以同时注册多个 mixin

<script>
import MixinTest from "./mixin/mixin-test.js";

export default {
  // ...
  mixins: [ MixinTest ],
};
</script>

Vue 在初始化组件的时候，会将引入的 mixin 对象和当前组件进行合并

在合并的时候如果遇到了同名选项，对于不同的类型 (data、props、methods) 会有不同的策略

1. 如果是 props、methods、components、directives 冲突，会以组件本身的键值对覆盖 mixin

2. 对于生命周期这样的钩子函数出现冲突，会先触发 mixin 中的钩子函数，然后触发组件中的钩子函数

3. 如果 data 发生冲突，将执行浅层次的合并：

const Mixin = {
  data: ()=> ({
    user: { name: 'Jack', id: 1 }
  })
}

const Comp = {
  mixins: [Mixin],
  data: () => ({
    user: { id: 2 }
  })
}

// 最终的结果是：
{
  user: { id: 2 }
}

而在 Vue 2 中，data 会执行深层次的合并，上例的结果会变成：

{
  user: { id: 2, name: 'Jack' }
}

在 Vue 2 的时代，Mixin 是封装的共用逻辑的常用手段，但这种方式一直都受到很多开发者的质疑

首先就是 mixin 的重名问题，虽然 Vue 有一套合并策略（这个合并策略可以自定义）来处理 mixin 的重名问题

但组件内部是无法知道 mixin 到底提供了哪些字段，如果后来的维护人员不熟悉组件中的 mixin，在维护代码的时候很容易因为重名的问题导致 bug

而且 mixin 可以使用组件中的数据，如果维护组件的时候更改了 mixin 所依赖的数据，也会导致 bug

为了解决这些问题，Vue 3 推出了 Composition API ，用函数式编程的思想来封装组件逻辑

欲知 Composition API 如何，请听下回分解~