Vue3快速上手

1.Vue3简介

• 2020年9月18日，Vue.js发布3.0版本，代号：One Piece（海贼王）
• 耗时2年多、2600+次提交 (opens new window)、30+个RFC (opens new window)、600+次PR (opens new window)、99位贡献者 (opens new window)
• github上的tags地址：https://github.com/vuejs/vue-next/releases/tag/v3.0.0

2.Vue3带来了什么

1.性能的提升

• 打包大小减少41%

• 初次渲染快55%, 更新渲染快133%

• 内存减少54%

  ......

2.源码的升级

• 使用Proxy代替defineProperty实现响应式

• 重写虚拟DOM的实现和Tree-Shaking

  ......

3.拥抱TypeScript

• Vue3可以更好的支持TypeScript

4.新的特性

1. Composition API（组合API）

   • setup配置
   • ref与reactive
   • watch与watchEffect
   • provide与inject
   • ......

2. 新的内置组件

   • Fragment
   • Teleport
   • Suspense

3. 其他改变

   • 新的生命周期钩子
   • data 选项应始终被声明为一个函数
   • 移除keyCode支持作为 v-on 的修饰符
   • ......

一、创建Vue3.0工程

1.使用 vue-cli 创建

官方文档：https://cli.vuejs.org/zh/guide/creating-a-project.html#vue-create

## 查看@vue/cli版本，确保@vue/cli版本在4.5.0以上
vue --version
## 安装或者升级你的@vue/cli
npm install -g @vue/cli
## 创建
vue create vue_test
## 启动
cd vue_test
npm run serve

2.使用 vite 创建

官方文档：https://v3.cn.vuejs.org/guide/installation.html#vite

vite官网：https://vitejs.cn

• 什么是vite？—— 新一代前端构建工具。
• 优势如下：
  • 开发环境中，无需打包操作，可快速的冷启动。
  • 轻量快速的热重载（HMR）。
  • 真正的按需编译，不再等待整个应用编译完成。
• 传统构建 与 vite构建对比图

## 创建工程
npm init vite-app <project-name>
## 进入工程目录
cd <project-name>
## 安装依赖
npm install
## 运行
npm run dev

二、常用 Composition API

官方文档: https://v3.cn.vuejs.org/guide/composition-api-introduction.html

1.拉开序幕的setup

1. 理解：Vue3.0 中一个新的配置项，值为一个函数。

2. setup 是所有 Composition API（组合API） “ 表演的舞台 ”。

3. 组件中所用到的：数据、方法等等，均要配置在 setup 中。

4. setup 函数的两种返回值：

   1. 若返回一个对象，则对象中的属性、方法, 在模板中均可以直接使用。（重点关注！）

      return {
          dataA: null,
          dataB: null,
          ...
      }
      

   2. 若返回一个渲染函数：则可以自定义渲染内容。（了解）

      import { h } from 'vue'
      
      return () => h('h1', 'Hello World') // 覆盖根元素 template 的所有内容
      

5. 注意点：

   1. 尽量不要与 Vue2.x 配置混用

      • Vue 2.x 配置（data、methods、computed...）中 可以访问到 setup 中的属性、方法。

      • 但在 setup 中不能访问到 Vue2.x 配置（data、methods、computed...）。

        原因在于：setup 相当于在 Vue2.x 中的 beforeCreate 钩子函数之前执行，此时 data、methods 等数据均为初始化，所以访问不到这些配置项。

      • 如果有重名, setup 优先。

   2. setup 不能是一个 async 函数，因为返回值不再是 return 的对象, 而是 promise， 模板看不到 return 对象中的属性。（后期也可以返回一个 Promise 实例，但需要 Suspense 和异步组件的配合）

2.ref函数

• 作用: 定义一个响应式的数据
• 语法: const xxx = ref(initValue)
  • 创建一个包含响应式数据的 引用对象（RefImpl (Reference Implement)，简称 ref 对象）。
  • setup 中操作数据： xxx.value
  • 模板中读取数据: 不需要 .value，直接：<div></div>
• 备注：
  • 接收的数据可以是：基本类型、也可以是对象类型。
  • 基本类型的数据：响应式依然是靠 Object.defineProperty() 的 get 与 set 完成的。
  • 对象类型的数据：内部借助了 Vue3.0 封装的一个新函数—— reactive函数。

