# vue3

**Repository Path**: yunfeng918/vue3

## Basic Information

- **Project Name**: vue3
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-10-26
- **Last Updated**: 2023-11-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Vue, vue3

## README

# vue-test-v3

# 创建 VUE 3 工程

# 常用 Compostion API

## 1 初始 setup

1. 理解：Vue3.0 中一个新的配置项，值为一个函数。
2. setup 是所有 Composition API（组合 API）的入口。
3. 组件中所用到的：数据、方法等等，均要配置在 setup 中。
4. setup 函数的两种返回值：
   1. 若返回一个对象，则对象中的属性、方法，在模板中可以直接使用。（常用）
   2. 若返回一个渲染函数，则可以自定义渲染内容。（了解）
5. 注意点：
   1. 尽量不要与 Vue2.x 配置混用
      1. Vue2.x 配置（data、methos、computed...）中可以访问 setup 中的属性、方法。
      2. setup 中不能访问 Vue2.x 配置（data、methos、computed...）。
      3. 如果有重名，setup 优先。
   2. setup 不能是一个 async 函数，因为返回值不再是 return 的对象，而是 promise，模板看不到 return 对象中的属性。注意：后期也可以返回一个 Promise 实例，但需要 Suspense 和异步组件的配合才能实现。

## 2 ref 函数

1. 作用：定义一个响应式数据。
2. 语法：`const xxx = ref(initValue)`
   1. 创建一个包含响应式数据的引用对象（reference 对象，简称 ref 对象）。
   2. JS 中操作数据：`xxx.value`
   3. 模板中操作数据：`<div>{{xxx}}</div>`， 不需要`.value`
3. 备注：
   1. 接收的数据可以是：基本类型、对象类型。
   2. 基表类型的数据：响应式依然是由`Object.defineProperty()`的 get、set 完成的
   3. 对象类型的数据：内部“求助”了 Vue3.0 中的一个新函数——`reactive`函数。

## 3 reactive 函数

1. 作用：定义一个对象类型的响应式数据（**基本类型不要用它**，否则 Vue 无法监听）。
2. 语法：`const 代理对象= reactive(源对象)`，接收一个对象（或数组），返回一个代理对象（Proxy 的实例对象，简称 procy 对象）
3. `reactive`定义的响应式数据是“深层次的”。
4. 内部基于 ES6 的`Proxy`实现，通过代理对象操作源对象内部数据。
5. reactive 与 ref 的区别：
   1. ref 用来定义：**响应式**的**基本类型数据**。
   2. reactive 用来定义：**响应式**的**对象类型数据（或数组类型数据）**。

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

### 1. Vue2 的响应式原理

1. 实现原理：
   1. 对象类型：通过`Object.defineProperty()`对属性的读、写、删进行拦截（数据劫持）。`Object.defineProperty(proxyPerson, key, {get(){}, set(val){}});`
   2. 数组类型：通过重写更新数组的一系列方法来实现拦截。（对数组的方法进行重写）
2. 存在问题：
   1. 新增属性、删除属性，默认无法触发响应式，可以手动去触发（`vm.$set`、`vm.$delete`）。
   2. 直接通过下标修改数组，默认无法触发响应式，可以手动去触发（`vm.$set`）。

### 2. Vue3 的响应式原理

1. 实现原理：
   1. 通过`Proxy`对象来对数据进行拦截（拦截对象属性的读、改、删、增）。
   2. 通过`Reflect`对象来对数据进行操作。
   3. MDN 文档中描述的 Proxy 和 Reflect 对象：
      1. Proxy: https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Proxy
      2. Reflect: https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/Reference/Global_Objects/Reflect
2. 实现步骤：

```JavaScript
// 原数据
let person = {
   name: '张三',
   age: 18,
}

// 代理数据

// 使用ES6的Proxy代理person对象
// 读取proxyPerson的属性时，会自动执行get方法
// 修改或添加proxyPerson的属性时，会自动执行set方法
// 删除proxyPerson的属性时，会自动执行deleteProperty方法
const proxyPerson = new Proxy(person, {
   get(target, propName) {
      console.log('读取了：' + propName + " 可以实现响应式");
      return Reflect.get(target, propName);
   },
   set(target, propName, value) {
      console.log('添加 或 修改了：' + propName + " 可以实现响应式");
      Reflect.set(target, propName, value);
   },
   deleteProperty(target, propName) {
      console.log('删除了：' + propName + " 可以实现响应式");
      return Reflect.deleteProperty(target, propName);
   }
});
```

## 5 reactive 对比 ref

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

## 6 setup 注意点

1. setup 执行的时机：在 beforeCreate 之前执行一次，此时组件实例尚未创建，this 是 undefined。
2. setup 的参数：
   1. props: 值为对象，包含：组件外部传递过来且组件内部声明接收了的属性
   2. context: 上下文对象，里面有 attrs、slots、emit 等属性。
      1. attrs: 值为对象，包含：组件外部传递过来，但没有在 props 配置中声明的属性，相当于 Vue2 的`this.$attrs`。
      2. slots: 收到的插槽内容，相当于 Vue2 的`this.$slots`。
      3. emit: 分类自定义事件的函数，相当于 Vue2 的`this.$emit`。

