# Vue3Basic

**Repository Path**: pyds/vue3-basic

## Basic Information

- **Project Name**: Vue3Basic
- **Description**: Vue3基础练习笔记
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2022-04-14
- **Last Updated**: 2022-06-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Vue3快速上手
<div align="center">
    <img src="./static/img/OnePiece.png" width="200px">
</div>

## 1.Vue3简介
- 2020年9月18日，Vue.js发布3.0版本，代号：One Piece（海贼王）
- 耗时2年多、[2600+次提交](https://github.com/vuejs/core/commits/v3.0.0)、[30+个RFC](https://github.com/vuejs/rfcs/tree/master/active-rfcs)、[600+次PR](https://github.com/vuejs/core/pulls?q=is%3Apr+is%3Amerged+-author%3Aapp%2Fdependabot-preview+)、[99位贡献者](https://github.com/vuejs/core/graphs/contributors)
- github上tag地址: https://github.com/vuejs/core/releases/tag/v3.0.0


## 2.Vue3带来了什么
### 2.1 性能提升
- 打包大小减少41%
- 初次渲染快55%，更新渲染快133%
- 内存减少54%
......

### 2.2 源码升级
- 使用Proxy代替defineProperty实现响应式
- 重写虚拟DOM的实现和[Tree-Shaking(名词: 树摇)](https://developer.mozilla.org/zh-CN/search?q=Tree-Shaking)
......

### 2.3 拥抱TypeScript
- Vue3可以更好的支持TypeScript

### 2.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
```js
## 查看 @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://cn.vitejs.dev
- 什么是vite —— 新一代前端构建工具
- 优势如下:
    - 开发环境中，无需打包操作，可快速冷启动。
    - 轻量快速的热重载（HMR）。
    - 真正的按需编译，不在等待整个应用编译完成。
- 传统构建与vite构建对比图
<div>
    <img src="./static/img/bundler.png" width="400px" height="250px">
    <img src="./static/img/esm.png" width="400px" height="250px">
</div>

```js
## 创建工程
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是所有<font color="orange">Composition API（组合API）</font>“表演的舞台”。
3. 组件中所用到的: 数据、方法等均要配置在setup中。
4. setup函数两种返回值:
    - 若返回一个对象，则对象中的属性、方法，在模板中均可以直接使用。（重点关注）
    - <font color="lightgray">若返回一个渲染函数: 则可以自定义渲染内容。（了解）</font>
5. 注意点:
    - 尽量不要与Vue2.x配置混用
        - Vue2.x配置（data、methods、computed...）中<font color="orange">可以访问到</font>setup中的属性、方法。
        - 但在setup中<font color="orange">不能访问到</font>Vue2.x配置（data、methods、computed...）。
        - 如果有重名，setup优先。
    - setup不能是一个async函数，因为返回值不再是return的对象，而是promise，模板看不到return对象中的属性。(后期也可以返回一个Promise实例，但需要Suspense和异步组件的配合)

## 2.ref函数
- 作用: 定义一个响应式的数据
- 语法: `const xxx = ref(initValue)` or `let xxx = ref(initValue)`
    - 创建一个包含响应式数据的<font color="orange">引用对象（reference对象，简称ref对象）</font>
    - JS中操作数据: `xxx.value`
    - 模板中读取数据不需要使用`.value`，直接: `<div>{{ xxx }}</div>`
- 备注:
    - 接收到数据可以是: 基本类型、也可以是对象类型。
    - 基本类型的数据: 响应式依然是靠`Object.defineProperty()`的`get`与`set`完成的。
    - 对象类型的数据: 内部“求助”了Vue3中的一个新函数——`reactive`函数。

## 3.reactive函数
- 作用: 定义一个<font color="orange">对象类型</font>的响应式数据（基本类型别用它，用ref函数）
- 语法: `const 代理对象 = reactive(源对象)`接收一个对象（或数组）返回一个<font color="orange">代理对象（Proxy的实例对象，简称proxy对象）</font>
- reactive定义的响应式数据是“深层次的”。
- 内部基于ES6的Proxy实现，通过代理对象操作源对象内部数据进行操作。

## 4.Vue3.0中的响应式原理
### Vue2.x的响应式
- 实现原理：
    - 对象类型: 通过`Object.defineProperty()`对属性的读取、修改进行拦截（数据劫持）。
    - 数组类型: 通过重写更新数据的一系列方法来实现拦截（对数组的变更方法进行了包裹）。
        ```js
        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

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

            proxy.name = "Tom"
            ```

## 5.reactive对比ref
- 从定义数据角度对比:
    - ref用来定义：<font color="orange">基本类型数据</font>。
    - reactive用来定义：<font color="orange">对象（或数组）类型数据</font>。
    - 备注：ref也可以用来定义<font color="orange">对象（或数组）类型数据</font>，它内部会自动通过`reactive`转为<font color="orange">代理对象</font>

- 从原理角度对比:
    - ref通过`Object.defineProperty()`的`get`与`set`来实现响应式（数据劫持）。
    - reactive通过使用<font color="orange">Proxy</font>来实现响应式（数据劫持），并通过<font color="orange">Reflect</font>操作<font color="redyellow">源对象</font>内部的数据。

- 从使用角度对比:
    - ref定义的数据：操作数据<font color="orange">需要</font>`.value`,读取数据模板时模板中直接读取<font color="orange">不需要</font>`.value`
    - reactive定义的数据：操作数据与读取数据均<font color="orange">不需要</font>`.value`

## 6.setup的两个注意点
- setup执行的时机：
    - 在beforeCreate之前执行一次，this是`undefined`。
- setup的参数：
    - props: 值为对象，包含：组件外部传递过来，且组件内部声明接收了的属性。
    - context: 上下文对象
        - attrs: 值为对象，包含：组件外部传递过来，但没有在props配置中声明的属性，相当与`this.$attrs`。
        - slots: 收到的插槽内容，相当于`this.$slots`。
        - emit: 分发自定义事件的函数,相当于`this.$emit`。

## 7.计算属性与监视
1. computed函数
    - 与Vue2.x中computed配置功能一致
    - 写法
        ```js
        import { computed } from 'vue'

        export default {
            name: 'xxx',
            setup() {
                ......
                // 计算属性——简写
                let fullName = computed(() => {
                    return person.firstName + "-" + person.lastName
                })

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

2. watch函数
    - 与Vue2.x中watch配置功能一致
    - 两个小“坑”:
        - 监视reactive定义的响应式数据时: 
            - oldValue无法正确获取；
            - 强制开启深度监视（deep配置失效）
        - 监视reactive定义的响应式数据中某个属性时: deep配置有效。
        ```js
        // 情况一：监视ref所定义的一个响应式数据
        watch(sum, (newValue, oldValue) => {
          console.log("sum变了", newValue, oldValue);
        }, {immediate: true})

        // 情况二：监视ref所定义的多个响应式数据
        watch([sum, msg], (newValue, oldValue) => {
          console.log("sum或msg变了", newValue, oldValue);
        }, {immediate: true})

        // 情况三：监视reactive所定义的一个响应式数据的全部属性（生产开发可以用）
        //    1、注意：此处无法正确的获取oldValue
        //    2、注意：强制开启了深度监视（deep配置无效）
        watch(person, (newValue, oldValue) => {
          console.log("person变化了", newValue, oldValue);
        }, {deep: false})  // 此处的deep配置无效

        // 情况四：监视reactive所定义的一个响应式数据中的某个属性
        watch(() => person.name, (newValue, oldValue) => {
          console.log("person的name变化了", newValue, oldValue);
        })

        // 情况五：监视reactive所定义的一个响应式数据中的某些属性
        watch([() => person.name, () => person.age], (newValue, oldValue) => {
          console.log("person的name或age变化了", newValue, oldValue);
        })

        // 特殊情况
        watch(() => person.job, (newValue, oldValue) => {
          console.log("person的job变化了", newValue, oldValue);
        }, {deep: true})  // 此处由于监视的是reactive所定义的对象中的某个属性，所以deep配置有效，但oldValue任然无法获取
        ```

3. watchEffect函数
    - watch的套路是：既要指明监视的属性，也要指明监视的回调。
    - watchEffect的套路是：不用指明监视哪个属性，监视的回调中用到哪个属性，那就监视哪个属性。
    - watchEffect有点像computed：
        - 但computed注重计算出来的值（回调函数的返回值），所以必须要写返回值。
        - 而watchEffect更注重的是过程（回调函数的函数体），所以不用写返回值。
        ```js
        // watchEffect所指定的回调中用到的数据只要发生变化，则重新执行回调。
        watchEffect(() => {
            const x1 = sum.value
            const x2 = person.age
            console.log("watchEffect配置的回调执行了")
        })
        ```

## 8.生命周期
<div style="display: flex;">
    <div style="border: 2px solid black;">
        <span>Vue2.x的生命周期</span>
        <img src="./static/img/vue2-lifecycle.png" width="400px">
    </div>
    <div style="border: 2px solid black;margin-left: 20px;">
        <span>Vue3.0的生命周期</span>
        <img src="./static/img/vue3-lifecycle.svg" width="400px">
    </div>
</div>

- Vue3.0可以继续使用Vue2.x中的生命周期钩子，但有两个被更名：
    - `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中的逻辑更清楚易懂。

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


# 三、其它Composition API

## 1.shallowReactive 与 shallowRef
- shallowReactive只处理对象最外层属性的响应式（浅响应式）。
- shallowRef只处理基本数据类型的响应式，不进行对象的响应式处理。
- 什么时候使用？
    - 如果有个对象数据，结构比较深，但变化时只是最外层属性变化 ===> shallowReactive 。
    - 如果有个对象数据，后续功能不会修改该对象中的属性，而是生成新的对象来替换 ===> shallowReactive 。

## 2.readonly与shallowReadonly
- readonly：让响应式数据变成只读的（深只读）。
- shallowReadonly：让响应式数据变成只读的（浅只读）。
- 应用场景：不希望数据被修改时。

## 3.toRaw与markRaw
- toRaw：
    - 作用：将一个由`reactive`生成的<font color="orange">响应式对象</font>转为<font color="orange">普通对象</font>。
    - 使用场景：用于读取响应式对象对应的普通对象，对这个普通对象的所有操作，不会引起页面更新。
- markRaw：
    - 作用：标记一个对象，使其永远不会再成为响应式对象。
    - 应用场景：
        - 有些值不应该被设置为响应式的，例如复杂的第三方类库等。
        - 当渲染具有不可变数据源的大列表时，跳过响应式转换可以提高性能。

## 4.customRef
- 作用：创建一个自定义的ref，并对其依赖项跟踪和更新触发进行显示控制。
- 实现防抖效果：
    ```html
    <template>
    <input type="text" v-model="keyWord">
    <h3>{{ keyWord }}</h3>
    </template>

    <script>

    import { ref, customRef } from 'vue'

    export default {
        name: 'App',
        setup() {
            function myRef(value, delay) {
                let timer;
                return customRef((track, trigger) => {
                    return {
                        get() {
                            console.log(`有人从myRef容器中读取了数据: ${value}`);
                            track();
                            return value
                        },
                        set(newValue) {
                            console.log(`有人把myRef容器中数据改为了: ${newValue}`);
                            clearTimeout(timer)
                            timer = setTimeout(() => {
                                value = newValue;
                                trigger();
                            }, delay)
                        },
                    }
                })
            }

            // let keyWord = ref("Hello")
            let keyWord = myRef("Hello", 500)

            return { keyWord }
        }
    }
    </script>
    ```

## 5.provide与inject
<div align="center">
    <img src="./static/img/components_provide.png" width="300px">
</div>

- 作用：实现<strong style="color: orange">祖与后代组件</strong>间通信
- 套路: 父组件有一个`provide`选项来提供数据，后代组件有一个`inject`选项来开始使用这些数据
- 具体写法：
    1. 祖组件中：
        ```js
        setup() {
            ......
            let car = reactive({name: "宝马", price: "100W"})
            provide("car", car)
            ......
        }
        ```

    2. 后代组件中：
        ```js
        setup() {
            ......
            const car = inject("car")
            return { car, ... }
        }
        ```

## 6.响应式数据的判断
- isRef：检查一个值是否为一个ref对象
- isReactive：检查一个对象是否由`reactive`创建的响应式代理
- isReadonly：检查一个对象是否由`readonly`创建的只读代理
- isProxy：检查一个对象是否是由`reactive`或`readonly`方法创建的代理


# 四、Composition API的优势

## 1.Options(配置式) API存在的问题
使用传统Options API中，新增或者修改一个需求，就需要分别在data、methods、computed等中修改
<div style="width:600px;height:370px;overflow:hidden;float:left;margin-right: 5px;">
    <img src="https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/f84e4e2c02424d9a99862ade0a2e4114~tplv-k3u1fbpfcp-watermark.image" style="width:600px;float:left" />
</div>
<div style="width:300px;height:370px;overflow:hidden;">
    <img src="https://p9-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/e5ac7e20d1784887a826f6360768a368~tplv-k3u1fbpfcp-watermark.image" style="zoom:50%;width:560px;left" /> 
</div>


## 2.Composition API的优势
我们可以更加优雅的组织我们的代码，函数。让相关功能的代码更加有序的组织在一起。
<div style="width:500px;height:340px;overflow:hidden;float:left">
    <img src="https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/bc0be8211fc54b6c941c036791ba4efe~tplv-k3u1fbpfcp-watermark.image"style="height:360px"/>
</div>
<div style="width:430px;height:340px;overflow:hidden;">
    <img src="https://p9-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/6cc55165c0e34069a75fe36f8712eb80~tplv-k3u1fbpfcp-watermark.image"style="height:360px"/>
</div>



# 五、新的组件

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

## 2.Teleport（传送）
- 什么是Teleport？—— `Teleport`是一种能够将我们的<strong style="color: orange">组件HTML结构</strong>移动到指定位置的技术。
    ```html
    <teleport to="移动位置">
        <div v-if="isShow" class="mask">
            <div class="dialog">
                <h3>我是一个弹窗</h3>
                ......
                <button @click="isShow=false"></button>
            </div>
        </div>
    </teleport>
    ```

## 3.Suspense
- 等待异步组件时渲染一些额外内容，让应用有更好的用户体验
- 使用步骤：
    - 异步引入组件
        ```js
        import { defineAsyncComponent } from 'vue'
        const Child = defineAsyncComponent(() => import('./components/Child'))  // 异步（动态）引入
        ```

    - 使用Suspense包裹组件，并配置好`default`和`fallback`插槽
        ```html
        <template>
            <div class="app">
                <h3>我是App组件</h3>
                <Suspense>
                    <template v-slot:default>
                        <Child />
                    </template>
                    <template v-slot:fallback>
                        <h3>稍等，加载中......</h3>
                    </template>
                </Suspense>
            </div>
        </template>
        ```


# 六、其它

## 1.全局API的转移
- Vue2.x有许多全局API和配置
    - 例如：注册全局组件、注册全局指令等。
        ```js
        // 注册全局组件
        Vue.component('MyButton', {
            data: () => ({ 
                count: 0 
            }),
            template: `<button @click="count++">Clicked  {{ count }} times.</button>`
        })

        // 注册全局指令
        Vue.directive('focus', {
            inserted: el => el.focus()
        })

        ```

- Vue3.0中对这些API做出了调整：
    - 将全局的API，即：`Vue.xxx`调整到应用实例`app`上

    | 2.x全局API(`Vue`)          | 3.x实例API（app）           |
    | ------------------------  | --------------------------- |
    | Vue.config.xxx            | app.config.xxx              |
    | Vue.config.productionTip  | <strong style="color: orange">移除</strong>                                               |
    | Vue.component             | app.component               |
    | Vue.directive             | app.directive               |
    | Vue.mixin                 | app.mixin                   |
    | Vue.use                   | app.use                     |
    | Vue.prototype             | app.config.globalProperties |


## 2.其它改变
- data选项始终被声明为一个函数
- 过度类名的更改：
    - Vue2.x写法
        ```css
        .v-enter, .v-leave-to {
            opacity: 0;
        }
        .v-leave, .v-enter-to {
            opacity: 1;
        }
        ```

    - Vue3.x写法
        ```css
        .v-enter-from, .v-leave-to {
            opacity: 0;
        }
        .v-leave-from, .v-enter-to {
            opacity: 1;
        }
        ```
- <strong style="color: orange">移除</strong> keyCode作为v-on的修饰符，同时也不在支持config.keyCodes
- <strong style="color: orange">移除</strong> `v-on.native` 修饰符
    - 父组件中绑定事件
        ```html
        <my-component 
            v-on:close="handleComponentEvent"
            v-on:click="handleNativeClickEvent"
        />
        ```
    - 子组件(my-component)中声明自定义事件
        ```js
        <script>
            export default {
                emits: ['close']  // 没有在此处声明的为原生事件
            }
        </script>
        ```
- <strong style="color: orange">移除</strong> 过滤器（filter）

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

- ......