3.reactive函数

• 作用: 定义一个 对象类型 的响应式数据（基本类型不要用它，要用ref函数）
• 语法：const 代理对象 = reactive(源对象)，接收一个对象（或数组），返回一个代理对象（Proxy 的实例对象，简称 proxy 对象）
• reactive 定义的响应式数据是“深层次的”，即对象的所有属性都变为响应式。
• 内部基于 ES6 的 Proxy 实现，通过代理对象操作源对象内部数据进行操作。

4.Vue3.0中的响应式原理

vue2.x的响应式

• 实现原理：

  • 对象类型：通过Object.defineProperty()对属性的读取、修改进行拦截（数据劫持）。

  • 数组类型：通过重写更新数组的一系列方法来实现拦截。（对数组的变更方法进行了包裹）。

    Object.defineProperty(data, 'count', {
        get () {}, 
        set () {}
    })
    

• 存在问题：

  • 新增属性、删除属性, 界面不会更新。
  • 直接通过下标修改数组, 界面不会自动更新。

Vue3.0的响应式

• 实现原理：
  • 通过 Proxy（代理）：拦截对象中任意属性的变化, 包括：属性值的读写、属性的添加、属性的删除等。
  • 通过 Reflect（反射）： 对源对象的属性进行操作。
  • MDN 文档中描述的 Proxy 与 Reflect：

    • Proxy：https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Proxy

    • Reflect：https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Reflect

      使用 Reflect 去操作源对象的属性可以避免一些不必要的错误。例如，使用 Object.defineProperty() 去给对象属性添加响应式，当属性重名就会报错，而用 Reflect.defineProperty() 会返回操作结果，避免程序中断。

      new Proxy(data, {
      	// 拦截读取属性值
          get (target, prop) {
          	return Reflect.get(target, prop)
          },
          // 拦截设置属性值或添加新属性
          set (target, prop, value) {
          	return Reflect.set(target, prop, value)
          },
          // 拦截删除属性
          deleteProperty (target, prop) {
          	return Reflect.deleteProperty(target, prop)
          }
      })
      
      proxy.name = 'tom'   
      

5.reactive对比ref

• 从定义数据角度对比：
  • ref 用来定义：基本类型数据。
  • reactive 用来定义：对象（或数组）类型数据。
  • 备注：ref 也可以用来定义 对象（或数组）类型数据，它内部会自动通过reactive转为 代理对象。
• 从原理角度对比：
  • ref 通过Object.defineProperty()的get与set来实现响应式（数据劫持）。
  • reactive 通过使用 Proxy 来实现响应式（数据劫持）, 并通过 Reflect 操作 源对象 内部的数据。
• 从使用角度对比：
  • ref 定义的数据：操作数据需要.value，读取数据时模板中直接读取不需要.value。
  • reactive 定义的数据：操作数据与读取数据：均不需要.value。

6.setup的两个注意点

• setup 执行的时机

  • 在 beforeCreate 之前执行一次，this 是 undefined。

• setup 的参数

  • props：值为对象，包含：组件外部传递过来，且组件内部声明接收了的属性。
  • context：上下文对象

    • attrs：值为对象，包含：组件外部传递过来，但没有在 props 配置中声明的属性，相当于 this.$attrs。

    • slots：收到的插槽内容，相当于 this.$slots。

      Vue3 推荐使用 v-slot:xxx 向插槽传递内容。

    • emit：分发自定义事件的函数：相当于 this.$emit。

      Vue3 中需要先声明 emits: [] 选项，否则会报错。

7.计算属性与监视

1.computed函数

• 与 Vue2.x 中 computed 配置功能一致

• 写法

  import { computed } from 'vue'
  
  setup() {
      ...
  	// 计算属性 —— 简写（属性只读，不能被修改）
      let fullName = computed(() => {
          return person.firstName + '-' + person.lastName
      })
      
      // 计算属性 —— 完整（属性可以读写）
      let fullName = computed({
          get() {
              return person.firstName + '-' + person.lastName
          },
          set(value) {
              const nameArr = value.split('-')
              person.firstName = nameArr[0]
              person.lastName = nameArr[1]
          }
      })
  }
  

2.watch函数