## 7 计算属性与监视

1. 计算属性：computed

   1. 与 vue2 中 computed 配置功能一致
   2. 写法：

   ```JavaScript
   import {computed} from 'vue';
   setup() {
      // 数据
      let person = reactive({
         firstName: '张',
         lastName: '三',
         age: 18
      });

      // 计算属性-简写（计算属性只读，不可修改）
      // person.fullName = computed(function () {
      //   return person.firstName + person.lastName
      // });

      // 计算属性-完整写法
      person.fullName = computed({
         get() {
         return person.firstName + "-" + person.lastName;
         },
         set(value) {
         const nameArr = value.split("-");
         person.firstName = nameArr[0];
         person.lastName = nameArr[1];
         }
      });

      return { person }
   }
   ```

2. 监视属性：watch

   1. 与 Vue2 中的 watch 配置功能一致
   2. 三个小坑：
      1. 监视 reactive 定义的响应式数据时，oldValue 无法正确获取，因为 oldValue 是在 getter 中获取的，而此时 getter 已经执行了，所以是获取不到正确的旧值
      2. 监视 reactive 定义的响应式数据时，强制开启了深度监视（deep 配置无效）
      3. 监视 reactive 定义的响应式数据中的某个对象属性时，deep 配置有效

3. watchEffect 函数
   1. watch 的套路是：既要指明要监视的属性，也要指明监视的回调。
   2. watchEffect 的套路是：不用指明要监视的属性，监视的回调中用到哪个属性就监视哪个属性。
   3. watchEffect 有点像 computed，
      1. 但 computed 注重的计算出来的值（回调函数的返回值），所以必须要写返回值。
      2. 而 watchEffect 更注重的是过程（回调函数的函数体），所以不用写返回值。
   ```JavaScript
    watchEffect(() => {
      let x = num.value;
      let y = person.job.job1.salary;
      console.log("Vue3 watchEffect监视执行了， 该函数用到了谁，就会监视谁", x, y);
    });
   ```

## 8 Vue3 生命周期

![Vue3生命周期](public/lifecycle-vue3.png)

1. Vue3 中可以继续使用 Vue2 中的生命周期钩子函数，但有两个改名了：
   - beforeDestroy 改名为 beforeUnmount
   - destroyed 改名为 unmounted
2. Vue3 也提供了 Composition API 形式的生命周期钩子， 与 Vue2 中钩子对应关系如下：
   - beforeCreate ==> setup()
   - created ==> setup()
   - beforeMount ==> onBeforeMount
   - mounted ==> onMounted
   - beforeUpdate ==> onBeforeUpdate
   - updated ==> onUpdated
   - beforeUnmount ==> onBeforeUnmount
   - unmounted ==> onUnmounted

## 9 自定义 hook 函数

1. 什么是 hook：本质是一个函数，吧 setup 函数中使用的 Composition API 进行了封装。
2. 类似于 Vue2 中的 mixin。
3. 自定义 hook 的优势: 复用代码，让 setup 中的逻辑更清楚易懂。

## 10 toRef

1. 作用：创建一个 ref 对象，其 value 值指向另一个对象中的某个属性。
2. 语法：const name = toRef(person, 'name');
3. 应用：要将响应式对象中的某个属性单独提供给外部使用时。
4. 扩展：toRefs 与 toRef 功能一致，但可以批量创建多个 ref 对象。语法：`toRefs(person)`

# 三 其它 Composition API

## 1 shallowReactive 与 ShallowRef

1. shallowReactive：只处理对象最外层属性的响应式（浅响应式）。
2. shallowRef：只处理基本数据类型的响应式，不进行对象的响应式处理。
3. 应用场景：
   1. 如果有一个对象数据，结构比较深，但变化时只是外层属性变化，则使用 shallowReactive。
   2. 如果有一个对象数据，后续功能不会修改对象中的属性，而是生新的对象来替换，则使用 shallowRef。

## 2 readonly 与 shallowReadonly

1. readonly：让一个响应式数据变为只读的（深只读）。
2. shallowReadonly：让一个响应式数据变为只读的（浅只读）。
3. 应用场景：不希望数据被修改时。

## 3 toRaw 与 markRaw

1. toRaw：
   1. 作用：讲一个 reactive 生成的**响应式对象**转为**原始对象**。
   2. 应用场景：用于读取响应式对象对应的普通对象，对这个普通对象的所有操作，不会引起页面更新。
2. markRaw：
   1. 作用：标记一个对象，使其永远不会再成为响应式对象。
   2. 应用场景：
      1. 有些值不应被设置为响应式的，例如复杂的第三方类库等。
      2. 当渲染具有不可变数据源的大列表时，跳过响应式转换可以提高性能。

## 4 customRef

1. 作用：创建一个自定义的 ref，并对其依赖项跟踪和更新触发进行显示控制。
2. 实现防抖效果：