• 与 Vue2.x 中 watch 配置功能一致

  watch: {
    // 简写
    sum(newValue, oldValue) {
      console.log(newValue, oldValue)
    }
    // 完整写法
    sum: {
      immediate: true, // 立即监听
      deep: true, // 对象属性深层监听
      handler(newValue, oldValue) {
        console.log(newValue, oldValue)
      }
    }
  }
  

• 两个小“坑”：

  • 监视 reactive 定义的响应式数据时：oldValue 无法正确获取、强制开启了深度监视（deep 配置失效）。
  • 监视 reactive 定义的响应式数据中某个属性时：deep配置有效。

  import { ref, reactive, watch } from 'vue'
  // ...
  const sum = ref(0)
  const msg = ref('hello')
  const person = reactive({
    name: 'Jack',
    age: 18,
    jobs: {
      job1: {
        salary: 20
      }
    }
  })
  
  // 情况一：监视 ref 定义的响应式数据
  watch(sum, (newValue, oldValue) => {
    console.log('sum变化了', newValue, oldValue)
  }, { immediate: true }) // 第三个参数可选
  
  // 情况二：监视多个 ref 定义的响应式数据
  watch([sum, msg], (newValue, oldValue) => {
    console.log('sum 或 msg 变化了', newValue, oldValue) // newValue 和 oldValue 也是一个数组
  }) 
  
  /* 情况三：监视 reactive 定义的响应式数据的【全部属性】
        1. 若 watch 监视的是 reactive 定义的响应式数据，则无法正确获得 oldValue！
        2. 若 watch 监视的是 reactive 定义的响应式数据，则强制开启了深度监视（deep 配置项无效）
  */
  watch(person, (newValue, oldValue) => {
    console.log('person变化了', newValue, oldValue)
  }, { immediate: true, deep: false }) // 此处的 deep 配置无效，无需配置
  
  // 情况四：监视 reactive 定义的响应式数据的【某个属性】
  watch(() => person.job, (newValue, oldValue) => { // 第一个参数变为回调函数
    console.log('person的job变化了', newValue, oldValue)
  }, { immediate: true }) 
  
  // 情况五：监视 reactive 定义的响应式数据的【某些属性】
  watch([() => person.job, () => person.name], (newValue, oldValue) => { // 第一个参数变为数组
    console.log('person的job变化了', newValue, oldValue)
  }, { immediate: true })
  
  // 特殊情况
  watch(() => person.job, (newValue, oldValue) => {
    console.log('person的job变化了', newValue, oldValue)
  },{ deep: true }) // 此处由于监视的是 reactive 定义对象中的某个属性，所以 deep 配置有效
  

3.watchEffect函数

• watch 的套路是：既要指明监视的属性，也要指明监视的回调。

• watchEffect 的套路是：不用指明监视哪个属性，监视的回调中用到哪个属性，那就监视哪个属性。

• watchEffect 有点像 computed：

  • 但 computed 注重的计算出来的值（回调函数的返回值），所以必须要写返回值。
  • 而 watchEffect 更注重的是过程（回调函数的函数体），所以不用写返回值。

  // watchEffect 所指定的回调中用到的数据只要发生变化，则直接重新执行回调。
  watchEffect(()=>{
      const x1 = sum.value
      const x2 = person.age
      console.log('watchEffect配置的回调执行了')
  })
  

8.生命周期

• Vue2 的生命周期

  

• Vue3 的生命周期

  

• Vue3 中可以继续使用Vue2 中的生命周期钩子，但有有两个被更名：

  • beforeDestroy改名为 beforeUnmount
  • destroyed改名为 unmounted

• Vue3.0也提供了 Composition API 形式的生命周期钩子，与Vue2.x中钩子对应关系如下：

  • beforeCreate===>setup()
  • created=======>setup()
  • beforeMount ===>onBeforeMount
  • mounted=======>onMounted
  • beforeUpdate===>onBeforeUpdate
  • updated =======>onUpdated
  • beforeUnmount ==>onBeforeUnmount
  • unmounted =====>onUnmounted

9.自定义hook函数

• 什么是 hook？—— 本质是一个函数，把 setup 函数中使用的 Composition API 进行了封装。
• 类似于 vue2.x 中的 mixin。
• 自定义 hook 的优势：复用代码, 让 setup 中的逻辑更清楚易懂。

src/hooks/usePoint.js (一般文件以 use 开头)

import { reactive, onMounted, onBeforeUnmount } from 'vue'
export default function() {
  const point = reactive({
    x: 0,
    y: 0
  })
  
  const setPoint = event => {
    point.x = event.pageX
    point.y = event.pageY
  }
  
  onMounted(() => {
    window.addEventListener('click', setPoint)
  })
  onBeforeUnmount(() => {
    window.removeEventListener('click', setPoint)
  })
   
  return point
}

src/components/Demo.vue

import usePoint from '../hooks/usePoint.js'

export default {
  setup() {
    const point = usePoint()
    
    return {
      point
    }
  }
}

10.toRef和toRefs

toRef

• 作用：创建一个 ref 对象，其 value 值指向另一个对象中的某个属性。

• 语法：const name = toRef(person,'name')

• 应用：要将响应式对象中的某个属性单独提供给外部使用时。

• const person = reactive({
    name: 'Jack',
    age: 18,
    gender: 'male'
  })
  
  const name = person.name // 只是将属性中的字符串 name 赋值给新的变量 name，这个变量将失去响应式
  const age = toRef(person, 'age') // toRef 可以将 age 变为 RefImpl 对象，这个变量将拥有响应式
  
  return {
    name,
    age,
    gender
  }
  

toRefs

• 扩展：toRefs 与toRef功能一致，但可以批量创建多个 ref 对象，语法：toRefs(person)。

• const person = reactive({
    name: 'Jack',
    age: 18,
    gender: 'male'
  })
  
  const { name, myAge: age, gender } = toRefs(person) // 使用对象的解构
  
  return {
    name,
    myAge,
    gender,
    ...person // 或者使用扩展运算符
  }
  

三、其它 Composition API

1.shallowReactive与shallowRef

• shallowReactive：只处理对象最外层属性的响应式（浅响应式）。

  const person = shallowReactive({
    name: 'Jack', // 第一层属性将具备响应式
    gender: 'male',
    jobs: {
      job1: {
        salary: 20 // 里层不具备响应式
      }
    }
  })
  

• shallowRef：只处理基本数据类型的响应式, 不进行对象的响应式处理。

  const name = shallowRef('Jack') // 基本数据类型具有响应式
  const person = shallowRef({ // 对象类型不具备响应式
    name: 'Jack',
    gender: 'male'
  })
  

• 什么时候使用?

  • 如果有一个对象数据，结构比较深, 但变化时只是外层属性变化 ===> shallowReactive。

  • 如果有一个对象数据，后续功能不会修改该对象中的属性，而是生新的对象来替换 ===> shallowRef。

    const person = shallowRef({
      age: 18
    })
    
    person.age++ // age 失去响应式，不能修改该属性
    person.age = 22 // 但可以直接用新值覆盖该属性
    

2.readonly与shallowReadonly

• readonly：让一个响应式数据变为只读的（深只读）。

  const person = shallowReactive({
    name: 'Jack',
    gender: 'male',
    jobs: {
      job1: {
        salary: 20
      }
    }
  })
  
  const newPerson = readonly(person) // newPerson 里的所有属性均为只读
  

• shallowReadonly：让一个响应式数据变为只读的（浅只读）。

  const person = shallowReactive({
    name: 'Jack',
    gender: 'male',
    jobs: {
      job1: {
        salary: 20
      }
    }
  })
  
  const newPerson = shallowReadonly(person) // 只有第一层的属性为只读
  

• 应用场景: 不希望数据被修改时。

3.toRaw与markRaw

• toRaw：

  • 作用：将一个由reactive生成的响应式对象转为普通对象（无法作用于由 ref 生成的响应式对象）。
  • 使用场景：用于读取响应式对象对应的普通对象，对这个普通对象的所有操作，不会引起页面更新，也不会修改对象里的属性。