```javaScript
setup() {
   function myRef(value, delay) {
   return customRef((track, trigger) => {
      let timer;
      return {
         get() {
         console.log("从myRef中读取了数据 ", value, track);
         track(); // 通知Vue追踪这个value的变化
         return value;
         },
         set(newValue) {
         clearTimeout(timer);
         console.log("把myRef中的数据修改了 ", newValue, trigger);
         timer = setTimeout(() => {
            value = newValue;
            trigger(); // 通知Vue重新解析模板，Vue重新解析模板调用get方法
         }, delay)
         }
      }
   });
   }

   let keyword = myRef("", 500);

   return {
   keyword
   }
},
```

## 5 provide 与 inject

1. 作用：实现**祖与后代组件间**通信。
2. 套路：祖组件有一个 `provide` 选项来提供数据，后代组件有一个 `inject` 选项来开始使用这些数据。
3. 具体写法：

   1. 祖组件中：

   ```JavaScript

   ```

   2. 后代组件中：

   ```JavaScript

   ```

## 6 响应式数据的判断

1. isRef：检查一个值是否为一个 ref 对象。
2. isReactive：检查一个对象是否为一个由 `reactive` 创建的响应式对象。
3. isReadonly：检查一个对象是否为一个由 `readonly` 创建的只读响应式对象。
4. isProxy：检查一个对象是否由 `reactive` 或 `readonly` 创建的代理。

# 四 Composition API 的优势

1. Options API 存在的问题：新增或者修改一个需求，就需要分别在 data、methods、computed、watch 里修改。
2. Composition API 优势：可以更加优雅的组织我们的代码在一个 hook 函数里，让相关功能的代码更加紧密有序的在一起。

# 五 新的组件

## 1 Fragment

1. 在 Vue2 中: 组件必须有一个根标签
2. 在 Vue3 中: 组件可以没有根标签, 内部会将多个标签封装到 Fragment 中
3. 好处: 减少标签层级, 减小内存占用

## 2 Teleport

1. 什么是 Teleport：Teleport 是一种能够将我们的`组件html结构`移动到指定位置的技术。

```html
<Teleport to="body">
  <div class="mask">
    <div class="dalog">
      <h3>我是一个 Dalog</h3>
      <p>这是一些 MSG</p>
      <button @click="closeDalog">关闭</button>
    </div>
  </div>
</Teleport>
```

## 3 Suspense

1. 等他异步组件时渲染一些额外内容，让应用有更好的用户体验
2. 使用步骤：

   1. 异步引入组件

   ```js
   import { defineAsyncComponent } from "vue";
   const Child = defineAsyncComponent(() => import("./components/Child"));
   ```

   2. 使用 Suspense 包裹组件，并配置号 default 和 fallback

   ```html
   <Suspense>
     <template v-slot:default>
       <Child></Child>
     </template>
     <template v-slot:fallback>
       <h2>Loading...</h2>
     </template>
   </Suspense>
   ```

   3. setup 可以使用 async 修饰，返回一个 Promise 对象

   ```js
   async setup() {
    let num = ref(100);

    let p = new Promise((resolve) => {
      setTimeout(() => {
        resolve({ num });
      }, 3000);
    });
    return await p;
   }
   ```

# 六 其他

## 1 全局 API 的转移

1. Vue2.x 有许多全局 API, 例如：注册全局组件，注册全局指令等。

```js
Vue.component('MyComp',{ el:"app", data: ()=>({ msg: 'hello'})})

Vue.directive('myFocus', {inserted: function (el, binding) { el.focus()});
```

2. Vue3.0 中这些 API 做出了调整：将全局的 API，调整到应用实例（app）上了
   | 2.x 全局 API | 3.x 实例 API |
   | ------------ | ------------ |
   | 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 其他更改

1. data 选项应始终被声明为一个函数
2. 过度类名的更改
   1. Vue2.x 写法
   ```css
   .fade-enter,
   .fade-leave-to {
     opacity: 0;
   }
   .v-leave,
   .v-leave-to {
     opacity: 1;
   }
   ```
   2. Vue3.x 写法
   ```css
   .fade-enter-from,
   .fade-leave-to {
     opacity: 0;
   }
   .v-leave-from,
   .v-leave-to {
     opacity: 1;
   }
   ```
3. **移除**keyCode 作用 v-on 的修饰符，同时也不再支持 config.keyCodes
4. **移除**v-on.native 修饰符
   1. 父组件中绑定事件
   ```html
   <my-component
     v-on:myClose="handleComponentClose"
     v-on:click="handleNativeClickEvent"
   />
   ```
   2. 子组件中申明自定义事件
   ```js
   export default {
     emits: ["myClose"],
   };
   ```
5. **移除**过滤器（filter）
> 过滤器虽然这看起来很方便，但它需要一个自定义语法，打破大括号内表达式是“只是 JavaScript”的假设，这不仅有学习成本，而且有实现成本，建议用方法调用或计算属性去替换过滤器