• markRaw：

  • 作用：标记一个对象，使其永远不会再成为响应式对象。

  • const person = reactive({
      name: 'Jack',
      gender: 'male',
      jobs: {
        job1: {
          salary: 20
        }
      }
    })
    
    const addCar = () => {
      const car = { name: 'AAA', price: 100, color: 'red' }
      // person.car = car // 这种方式直接向 person 中添加一个 car 对象，那么这个对象会自动变为响应式
      person.car = markRaw(car) // 将 car 对象标记为原生对象，添加到 person 中就不会转为响应式对象
    }
    
    return {
      person
    }
    

  • 应用场景：

    1. 有些值不应被设置为响应式的，例如复杂的第三方类库等。
    2. 当渲染具有不可变数据源的大列表时，跳过响应式转换可以提高性能。

4.customRef

• 作用：创建一个自定义的 ref，并对其依赖项跟踪和更新触发进行显式控制。

• 实现防抖效果：

  <template>
    <input type="text" v-model="keyword">
    <h3>{{ keyword }}</h3>
  </template>
  
  <script>
    import { ref, customRef } from 'vue'
    export default {
      name:'Demo',
      setup() {
  	  // 自定义一个 Ref -- myRef
  	  function myRef(value, delay) {
  		let timer
  		// 通过 customRef 去实现自定义
  		return customRef((track, trigger) => {
  		  return {
  			get() {
                 console.log(`有人从 myRef 这个容器读取数据，我把${value}给他了`)
  			  track() // 告知 Vue 追踪 value 的变化（） 【1】【5】
  			  return value // 【2】【6】
  			},
  			set(newValue) {
  			  clearTimeout(timer)
  			  timer = setTimeout(() => {
  				value = newValue // 新值替代旧值 【3】
  				trigger() // 通知 Vue 更新界面 【4】
  			  }, delay)
  			}
  		  }
  		})
  	  }
          
        // let keyword = ref('hello') // 使用 Vue 准备好的内置 ref
  	  let keyword = myRef('hello', 500) // 使用开发人员自定义的 ref
  	  return {
  	    keyword
  	  }
      }
    }
  </script>
  

• 上述代码流程：

  1. 解析模板，找到 keyword 数据，触发 myRef 中的 getter，get 函数先调用 track 函数告知 Vue 追踪 value 的变化，然后返回 value；
  2. 在输入框中输入数据，keyword 被修改，触发 myRef 中的 setter，set 函数先将 value 的值变为 newValue，然后调用 trigger 函数，通知 Vue 更新页面；
  3. myRef 中的 getter 被触发，再次执行步骤 1。

5.provide 与 inject

• 作用：实现祖与后代组件间通信

• 套路：父组件有一个 provide 选项来提供数据，后代组件有一个 inject 选项来开始使用这些数据

• 具体写法：

  1. 祖组件中：

     import { provide } from 'vue'
     
     setup() {
       // ...
       let car = reactive({ name: '奔驰', price: '40万' })
       provide('car', car)
       // ...
     }
     

  2. 后代组件中：

     import { inject } from 'vue'
     
     setup(props, context){
       // ...
       const car = inject('car')
       return {car}
       // ...
     }
     

6.响应式数据的判断

• isRef：检查一个值是否为一个 ref 对象
• isReactive：检查一个对象是否是由 reactive 创建的响应式代理
• isReadonly：检查一个对象是否是由 readonly 创建的只读代理
• isProxy：检查一个对象是否是由 reactive 或者 readonly 方法创建的代理

const num = ref(0)
const person = reactive({ name: 'Jack', age: 20 })
const newPerson = readonly(person)

console.log(isRef(num)) // true
console.log(isReactive(person)) // true
console.log(isReadonly(newPerson)) // true
console.log(isProxy(person)) // true
console.log(isProxy(newPerson)) // true
console.log(isProxy(num)) // false, Ref 一个基本类型数据底层由 Obeject.defineProperty 实现

四、Composition API 的优势

1.Options API 存在的问题

使用传统OptionsAPI中，新增或者修改一个需求，就需要分别在data，methods，computed里修改 。

2.Composition API 的优势

我们可以更加优雅的组织我们的代码，函数。让相关功能的代码更加有序的组织在一起。

五、新的组件

1.Fragment

• 在 Vue2 中，组件必须有一个根标签；
• 在 Vue3 中，组件可以没有根标签, 内部会将多个标签包含在一个 Fragment 虚拟元素中；
• 好处：减少标签层级，减小内存占用。

2.Teleport

• 什么是 Teleport（瞬移）？—— Teleport 是一种能够将我们的组件html结构移动到指定位置的技术。

  <teleport to="body"> <!-- 将 teleport 包裹元素移动到 body 标签下 -->
    <div v-if="isShow" class="mask">
      <div class="dialog">
        <h3>我是一个弹窗</h3>
  	    <button @click="isShow = false">关闭弹窗</button>
  	</div>
    </div>
  </teleport>
  

3.Suspense

• Suspense（中止、暂停）；

• 等待异步组件时渲染一些额外内容，让应用有更好的用户体验；

• 使用步骤：

  • 异步引入组件

    import { defineAsyncComponent } from 'vue'
    const Child = defineAsyncComponent(() => import('./components/Child.vue'))
    

  • 使用Suspense包裹组件，并配置好default 与 fallback

    <template>
      <div class="app">
        <h3>我是App组件</h3>
    	<Suspense>
    	  <template v-slot:default> <!-- 要显示的组件内容 -->
    	    <Child/>
    	  </template>
    	  <template v-slot:fallback> <!-- 等待时显示的内容 -->
    	    <h3>加载中.....</h3>
    	  </template>
    	</Suspense>
      </div>
    </template>
    

• 除此之外，Supspense 还可以搭配 Promise 或者 async/await 实现组件的延时加载。例如，将上面示例中的 Child.vue 改为：

  setup() {
    const name = ref('child')
    return new Promise((resolve, reject) => {
      setTimeout(() => {
        resolve({ name })
      }, 3000)
    })
  }
  
  // 或者写成 async/await 形式
  async setup() {
    const name = ref('child')
    return await new Promise((resolve, reject) => {
      setTimeout(() => {
        resolve({ name })
      }, 3000)
    })
  }
  

  以上实现的效果就是，Child.vue 的内容会在 3 秒之后呈现出来，这三秒等待期间，显示的是 Suspense 里 fallback 的内容。

六、其他

1.全局API的转移

• Vue2 有许多全局 API 和配置。

  • 例如：注册全局组件、注册全局指令等。

    // 注册全局组件
    Vue.component('MyButton', {
      data: () => ({
        count: 0
      }),
      template: '<button @click="count++">Clicked {{ count }} times.</button>'
    })
    
    // 注册全局指令
    Vue.directive('focus', {
      inserted: el => el.focus()
    }
    

• Vue3 中对这些API做出了调整：

  • 将全局的API，即：Vue.xxx调整到应用实例 app 上

    2.x 全局 API（Vue）	3.x 实例 API (app)
    Vue.config.xxxx	app.config.xxxx
    Vue.config.productionTip	移除
    Vue.component	app.component
    Vue.directive	app.directive
    Vue.mixin	app.mixin
    Vue.use	app.use
    Vue.prototype	app.config.globalProperties

2.其他改变

• data 选项必须被声明为一个函数。

• 过度类名的更改：

  • Vue2 写法

    .v-enter,
    .v-leave-to {
      opacity: 0;
    }
    .v-leave,
    .v-enter-to {
      opacity: 1;
    }
    

  • Vue3 写法

    .v-enter-from,
    .v-leave-to {
      opacity: 0;
    }
    
    .v-leave-from,
    .v-enter-to {
      opacity: 1;
    }
    

• 移除 keyCode 作为 v-on 的修饰符，同时也不再支持config.keyCodes

• 移除v-on.native修饰符

  • 在 Vue2 中给一个组件添加 click 事件通常需要添加 .native 修饰符，如果不这样做，Vue 将会将 click 这个事件视为自定义事件，这样点击组件就不会生效。

    <Child @click.native='handleClickEvent' />
    

  • 在 Vue3 中如果组件有自定义事件，则需要用 emits 事先声明，否则一律按原生事件处理。

    • 父组件中绑定事件

      <my-component
        v-on:close="handleComponentEvent"
        v-on:click="handleNativeClickEvent"
      />
      

    • 子组件中声明自定义事件

      <script>
        export default {
          emits: ['close']
        }
      </script>
      

• 移除过滤器（filter）

  过滤器虽然这看起来很方便，但它需要一个自定义语法，打破大括号内表达式是 “只是 JavaScript” 的假设，这不仅有学习成本，而且有实现成本！建议用方法调用或计算属性去替换过滤器。

• ......