# vue3

**Repository Path**: moringtoday/vue3

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-06-11
- **Last Updated**: 2024-12-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: vue3, TypeScript

## README

# vue3快速入门

> 推荐使用`vite`创建项目

```shell
## 查看@vue/cli版本，确保@vue/cli版本在4.5.0以上
vue --version

## 安装或者升级你的@vue/cli 
npm install -g @vue/cli

## 执行创建命令
vue create vue_test

##  随后选择3.x
##  Choose a version of Vue.js that you want to start the project with (Use arrow keys)
##  > 3.x
##    2.x

## 启动
cd vue_test
npm run serve
```

## 基础知识

await只能等待成功的返回值，如果遇到服务器异常或者失败的情况可以使用`try catch`或者使用`拦截器`

```js
async function addDog() {
  try {
    let result = await axios.get("https://dog222.ceo/api/breed/pembroke/images/random");
    dogList.push(result.data.message);
  } catch (err) {
    alert(err);
  }
}
```









## 基于`vite`创建项目

`vite` 是新一代前端构建工具，官网地址：[https://vitejs.cn](https://vitejs.cn/)，`vite`的优势如下：

- 轻量快速的热重载（`HMR`），能实现极速的服务启动。
- 对 `TypeScript`、`JSX`、`CSS` 等支持开箱即用。
- 真正的按需编译，不再等待整个应用编译完成。
- `webpack`构建 与 `vite`构建对比图如下：
<img src="images/1683167182037-71c78210-8217-4e7d-9a83-e463035efbbe.png" alt="webpack构建" title="webpack构建" style="zoom:20%;box-shadow:0 0 10px black" />	<img src="images/1683167204081-582dc237-72bc-499e-9589-2cdfd452e62f.png" alt="vite构建" title="vite构建" style="zoom: 20%;box-shadow:0 0 10px black" />
* 具体操作如下（点击查看[官方文档](https://cn.vuejs.org/guide/quick-start.html#creating-a-vue-application)）

```powershell
## 1.创建命令
npm create vue@latest

## 2.具体配置
## 配置项目名称
√ Project name: vue3_test
## 是否添加TypeScript支持
√ Add TypeScript?  Yes
## 是否添加JSX支持
√ Add JSX Support?  No
## 是否添加路由环境
√ Add Vue Router for Single Page Application development?  No
## 是否添加pinia环境
√ Add Pinia for state management?  No
## 是否添加单元测试
√ Add Vitest for Unit Testing?  No
## 是否添加端到端测试方案
√ Add an End-to-End Testing Solution? » No
## 是否添加ESLint语法检查
√ Add ESLint for code quality?  Yes
## 是否添加Prettiert代码格式化
√ Add Prettier for code formatting?  No
```

## 文件简介

> env.d.ts
```txt
让ts认识jpg，mp4等文件的配置
```

> index.html
```txt
入口文件 
vue2中的入口文件是main.js
```

> vite.config.ts
```txt
整个项目的配置文件，可以配置跨域等，
```

> src-main.ts

```ts
import './assets/main.css'
// createApp创建应用
import { createApp } from 'vue'
// APP就是个组件  根级文件
import App from './App.vue'
// 挂载这个组件
createApp(App).mount('#app')
```

```vue
<template>
  <div id="app">
    <h1>nihao </h1>
  </div>

</template>
<script lang="ts">

export default {
  name:'App'
};
</script>
<style>
#app{
  background-color: red;
  width: 100px;
  height: 100px;
}

</style>
```

## 简单使用`setup`

> setup函数执行的顺序在最前面 beforeCreate还快
>
> setup函数也可以渲染一个返回函数,这时，页面上只会渲染返回的内容

```vue
<script lang="ts">
export default {
  
  name: 'Person',
  setup() {
    // 数据
    let name = '张三';
    let age = 18;
    let tel = '3242342423432';
    // 方法
    function changeName(){
      name = 'zhangsan'
    }
    function changeAge(){
      age+=1
    }
    function btn(){
      alert(tel)
    }



    return () => '哈哈'
  },
}
</script>

```

- app.vue

```vue
<template>
  <Person />
</template>
<script lang="ts">
import Person from './components/Person.vue';
export default {
  name: 'App',
  components: {
    Person
  }
};
</script>
<style>
#app {
  background-color: red;
  width: 300px;
  height: 100px;
}
</style>
```

- components-Person.vue

```vue
<template>
  <div class="person_wrap">
    <h2>姓名:{{ name }}</h2>
    <h2>年龄:{{ age }}</h2>
    <button @click="changeName">修改名字</button>
    <button @click="changeAge">修改年龄</button>
    <button @click="btn">查看联系方式</button>
  </div>
</template>

<script lang="ts">
export default {
  
  name: 'Person',
  setup() {
    // 数据
    let name = '张三';
    let age = 18;
    let tel = '3242342423432';
    // 方法
    function changeName(){
      name = 'zhangsan'
    }
    function changeAge(){
      age+=1
    }
    function btn(){
      alert(tel)
    }



    return { name, age,changeName, changeAge,btn}
  },
}
</script>

<style scoped>
.person_wrap {
  background-color: skyblue;
  width: 300px;
  height: 100px;
}
</style>
```

## 面试题

- 原来的写法是能读取新写法的数据，但新写法不能读取旧写法的数据的
- `setup`可以和`data&methods`同时存在

## setup语法糖

> 组件中需要写名字，但是setup语法糖里面写不了name属性，有两种方法可以实现
>
> - 组件文件名就写成对应的组件名
>
> - 安装下面的插件可以实现

```shell
npm i vite-plugin-vue-setup-extend -D
```

在`vite.config.ts`中配置插件

```ts
import { fileURLToPath, URL } from 'node:url'

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'

// 引入插件命名插件
import VueSetupExtend from 'vite-plugin-vue-setup-extend';
// https://vitejs.dev/config/
export default defineConfig({
  plugins: [
    vue(),
    VueSetupExtend() // 使用
  ],
  resolve: {
    alias: {
      '@': fileURLToPath(new URL('./src', import.meta.url))
    }
  }
})
```

在组件中的`script`中写`name`

> <script lang="ts" setup name="Person">

```vue
<template>
  <div class="person_wrap">
    <h2>姓名:{{ name }}</h2>
    <h2>年龄:{{ age }}</h2>
    <button @click="changeName">修改名字</button>
    <button @click="changeAge">修改年龄</button>
    <button @click="btn">查看联系方式</button>
  </div>
</template>

<script lang="ts" setup name="Person">
// 数据
let name = '张三';
let age = 18;
let tel = '3242342423432';
// 方法
function changeName() {
  name = 'zhangsan'
}
function changeAge() {
  age += 1
}
function btn() {
  alert(tel)
}
</script>

<style scoped>
.person_wrap {
  background-color: skyblue;
  width: 300px;
  height: 100px;
}
</style>
```

## ref和reactive响应式数据

### ref

#### 【ref 创建：基本类型的响应式数据】

- **作用：**定义响应式变量。
- **语法：**`let xxx = ref(初始值)`。
- **返回值：**一个`RefImpl`的实例对象，简称`ref对象`或`ref`，`ref`对象的`value`**属性是响应式的**。
- **注意点：**
  - `JS`中操作数据需要：`xxx.value`，但模板中不需要`.value`，直接使用即可。
  - 对于`let name = ref('张三')`来说，`name`不是响应式的，`name.value`是响应式的。

```vue
<template>
  <div class="person_wrap">
    <h2>姓名:{{ name }}</h2>
    <h2>年龄:{{ age }}</h2>
    <button @click="changeName">修改名字</button>
    <button @click="changeAge">修改年龄</button>
    <button @click="btn">查看联系方式</button>
  </div>
</template>

<script lang="ts" setup name="Person">
import { ref } from 'vue';

// 数据
let name = ref('张三');
let age = ref(10);
let tel = '3242342423432';
// 方法
function changeName() {
  name.value = 'zhangsan'
}
function changeAge() {
  age.value += 1
}
function btn() {
  alert(tel)
}

</script>

<style scoped>
.person_wrap {
  background-color: skyblue;
  width: 300px;
  height: 100px;
}
</style>
```

#### 【ref 创建：对象类型的响应式数据】

- 其实`ref`接收的数据可以是：**基本类型**、**对象类型**。
- 若`ref`接收的是对象类型，内部其实也是调用了`reactive`函数。

```vue
<template>
  <div class="person">
    <h2>汽车信息：一台{{ car.brand }}汽车，价值{{ car.price }}万</h2>
    <h2>游戏列表：</h2>
    <ul>
      <li v-for="g in games" :key="g.id">{{ g.name }}</li>
    </ul>
    <h2>测试：{{obj.a.b.c.d}}</h2>
    <button @click="changeCarPrice">修改汽车价格</button>
    <button @click="changeFirstGame">修改第一游戏</button>
    <button @click="test">测试</button>
  </div>
</template>

<script lang="ts" setup name="Person">
import { ref } from 'vue'

// 数据
let car = ref({ brand: '奔驰', price: 100 })
let games = ref([
  { id: 'ahsgdyfa01', name: '英雄联盟' },
  { id: 'ahsgdyfa02', name: '王者荣耀' },
  { id: 'ahsgdyfa03', name: '原神' }
])
let obj = ref({
  a:{
    b:{
      c:{
        d:666
      }
    }
  }
})

console.log(car)

function changeCarPrice() {
  car.value.price += 10
}
function changeFirstGame() {
  games.value[0].name = '流星蝴蝶剑'
}
function test(){
  obj.value.a.b.c.d = 999
}
</script>
```

### reactive 

#### 【reactive 只能创建：对象类型的响应式数据】

- **作用：**定义一个**响应式对象**（基本类型不要用它，要用`ref`，否则报错）
- **语法：**`let 响应式对象= reactive(源对象)`。
- **返回值：**一个`Proxy`的实例对象，简称：响应式对象。
- **注意点：**`reactive`定义的响应式数据是“深层次”的。

```vue
<template>
  <div class="person">
    <h2>汽车信息：一台{{ car.brand }}汽车，价值{{ car.price }}万</h2>
    <h2>游戏列表：</h2>
    <ul>
      <li v-for="g in games" :key="g.id">{{ g.name }}</li>
    </ul>
    <h2>测试：{{obj.a.b.c.d}}</h2>
    <button @click="changeCarPrice">修改汽车价格</button>
    <button @click="changeFirstGame">修改第一游戏</button>
    <button @click="test">测试</button>
  </div>
</template>

<script lang="ts" setup name="Person">
import { reactive } from 'vue'

// 数据
let car = reactive({ brand: '奔驰', price: 100 })
let games = reactive([
  { id: 'ahsgdyfa01', name: '英雄联盟' },
  { id: 'ahsgdyfa02', name: '王者荣耀' },
  { id: 'ahsgdyfa03', name: '原神' }
])
let obj = reactive({
  a:{
    b:{
      c:{
        d:666
      }
    }
  }
})

function changeCarPrice() {
  car.price += 10
}
function changeFirstGame() {
  games[0].name = '流星蝴蝶剑'
}
function test(){
  obj.a.b.c.d = 999
}
</script>
```

<font color='red' size='5'> ref定义对象的时候，底层还是使用reactive定义的</font>

### ref 对比 reactive

宏观角度看：

> 1. `ref`用来定义：**基本类型数据**、**对象类型数据**；
>
> 2. `reactive`用来定义：**对象类型数据**。

- 区别：

> 1. `ref`创建的变量必须使用`.value`（可以使用`volar`插件自动添加`.value`）。
>
>    <img src="images/autoValue.png" alt="自动补充value" style="zoom:50%;border-radius:20px" /> 
>
> 2. `reactive`重新分配一个新对象，会**失去**响应式（可以使用`Object.assign`去整体替换）。

```vue

<script lang="ts" setup name="Person">
import { ref,reactive } from 'vue'

// 数据
let car = reactive({ brand: '奔驰', price: 100 })

function changeCar(){
  // 这样写是不行的，这样写的话相当于给car断开前面的指向，重新分配了一个新的指向
    car = reactive({ brand: 'baoma', price: 200 })
  // 使用Object.assign
    Object.assign(car,{brand: 'baoma', price: 200})
}
</script>
```

- 使用原则：

> 1. 若需要一个基本类型的响应式数据，必须使用`ref`。
> 2. 若需要一个响应式对象，层级不深，`ref`、`reactive`都可以。
> 3. 若需要一个响应式对象，且层级较深，推荐使用`reactive`。

### toRefs 与 toRef

>通过toRefs将person对象中的n个属性批量取出，且依然保持响应式的能力
>
>通过toRef将person对象中的gender属性取出，且依然保持响应式的能力

- 作用：将一个响应式对象中的每一个属性，转换为`ref`对象。
- 备注：`toRefs`与`toRef`功能一致，但`toRefs`可以批量转换。
- 语法如下：

```vue
<template>
  <div class="person">
    <h2>姓名:{{ name1 }}</h2>
    <h2>年龄:{{ age }}</h2>
    <h2>年龄nl:{{ nl }}</h2>
    <button @click="changeName">修改名字</button>
    <button @click="changeAge">修改年龄</button>
  </div>
</template>

<script lang="ts" setup name="Person">
import { reactive, ref, toRefs, toRef } from 'vue';

let person = reactive({
  name: "张三",
  age: 10,
})

// 从一个响应式对象身上结构出东西不是响应式的
let { name, age } = toRefs(person);

let pser = ref({
  name1: "张三",
  age2: 10,
})

let { name1 } = toRefs(pser.value);
let nl = toRef(person,'age')


function changeName() {
  name.value += '~'
  name1.value += '~';
  nl.value+=2
}

function changeAge() {
  age.value += 1
}

</script>

<style>
.person {
  width: 100%;
  background-color: skyblue;
}
</style>
```

### computed

作用：根据已有数据计算出新数据（和`Vue2`中的`computed`作用一致）。有`缓存`,方法有`缓存`

```vue
<template>
  <div class="person">
    姓：<input type="text" name="" id="" v-model="firstName" /><br />
    名：<input type="text" name="" id="" v-model="lastName" /><br />
    全名<span>{{ fullName }}</span>
    <button @click="changeFullName">全名改为：li-si</button>
  </div>
</template>

<script lang="ts" setup name="Person">
import { reactive, ref, toRefs, toRef, computed } from 'vue';

let firstName = ref('');
let lastName = ref('');

// 计算属性 -- 只读
// fullName是ref定义的数据
// let fullName = computed(() => {
//   return firstName.value.slice(0, 1).toUpperCase() + firstName.value.slice(1) + '-' + lastName.value
// })

// 有get必须有set
let fullName = computed({
  get() {
    return firstName.value.slice(0, 1).toUpperCase() + firstName.value.slice(1) + '-' + lastName.value
  },
  set(val) {
    console.log('有人修改了fullName', val)
    firstName.value = val.split('-')[0]
    lastName.value = val.split('-')[1]
  }
})

function changeFullName() {
  fullName.value = 'li-si'
}

</script>

<style>
.person {
  width: 100%;
  background-color: skyblue;
}
</style>
```

### watch

- 作用：监视数据的变化（和`Vue2`中的`watch`作用一致）
- 特点：`Vue3`中的`watch`只能监视以下**四种数据**：

> 1. `ref`定义的数据。
> 2. `reactive`定义的数据。
> 3. 函数返回一个值（`getter`函数）。
> 4. 一个包含上述内容组成的数组。

我们在`Vue3`中使用`watch`的时候，通常会遇到以下几种情况：

#### 情况一

监视`ref`定义的【基本类型】数据：直接写数据名即可，监视的是其`value`值的改变。

*watch的返回值可以停止监视*

```vue
<template>
  <div class="person">
    <h2>当前求和为：{{ sum }}</h2>
    <button @click="changeSum">点击加1</button>
  </div>
</template>

<script lang="ts" setup name="Person">
import { ref, watch } from 'vue';
let sum = ref(0)

function changeSum() {
  sum.value += 1
}

//  watch(监视谁？，回调函数（新值，旧值）)
const stopWatch = watch(sum, (newVlaue, oldValue) => {
  console.log('sum变化了', newVlaue, oldValue)
  if (sum.value > 10) {
    stopWatch()
  }
})
</script>

<style>
.person {
  width: 100%;
  background-color: skyblue;
}
</style>
```

#### 情况二

监视`ref`定义的【对象类型】数据：直接写数据名，监视的是对象的【地址值】，若想监视对象内部的数据，要手动开启深度监视。

>注意：
>
>* 若修改的是`ref`定义的对象中的属性，`newValue` 和 `oldValue` 都是新值，因为它们是同一个对象。
>
>* 若修改整个`ref`定义的对象，`newValue` 是新值， `oldValue` 是旧值，因为不是同一个对象了。

```vue
<template>
  <div class="person">
    <h1>情况二：监视【ref】定义的【对象类型】数据</h1>
    <h2>姓名：{{ person.name }}</h2>
    <h2>年龄：{{ person.age }}</h2>
    <button @click="changeName">修改名字</button>
    <button @click="changeAge">修改年龄</button>
    <button @click="changePerson">修改整个人</button>
  </div>
</template>

<script lang="ts" setup name="Person">
  import {ref,watch} from 'vue'
  // 数据
  let person = ref({
    name:'张三',
    age:18
  })
  // 方法
  function changeName(){
    person.value.name += '~'
  }
  function changeAge(){
    person.value.age += 1
  }
  function changePerson(){
    person.value = {name:'李四',age:90}
  }
  /* 
    监视，情况一：监视【ref】定义的【对象类型】数据，监视的是对象的地址值，若想监视对象内部属性的变化，需要手动开启深度监视
    watch的第一个参数是：被监视的数据
    watch的第二个参数是：监视的回调a
    watch的第三个参数是：配置对象（deep、immediate等等.....） 
  */
  watch(person,(newValue,oldValue)=>{
    console.log('person变化了',newValue,oldValue)
  },{deep:true})
  
</script>
```

#### 情况三

监视`reactive`定义的【对象类型】数据，且默认开启了深度监视。`隐式的创建了深度监视，而且无法关闭`

```vue
<template>
  <div class="person">
    <h1>情况三：监视【reactive】定义的【对象类型】数据</h1>
    <h2>姓名：{{ person.name }}</h2>
    <h2>年龄：{{ person.age }}</h2>
    <button @click="changeName">修改名字</button>
    <button @click="changeAge">修改年龄</button>
    <button @click="changePerson">修改整个人</button>
    <hr>
    <h2>测试：{{obj.a.b.c}}</h2>
    <button @click="test">修改obj.a.b.c</button>
  </div>
</template>

<script lang="ts" setup name="Person">
  import {reactive,watch} from 'vue'
  // 数据
  let person = reactive({
    name:'张三',
    age:18
  })
  let obj = reactive({
    a:{
      b:{
        c:666
      }
    }
  })
  // 方法
  function changeName(){
    person.name += '~'
  }
  function changeAge(){
    person.age += 1
  }
  function changePerson(){
    Object.assign(person,{name:'李四',age:80})
  }
  function test(){
    obj.a.b.c = 888
  }

  // 监视，情况三：监视【reactive】定义的【对象类型】数据，且默认是开启深度监视的
  watch(person,(newValue,oldValue)=>{
    console.log('person变化了',newValue,oldValue)
  })
  watch(obj,(newValue,oldValue)=>{
    console.log('Obj变化了',newValue,oldValue)
  })
</script>
```

#### 情况四

监视`ref`或`reactive`定义的【对象类型】数据中的**某个属性**，注意点如下：

1. 若该属性值**不是**【对象类型】，需要写成`函数`形式。
2. 若该属性值是**依然**是【对象类型】，可直接编，也可写成函数，建议写成函数。

结论：监视的要是对象里的属性，那么最好写函数式，注意点：若是对象监视的是地址值，需要关注对象内部，需要手动开启深度监视。

```vue
<template>
  <div class="person">
    <h2>姓名:{{ person.name }}</h2>
    <h2>年龄:{{ person.age }}</h2>
    <h2>年龄:{{ person.age }}</h2>
    <h2>汽车:{{ person.car.c1 }}、{{ person.car.c2 }}</h2>
    <button @click="changeName">修改名字</button>
    <button @click="changeAge">修改年龄</button>
    <button @click="changeFirstCar">修改第一辆车</button>
    <button @click="changeTwoCar">修改第二辆车</button>
    <button @click="changeAllCar">修改整个车</button>
  </div>
</template>

<script lang="ts" setup name="Person">
import { ref, watch, reactive } from "vue";

let person = reactive({
  name: "张三",
  age: 20,
  car: {
    c1: "奔驰",
    c2: "宝马",
  },
});

function changeName() {
  person.name = "zhangsan";
}
function changeAge() {
  person.age += 1;
}
function changePerson() {
  Object.assign(person, {
    name: "里斯",
    age: 90,
  });
}

function changeFirstCar() {
  person.car.c1 = "压低";
}

function changeTwoCar() {
  person.car.c2 = "压低2112";
}

function changeAllCar() {
  person.car = {
    c1: "呀低压",
    c2: "小刀",
  };
}

// 修改对象下的某一个属性，监视某一个属性， 使用一个getters函数（箭头函数）
// watch(
//   () => {
//     return person.name;
//   },
//   (newVal, oldVal) => {
//     console.log("person变换了", newVal, oldVal);
//   }
// );

// watch(
//   () => person.name,
//   (newVal, oldVal) => {
//     console.log("person变换了", newVal, oldVal);
//   }
// );

//
watch(
  () => person.car,
  (newVal, oldVal) => {
    console.log("person变换了", newVal, oldVal);
  },
  { deep: true }
);
</script>

<style>
.person {
  width: 100%;
  background-color: skyblue;
}
</style>

```

#### 情况五

监视上述的多个数据

```vue
<template>
  <div class="person">
    <h1>监视多个数据</h1>
    <h2>姓名:{{ person.name }}</h2>
    <h2>年龄:{{ person.age }}</h2>
    <h2>年龄:{{ person.age }}</h2>
    <h2>汽车:{{ person.car.c1 }}、{{ person.car.c2 }}</h2>
    <button @click="changeName">修改名字</button>
    <button @click="changeAge">修改年龄</button>
    <button @click="changeFirstCar">修改第一辆车</button>
    <button @click="changeTwoCar">修改第二辆车</button>
    <button @click="changeAllCar">修改整个车</button>
  </div>
</template>

<script lang="ts" setup name="Person">
import { ref, watch, reactive } from "vue";

let person = reactive({
  name: "张三",
  age: 20,
  car: {
    c1: "奔驰",
    c2: "宝马",
  },
});

function changeName() {
  person.name = "zhangsan";
}
function changeAge() {
  person.age += 1;
}
function changePerson() {
  Object.assign(person, {
    name: "里斯",
    age: 90,
  });
}

function changeFirstCar() {
  person.car.c1 = "压低";
}

function changeTwoCar() {
  person.car.c2 = "压低2112";
}

function changeAllCar() {
  person.car = {
    c1: "呀低压",
    c2: "小刀",
  };
}

// 监视多个数据
watch(
  [() => person.name, () => person.car.c1, person.car],
  (newVal, oldVal) => {
    console.log("person变换了", newVal, oldVal);
  },
  { deep: true }
);
</script>

<style>
.person {
  width: 100%;
  background-color: skyblue;
}
</style>
```

### watchEffect

> 使用情况，当监视得东西特别多时，可以使用watchEffect进行监听

- 官网：立即运行一个函数，同时响应式地追踪其依赖，并在依赖更改时重新执行该函数。
- `watch`对比`watchEffect`
  - 都能监听响应式数据的变化，不同的是监听数据变化的方式不同
  - `watch`：要明确指出监视的数据
  - `watchEffect`：不用明确指出监视的数据（函数中用到哪些属性，那就监视哪些属性）。

```vue
<template>
  <div class="person">
    <h1>当水温达到60度，或水位达到80cm时，给服务器发请求</h1>
    <h2>当前水温:{{ temp }}摄氏度</h2>
    <h2>当前水位:{{ height }}cm</h2>
    <button @click="changeTemp">水温+10</button>
    <button @click="changeHeight">水位+10</button>
  </div>
</template>

<script lang="ts" setup name="Person">
import { ref, watch, watchEffect } from "vue";

let temp = ref(0);
let height = ref(0);

function changeTemp() {
  temp.value += 10;
}

function changeHeight() {
  height.value += 10;
}

// 使用watch
// watch([temp, height], (newVal) => {
//   let [newTemp, newHeight] = newVal;
//   if (newTemp >= 60 || newHeight >= 80) {
//     alert("发送请求");
//   }
// });

// watchEffect
watchEffect(() => {
  if (temp.value >= 60 || height.value >= 80) {
    alert("发送请求");
  }
});
</script>

<style>
.person {
  width: 100%;
  background-color: skyblue;
}
</style>

```

### ref在标签上的使用

>作用：用于注册模板引用。

* 用在普通`DOM`标签上，获取的是`DOM`节点。
* 用在组件标签上，获取的是组件实例对象。

用在普通`DOM`标签上

```vue
<template>
  <div class="person">
    <h2 ref="title2">中国</h2>
    <button @click="btn">点击输出</button>
  </div>
</template>

<script lang="ts" setup name="Person">
import { ref } from "vue";

// 创建和title2一样的ref,用于存储ref标记的内容

let title2 = ref();

function btn(){
  console.log(title2.value)
}

</script>

<style scoped>
.person {
  width: 100%;
  background-color: skyblue;
}
</style>
```

用在组件标签上：

```vue
<!-- 父组件App.vue -->
<template>
  <Person ref="ren"/>
  <button @click="test">测试</button>
</template>

<script lang="ts" setup name="App">
  import Person from './components/Person.vue'
  import {ref} from 'vue'

  let ren = ref()

  function test(){
    console.log(ren.value.name)
    console.log(ren.value.age)
  }
</script>


<!-- 子组件Person.vue中要使用defineExpose暴露内容 -->
<script lang="ts" setup name="Person">
  import {ref,defineExpose} from 'vue'
	// 数据
  let name = ref('张三')
  let age = ref(18)
  /****************************/
  /****************************/
  // 使用defineExpose将组件中的数据交给外部
  defineExpose({name,age})
</script>
```

### 简学TS接口，泛型，自定义类型

在vue文件中使用：

```vue
<template>
  <div class="person"></div>
</template>

<script lang="ts" setup name="Person">
import { ref, defineExpose } from "vue";
import {type PersonInter,type Persons } from "@/types";


let person: PersonInter = {
  id: "adada343ffd",
  name: "张三",
  age: 30,
};

let personList :Array<PersonInter>= [
  {
  id: "adada343ffd",
  name: "张三",
  age: 30,
},
{
  id: "adada343ffd",
  name: "张三",
  age: 30,
},
{
  id: "adada343ffd",
  name: "张三",
  age: 30,
}

]
</script>

<style scoped>
.person {
  width: 100%;
  background-color: skyblue;
}
</style>

```

创建限制的类型`src/types/index.ts`

```typescript
// 定义接口用于限制
export interface PersonInter {
    id:string,
    name:string,
    age:number
}

// 自定义类型
// export type Persons = Array<PersonInter>;
export type Persons = PersonInter[];
```

### props

使用`defineProps`接受，在vue3中`define`开头的函数不需要引入，是`宏函数`

index.ts

```typescript
// 定义接口用于限制
export interface PersonInter {
    id:string,
    name:string,
    age:number
}

// 自定义类型
// export type Persons = Array<PersonInter>;
export type Persons = PersonInter[];
```

app.vue - 父

```vue
<template>
  <Person a="哈哈" :list="personList" />
</template>
<script lang="ts" setup name="App">
import Person from "./components/Person.vue";
import {reactive } from "vue";
import {type Persons } from "@/types";

let personList = reactive<Persons>([
  {
  id: "a44da343ffd",
  name: "张三",
  age: 23,
},
{
  id: "adaed343ffd",
  name: "李四",
  age: 30,
},
{
  id: "adad3443ffd",
  name: "王五",
  age: 45,
  x:45
}
])
</script>
<style>
#app {
  width: 100%;
  background-color: red;
  min-height: 100px;
}
</style>
```

Person.vue - 子

```vue
<template>
  <div class="person">
    <h2>{{ a }}</h2>
    <ul>
      <li v-for="item in list" :key="item.id">{{ item.name }} -- {{ item.age }}</li>
    </ul>
  </div>
</template>

<script lang="ts" setup name="Person">
import { defineProps,withDefaults } from "vue";
import {type Persons } from "@/types";

// 接受a
// defineProps(['a'])
//  console.log(a)  // 报错，分不清是window还是传过来的

// 接收a，并保存a
// let x = defineProps(['a','list'])
// console.log(x.a)
// console.log(x)

// 接受a和list
// defineProps(['a','list'])

// 接受并限制
// defineProps<{a:string,list:Persons}>()

// 接受并限制+限制必要性和默认值
withDefaults(defineProps<{a:string,list?:Persons}>(),{
  a:'我哈哈',
  list:()=> [
    {  id: "a44da343ffd",
  name: "张三23324",
  age: 23,}
  ]
})
</script>

<style scoped>
.person {
  width: 100%;
  background-color: skyblue;
}
</style>
```

### 生命周期

* 概念：`Vue`组件实例在创建时要经历一系列的初始化步骤，在此过程中`Vue`会在合适的时机，调用特定的函数，从而让开发者有机会在特定阶段运行自己的代码，这些特定的函数统称为：生命周期钩子

* 规律：

  > 生命周期整体分为四个阶段，分别是：**创建、挂载、更新、销毁**，每个阶段都有两个钩子，一前一后。

* `Vue2`的生命周期

  > 创建阶段：`beforeCreate`、`created`
  >
  > 挂载阶段：`beforeMount`、`mounted`
  >
  > 更新阶段：`beforeUpdate`、`updated`
  >
  > 销毁阶段：`beforeDestroy`、`destroyed`

* `Vue3`的生命周期

  > 创建阶段：`setup`
  >
  > 挂载阶段：`onBeforeMount`、`onMounted`
  >
  > 更新阶段：`onBeforeUpdate`、`onUpdated`
  >
  > 卸载阶段：`onBeforeUnmount`、`onUnmounted`

父

```vue
<template>
  <Person v-if="isShow" />
</template>
<script lang="ts" setup name="App">
import Person from "./components/Person.vue";
import {
  ref,
  onMounted,
  onBeforeMount,
  onBeforeUpdate,
  onUpdated,
  onBeforeUnmount,
  onUnmounted,
} from "vue";

let isShow = ref(true);

// 创建
console.log("创建前和完毕,setup-父");
// 挂载
onBeforeMount(() => {
  console.log("挂载前,onBeforeMount-父");
});
onMounted(() => {
  console.log("挂载完毕,onMounted-父");
});

// 更新
onBeforeUpdate(() => {
  console.log("更新前,onBeforeUpdate-父");
});

onUpdated(() => {
  console.log("更新完毕,onUpdated-父");
});

// 卸载
onBeforeUnmount(() => {
  console.log("卸载前,onBeforeUnmount-父");
});
onUnmounted(() => {
  console.log("卸载完毕,onUnmounted-父");
});
</script>
<style>
#app {
  width: 100%;
  background-color: red;
  min-height: 100px;
}
</style>

```

子

```vue
<template>
  <div class="person">
    <h2>当前求和为：{{ sum }}</h2>
    <button @click="addSum">点击加1</button>
  </div>
</template>

<script lang="ts" setup name="Person">
import {
  ref,
  onMounted,
  onBeforeMount,
  onBeforeUpdate,
  onUpdated,
  onBeforeUnmount,
  onUnmounted,
} from "vue";

let sum = ref(0);

function addSum() {
  sum.value += 1;
}

// 创建
console.log("创建前和完毕,setup");
// 挂载
onBeforeMount(() => {
  console.log("挂载前,onBeforeMount");
});
onMounted(() => {
  console.log("挂载完毕,onMounted");
});

// 更新
onBeforeUpdate(() => {
  console.log("更新前,onBeforeUpdate");
});

onUpdated(() => {
  console.log("更新完毕,onUpdated");
});

// 卸载
onBeforeUnmount(() => {
  console.log("卸载前,onBeforeUnmount");
});
onUnmounted(() => {
  console.log("卸载完毕,onUnmounted");
});
</script>

<style scoped>
.person {
  width: 100%;
  background-color: skyblue;
}
</style>
```

组件更新步骤

- 创建前和完毕,setup-父
- 挂载前,onBeforeMount-父
-  创建前和完毕,setup
-  挂载前,onBeforeMount
- 挂载完毕,onMounted
-  挂载完毕,onMounted-父

常用的钩子：`onMounted`(挂载完毕)、`onUpdated`(更新完毕)、`onBeforeUnmount`(卸载之前)

### hooks

- 什么是`hook`？—— 本质是一个函数，把`setup`函数中使用的`Composition API`进行了封装，类似于`vue2.x`中的`mixin`。

- 自定义`hook`的优势：复用代码, 让`setup`中的逻辑更清楚易懂。

示例代码：

- `useSum.ts`中内容如下：

  ```js
  import {ref,onMounted} from 'vue'
  
  export default function(){
    let sum = ref(0)
  
    const increment = ()=>{
      sum.value += 1
    }
    const decrement = ()=>{
      sum.value -= 1
    }
    onMounted(()=>{
      increment()
    })
  
    //向外部暴露数据
    return {sum,increment,decrement}
  }		
  ```

- `useDog.ts`中内容如下：

  ```js
  import {reactive,onMounted} from 'vue'
  import axios,{AxiosError} from 'axios'
  
  export default function(){
    let dogList = reactive<string[]>([])
  
    // 方法
    async function getDog(){
      try {
        // 发请求
        let {data} = await axios.get('https://dog.ceo/api/breed/pembroke/images/random')
        // 维护数据
        dogList.push(data.message)
      } catch (error) {
        // 处理错误
        const err = <AxiosError>error
        console.log(err.message)
      }
    }
  
    // 挂载钩子
    onMounted(()=>{
      getDog()
    })
  	
    //向外部暴露数据
    return {dogList,getDog}
  }
  ```

- 组件中具体使用：

  ```vue
  <template>
    <h2>当前求和为：{{sum}}</h2>
    <button @click="increment">点我+1</button>
    <button @click="decrement">点我-1</button>
    <hr>
    <img v-for="(u,index) in dogList.urlList" :key="index" :src="(u as string)"> 
    <span v-show="dogList.isLoading">加载中......</span><br>
    <button @click="getDog">再来一只狗</button>
  </template>
  
  <script lang="ts">
    import {defineComponent} from 'vue'
  
    export default defineComponent({
      name:'App',
    })
  </script>
  
  <script setup lang="ts">
    import useSum from './hooks/useSum'
    import useDog from './hooks/useDog'
  	
    let {sum,increment,decrement} = useSum()
    let {dogList,getDog} = useDog()
  </script>
  ```

## 路由

### 路由基本切换

- 安装`router`
  ```bash
  npm i vue-router
  ```
- 配置路由
   - 创建`router`文件夹，创建`index.ts`文件，并创建对应的路由组件
  ```ts
    // 创建路由器，并暴露

  // 1. 引入createRouter
  import { createRouter ,createWebHashHistory} from 'vue-router';
   import Home from '@/components/Home.vue';
    import About from '@/components/About.vue';
    import News from '@/components/News.vue';
  
    // 2. 通过createRouter创建路由实例
    const router = createRouter({
        history:createWebHashHistory(), // 路由的工作模式
        // 3. 配置路由规则
        routes: [
            {
                path: '/home',
                component: Home,
            },
            {
                path: '/about',
                component: About,
            },
            {
                path: '/news',
                component: News,
            },
        ]
    });
  
    // 4. 暴露路由实例
    export default router;  
  ```
 - 在`main.ts`中引入路由
   ```ts
    import { createApp } from 'vue'
    import App from './App.vue'
    import router from './router'
    
    createApp(App).use(router).mount('#app')
   ```

`App.vue`

```vue
<template>
  <div class="app">
    <h2 class="title">Vue路由测试</h2>
    <!-- 导航区 -->
    <div class="navigate">
      <RouterLink to="/home" active-class="active">首页</RouterLink>
      <RouterLink to="/news" active-class="active">新闻</RouterLink>
      <RouterLink to="/about" active-class="active">关于</RouterLink>
    </div>
    <!-- 展示区 -->
    <div class="main-content">
      <RouterView></RouterView>
    </div>
  </div>
</template>

<script lang="ts" setup name="App">
  import {RouterLink,RouterView} from 'vue-router'  
</script>
```

### 两个注意点

> 1. 路由组件通常存放在`pages` 或 `views`文件夹，一般组件通常存放在`components`文件夹。
>
> 2. 通过点击导航，视觉效果上“消失” 了的路由组件，默认是被**卸载**掉的，需要的时候再去**挂载**。

### 路由器工作模式

1. `history`模式

   > 优点：`URL`更加美观，不带有`#`，更接近传统的网站`URL`。
   >
   > 缺点：后期项目上线，需要服务端配合处理路径问题，否则刷新会有`404`错误。
   >
   > ```js
   > const router = createRouter({
   >   	history:createWebHistory(), //history模式
   >   	/******/
   > })
   > ```

2. `hash`模式

   > 优点：兼容性更好，因为不需要服务器端处理路径。
   >
   > 缺点：`URL`带有`#`不太美观，且在`SEO`优化方面相对较差。
   >
   > ```js
   > const router = createRouter({
   >   	history:createWebHashHistory(), //hash模式
   >   	/******/
   > })
   > ```

### to的两种写法

```vue
<!-- 第一种：to的字符串写法 -->
<router-link active-class="active" to="/home">主页</router-link>

<!-- 第二种：to的对象写法 -->
<router-link active-class="active" :to="{path:'/home'}">Home</router-link>
```

### 命名路由

作用：可以简化路由跳转及传参

给路由规则命名：

```ts
// 创建路由器，并暴露

// 1. 引入createRouter
import { createRouter, createWebHashHistory } from 'vue-router';


import Home from '@/pages/Home.vue';
import About from '@/pages/About.vue';
import News from '@/pages/News.vue';

// 2. 通过createRouter创建路由实例
const router = createRouter({
    history: createWebHashHistory(), // 路由的工作模式
    // 3. 配置路由规则
    routes: [
        {
            name: "Home",
            path: '/home',
            component: Home,
        },
        {
            name: "About",
            path: '/about',
            component: About,
        },
        {
            name: "News",
            path: '/news',
            component: News,
        },
    ]
});

// 4. 暴露路由实例
export default router;  
```

### query参数

```vue
<template>
  <div class="news">
    <!-- 导航区 -->
    <ul>
      <li v-for="item in newList" :key="item.id">
        <!-- <RouterLink
          :to="`/news/detail?id=${item.id}&title=${item.title}&content=${item.content}`"
          >{{ item.title }}</RouterLink
        > -->

        <RouterLink
          :to="{
            name:'Detail',
            query:{
              id:item.id,
              title:item.title,
              content:item.content
            }
          }"
          >{{ item.title }}</RouterLink
        >
      </li>
    </ul>
    <!-- 展示区 -->
    <div class="news-content">
      <RouterView></RouterView>
    </div>
  </div>
</template>

<script setup lang="ts" name="News">
import { reactive } from "vue";
import { RouterView, RouterLink } from "vue-router";

const newList = reactive([
  {
    id: "qazwsx1",
    title: "新闻001",
    content: "新闻001的内容",
  },
  {
    id: "qazwsx2",
    title: "新闻002",
    content: "新闻002的内容",
  },
  {
    id: "qazwsx3",
    title: "新闻003",
    content: "新闻003的内容",
  },
  {
    id: "qazwsx4",
    title: "新闻004",
    content: "新闻004的内容",
  },
]);
</script>
```

`Detail.vue`

```vue
<template>
  <ul class="news-list">
    <li>编号：{{ route.query.id }}</li>
    <li>标题：{{ route.query.title }}</li>
    <li>内容：{{ route.query.content }}</li>
  </ul>
</template>

<script setup lang="ts" name="About">
import { useRoute } from "vue-router";
const route = useRoute();
</script>

<style scoped>
.news-list {
  list-style: none;
  padding-left: 20px;
}

.news-list > li {
  line-height: 30px;
}
</style>
```

```vue
<template>
  <ul class="news-list">
    <li>编号：{{ query.id }}</li>
    <li>标题：{{ query.title }}</li>
    <li>内容：{{ query.content }}</li>
  </ul>
</template>

<script setup lang="ts" name="About">
import { toRefs } from "vue";
import { useRoute } from "vue-router";
const route = useRoute();
const { query } = toRefs(route);
</script>
```

### params参数

```vue
<!-- 跳转并携带params参数（to的字符串写法） -->
<RouterLink :to="`/news/detail/001/新闻001/内容001`">{{news.title}}</RouterLink>
				
<!-- 跳转并携带params参数（to的对象写法） -->
<RouterLink 
  :to="{
    name:'xiang', //用name跳转
    params:{
      id:news.id,
      title:news.title,
      content:news.title
    }
  }"
>
  {{news.title}}
</RouterLink>
```

```js
import {useRoute} from 'vue-router'
const route = useRoute()
// 打印params参数
console.log(route.params)
```

>备注1：传递`params`参数时，若使用`to`的对象写法，必须使用`name`配置项，不能用`path`。
>
>备注2：传递`params`参数时，需要提前在规则中占位。

### props参数

作用：让路由组件更方便的收到参数（可以将路由参数作为`props`传给组件）

```js
{
            name: "News",
            path: '/news',
            component: News,
            children: [
                {
                    path: "detail/:id/:title/:content?",
                    component: Detail,
                    name: "Detail",
                    // 第一种写法，将路由收到得所有params参数作为props传给组件
                    // props:true
                    // 第二种写法，函数写法 将路由收到的自定义数据作为props传给组件
                    // props(route) {
                    //     return route.params
                    // },
                    // 第三种写法，对象写法 将路由收到的自定义数据作为props传给组件
                    props: {
                        id: 1,
                        title: "标题",
                        content: "内容"
                    }
                }
            ]
        },
```

`Detail.vue`

```vue
<template>
  <ul class="news-list">
    <li>编号：{{ id }}</li>
    <li>标题：{{ title }}</li>
    <li>内容：{{ content }}</li>
  </ul>
</template>

<script setup lang="ts" name="About">
defineProps(["id", "title", "content"]);
</script>

<style scoped>
.news-list {
  list-style: none;
  padding-left: 20px;
}

.news-list > li {
  line-height: 30px;
}
</style>
```

### replace

    1. 作用：控制路由跳转时操作浏览器历史记录的模式。
    
    2. 浏览器的历史记录有两种写入方式：分别为```push```和```replace```：
    
       - ```push```是追加历史记录（默认值）。
       - `replace`是替换当前记录。
    
    3. 开启`replace`模式：

```vue
<RouterLink replace .......>News</RouterLink>
```

### 编程式路由导航

`news.vue`

```vue
<template>
  <div class="news">
    <!-- 导航区 -->
    <ul>
      <li v-for="item in newList" :key="item.id">
        <button @click="toDetail(item)">查看详情</button>
        <RouterLink
          :to="{
            name: 'Detail',
            params: {
              id: item.id,
              title: item.title,
              content: item.content,
            },
          }"
          >{{ item.title }}</RouterLink
        >
      </li>
    </ul>
    <!-- 展示区 -->
    <div class="news-content">
      <RouterView></RouterView>
    </div>
  </div>
</template>

<script setup lang="ts" name="News">
import { reactive } from "vue";
import { RouterView, RouterLink, useRouter } from "vue-router";

const router = useRouter();

const newList = reactive([
  {
    id: "qazwsx1",
    title: "新闻001",
    content: "新闻001的内容",
  },
  {
    id: "qazwsx2",
    title: "新闻002",
    content: "新闻002的内容",
  },
  {
    id: "qazwsx3",
    title: "新闻003",
    content: "新闻003的内容",
  },
  {
    id: "qazwsx4",
    title: "新闻004",
    content: "新闻004的内容",
  },
]);

interface NewsInter {
  id: string;
  title: string;
  content: string;
}

// 跳转详情
function toDetail(item: NewsInter) {
  router.push({
    name: "Detail",
    query: {
      id: item.id,
      title: item.title,
      content: item.content,
    },
  });
}
</script>
```

### 重定向

1. 作用：将特定的路径，重新定向到已有路由。

2. 具体编码：

   ```js
   {
       path:'/',
       redirect:'/about'
   }
   ```

## pinia

<img src="./images/pinia_example.gif" alt="pinia_example" style="zoom:30%;border:3px solid" />

### 搭建 pinia 环境

第一步：`npm install pinia`

第二步：操作`src/main.ts`

```ts
// 引入createApp用于创建应用
import { createApp } from 'vue'
// 引入App根组件
import App from './App.vue'

// 1.引入pinia用于管理状态
import { createPinia } from 'pinia'


// 创建一个应用
const app = createApp(App)

// 2.创建pinia
const pinia = createPinia()

// 3.挂载pinia到应用中
app.use(pinia)

// 挂载整个应用到app容器中
app.mount('#app')
```

### 存储+读取数据

1. `Store`是一个保存：**状态**、**业务逻辑** 的实体，每个组件都可以**读取**、**写入**它。

2. 它有三个概念：`state`、`getter`、`action`，相当于组件中的： `data`、 `computed` 和 `methods`。

3. 具体编码：`src/store/count.ts`

   ```ts
   // 引入defineStore用于创建store
   import {defineStore} from 'pinia'
   
   // 定义并暴露一个store
   export const useCountStore = defineStore('count',{
     // 动作
     actions:{},
     // 状态
     state(){
       return {
         sum:6
       }
     },
     // 计算
     getters:{}
   })
   ```

4. 具体编码：`src/store/talk.ts`

   ```ts
   // 引入defineStore用于创建store
   import {defineStore} from 'pinia'
   
   // 定义并暴露一个store
   export const useTalkStore = defineStore('talk',{
     // 动作
     actions:{},
     // 状态
     state(){
       return {
         talkList:[
           {id:'yuysada01',content:'你今天有点怪，哪里怪？怪好看的！'},
        		{id:'yuysada02',content:'草莓、蓝莓、蔓越莓，你想我了没？'},
           {id:'yuysada03',content:'心里给你留了一块地，我的死心塌地'}
         ]
       }
     },
     // 计算
     getters:{}
   })
   ```

5. 组件中使用`state`中的数据

   ```vue
   <template>
     <h2>当前求和为：{{ sumStore.sum }}</h2>
   </template>
   
   <script setup lang="ts" name="Count">
     // 引入对应的useXxxxxStore	
     import {useSumStore} from '@/store/sum'
     
     // 调用useXxxxxStore得到对应的store
     const sumStore = useSumStore()
   </script>
   ```

   ```vue
   <template>
   	<ul>
       <li v-for="talk in talkStore.talkList" :key="talk.id">
         {{ talk.content }}
       </li>
     </ul>
   </template>
   
   <script setup lang="ts" name="Count">
     import axios from 'axios'
     import {useTalkStore} from '@/store/talk'
   
     const talkStore = useTalkStore()
   </script>
   ```

### 修改数据（3种方式）

1. 第一种修改方式，直接修改

   ```ts
   countStore.sum = 666
   ```

2. 第二种修改方式：批量修改

   ```ts
   countStore.$patch({
     sum:999,
     school:'atguigu'
   })
   ```

3. 第三种修改方式：借助`action`修改（`action`中可以编写一些业务逻辑）

   ```js
   import { defineStore } from 'pinia'
   
   export const useCountStore = defineStore('count', {
     /*************/
     actions: {
       //加
       increment(value:number) {
         if (this.sum < 10) {
           //操作countStore中的sum
           this.sum += value
         }
       },
       //减
       decrement(value:number){
         if(this.sum > 1){
           this.sum -= value
         }
       }
     },
     /*************/
   })
   ```

4. 组件中调用`action`即可

   ```js
   // 使用countStore
   const countStore = useCountStore()
   
   // 调用对应action
   countStore.incrementOdd(n.value)
   ```

### storeToRefs的使用

- 借助`storeToRefs`将`store`中的数据转为`ref`对象，方便在模板中使用。
- 注意：`pinia`提供的`storeToRefs`只会将数据做转换，而`Vue`的`toRefs`会转换`store`中数据。

```vue
<template>
	<div class="count">
		<h2>当前求和为：{{sum}}</h2>
	</div>
</template>

<script setup lang="ts" name="Count">
  import { useCountStore } from '@/store/count'
  /* 引入storeToRefs */
  import { storeToRefs } from 'pinia'

	/* 得到countStore */
  const countStore = useCountStore()
  /* 使用storeToRefs转换countStore，随后解构 */
  const {sum} = storeToRefs(countStore)
</script>
```

### getters
> 概念：当`state`中的数据，需要经过处理后再使用时，可以使用`getters`配置。算是一个`计算属性`

追加```getters```配置。

```ts
import { defineStore } from "pinia";

export const useCountStore = defineStore("count", {
    // 数据  - 状态
    state: () => {
        return {
            sum: 10,
            school: "北京航空航天大学abcdefg",
            address: '北京市海淀区学院路37号',
        };
    },
    // 里面放置的是方法，用于响应组件中的“动作”
    actions: {
        increment(value: number) {
            // this是当前的store实例
            this.sum += value;
            console.log('调用了increment方法')
        },
        jian(value: number) {
            this.sum -= value;
            console.log('调用减法')
        }
    },
    getters: {
        bigSum: state => state.sum * 10,
        upperSchool():string {
            return this.school.toUpperCase()
        }
    }
});
```

在页面中使用

```vue
<template>
  <div class="count">
    <h2>当前求和为：{{ sum }},放大是10倍后{{ bigSum }}</h2>
    <h3>欢迎来到：{{ school }}</h3>
    <h3>学校大写：{{ upperSchool }}</h3>
    <h3>坐落于：{{ address }}</h3>
    <select v-model.number="n">
      <option value="1">1</option>
      <option value="2">2</option>
      <option value="3">3</option>
    </select>
    <button @click="add">加</button>
    <button @click="minus">减</button>
  </div>
</template>

<script setup lang="ts" name="Count">
import { ref } from "vue";
import { storeToRefs } from "pinia";
import { useCountStore } from "@/store/count";
const countStore = useCountStore();

const { sum, school, address, bigSum, upperSchool } = storeToRefs(countStore);

let n = ref(1); // 用户选择的数字

function add() {
  countStore.sum += 1;
}
function minus() {
  countStore.sum -= n.value;
}
</script>
```

### $subscribe

通过 store 的 `$subscribe()` 方法侦听 `state` 及其变化

> 在页面中调用
```js
talkStore.$subscribe((mutate,state)=>{
  console.log('LoveTalk',mutate,state)
  localStorage.setItem('talk',JSON.stringify(talkList.value))
})
```

完整代码
```ts
import { defineStore } from "pinia";
import axios from "axios";
import { nanoid } from "nanoid";

export const useTalkStore = defineStore("loveTalk", {
    // 数据
    state: () => {
        return {
            talkList: JSON.parse(localStorage.getItem('talkList') as string) || []
        };
    },
    // 方法
    actions: {
        async getLoveTalk() {
            let {
                data: { content: title },
            } = await axios.get("https://api.uomg.com/api/rand.qinghua?format=json");
            // 把请求回来的字符串，包装成一个对象
            let obj = { id: nanoid(), title };
            // 放到数组中
            this.talkList.unshift(obj);
        }
    }
});
```

```vue
<template>
  <div class="talk">
    <button @click="getLoveTalk">获取一句土味情话</button>
    <ul>
      <li v-for="talk in talkList" :key="talk.id">{{ talk.title }}</li>
    </ul>
  </div>
</template>

<script setup lang="ts" name="LoveTalk">
import { useTalkStore } from "@/store/loveTalk";
import { storeToRefs } from "pinia";
const talkStore = useTalkStore();
const { talkList } = storeToRefs(talkStore);

talkStore.$subscribe((mutate, state) => {
  console.log(mutate, state);
  localStorage.setItem("talkList", JSON.stringify(state.talkList));
});

// 方法
async function getLoveTalk() {
  // 发请求，下面这行的写法是：连续解构赋值+重命名
  talkStore.getLoveTalk();
}
</script>

<style scoped>
.talk {
  background-color: orange;
  padding: 10px;
  border-radius: 10px;
  box-shadow: 0 0 10px;
}
</style>
```

### stroe组合式写法

```ts
import {defineStore} from 'pinia'
import axios from 'axios'
import {nanoid} from 'nanoid'
import {reactive} from 'vue'

export const useTalkStore = defineStore('talk',()=>{
  // talkList就是state
  const talkList = reactive(
    JSON.parse(localStorage.getItem('talkList') as string) || []
  )

  // getATalk函数相当于action
  async function getATalk(){
    // 发请求，下面这行的写法是：连续解构赋值+重命名
    let {data:{content:title}} = await axios.get('https://api.uomg.com/api/rand.qinghua?format=json')
    // 把请求回来的字符串，包装成一个对象
    let obj = {id:nanoid(),title}
    // 放到数组中
    talkList.unshift(obj)
  }
  return {talkList,getATalk}
})
```

## 组件通信
**`Vue3`组件通信和`Vue2`的区别：**

* 移出事件总线，使用`mitt`代替。

- `vuex`换成了`pinia`。
- 把`.sync`优化到了`v-model`里面了。
- 把`$listeners`所有的东西，合并到`$attrs`中了。
- `$children`被砍掉了。

**常见搭配形式：**

<img src="images/image-20231119185900990.png" alt="image-20231119185900990" style="zoom:60%;" /> 


### props

概述：`props`是使用频率最高的一种通信方式，常用与 ：**父 ↔ 子**。

- 若 **父传子**：属性值是**非函数**。
- 若 **子传父**：属性值是**函数**。

父组件：

```vue
<template>
  <div class="father">
    <h3>父组件，</h3>
		<h4>我的车：{{ car }}</h4>
		<h4>儿子给的玩具：{{ toy }}</h4>
		<Child :car="car" :getToy="getToy"/>
  </div>
</template>

<script setup lang="ts" name="Father">
	import Child from './Child.vue'
	import { ref } from "vue";
	// 数据
	const car = ref('奔驰')
	const toy = ref()
	// 方法
	function getToy(value:string){
		toy.value = value
	}
</script>
```

子组件

```vue
<template>
  <div class="child">
    <h3>子组件</h3>
		<h4>我的玩具：{{ toy }}</h4>
		<h4>父给我的车：{{ car }}</h4>
		<button @click="getToy(toy)">玩具给父亲</button>
  </div>
</template>

<script setup lang="ts" name="Child">
	import { ref } from "vue";
	const toy = ref('奥特曼')
	
	defineProps(['car','getToy'])
</script>
```

### 自定义事件

1. 概述：自定义事件常用于：**子 => 父。**
2. 注意区分好：原生事件、自定义事件。

- 原生事件：
  - 事件名是特定的（`click`、`mosueenter`等等）	
  - 事件对象`$event`: 是包含事件相关信息的对象（`pageX`、`pageY`、`target`、`keyCode`）
- 自定义事件：
  - 事件名是任意名称
  - <strong style="color:red">事件对象`$event`: 是调用`emit`时所提供的数据，可以是任意类型！！！</strong >

3. 示例：

   ```vue
   <!--在父组件中，给子组件绑定自定义事件：-->
   <Child @send-toy="toy = $event"/>
   
   <!--注意区分原生事件与自定义事件中的$event-->
   <button @click="toy = $event">测试</button>
   ```

   ```js
   //子组件中，触发事件：
   this.$emit('send-toy', 具体数据)
   ```

### mitt

概述：与消息订阅与发布（`pubsub`）功能类似，可以实现任意组件间通信。

安装`mitt`

```shell
npm i mitt
```

新建文件：`src\utils\emitter.ts`

```javascript
// 引入mitt 
import mitt from "mitt";

// 创建emitter
const emitter = mitt()

/*
  // 绑定事件
  emitter.on('abc',(value)=>{
    console.log('abc事件被触发',value)
  })
  emitter.on('xyz',(value)=>{
    console.log('xyz事件被触发',value)
  })

  setInterval(() => {
    // 触发事件
    emitter.emit('abc',666)
    emitter.emit('xyz',777)
  }, 1000);

  setTimeout(() => {
    // 清理事件
    emitter.all.clear()
  }, 3000); 
*/

// 创建并暴露mitt
export default emitter
```

接收数据的组件中：绑定事件、同时在销毁前解绑事件：

```typescript
import emitter from "@/utils/emitter";
import { onUnmounted } from "vue";

// 绑定事件
emitter.on('send-toy',(value)=>{
  console.log('send-toy事件被触发',value)
})

onUnmounted(()=>{
  // 解绑事件
  emitter.off('send-toy')
})
```

【第三步】：提供数据的组件，在合适的时候触发事件

```javascript
import emitter from "@/utils/emitter";

function sendToy(){
  // 触发事件
  emitter.emit('send-toy',toy.value)
}
```

### v-model

**注意这个重要的内置关系，总线依赖着这个内置关系**

1. 概述：实现 **父↔子** 之间相互通信。

2. 前序知识 —— `v-model`的本质

   ```vue
   <!-- 使用v-model指令 -->
   <input type="text" v-model="userName">
   
   <!-- v-model的本质是下面这行代码 -->
   <input 
     type="text" 
     :value="userName" 
     @input="userName =(<HTMLInputElement>$event.target).value"
   >
   ```

3. 组件标签上的`v-model`的本质：`:moldeValue` ＋ `update:modelValue`事件。

   ```vue
   <!-- 组件标签上使用v-model指令 -->
   <AtguiguInput v-model="userName"/>
   
   <!-- 组件标签上v-model的本质 -->
   <AtguiguInput :modelValue="userName" @update:model-value="userName = $event"/>
   ```

   `AtguiguInput`组件中：

   ```vue
   <template>
     <div class="box">
       <!--将接收的value值赋给input元素的value属性，目的是：为了呈现数据 -->
   		<!--给input元素绑定原生input事件，触发input事件时，进而触发update:model-value事件-->
       <input 
          type="text" 
          :value="modelValue" 
          @input="emit('update:model-value',$event.target.value)"
       >
     </div>
   </template>
   
   <script setup lang="ts" name="AtguiguInput">
     // 接收props
     defineProps(['modelValue'])
     // 声明事件
     const emit = defineEmits(['update:model-value'])
   </script>
   ```

4. 也可以更换`value`，例如改成`abc`

   ```vue
   <!-- 也可以更换value，例如改成abc-->
   <AtguiguInput v-model:abc="userName"/>
   
   <!-- 上面代码的本质如下 -->
   <AtguiguInput :abc="userName" @update:abc="userName = $event"/>
   ```

   `AtguiguInput`组件中：

   ```vue
   <template>
     <div class="box">
       <input 
          type="text" 
          :value="abc" 
          @input="emit('update:abc',$event.target.value)"
       >
     </div>
   </template>
   
   <script setup lang="ts" name="AtguiguInput">
     // 接收props
     defineProps(['abc'])
     // 声明事件
     const emit = defineEmits(['update:abc'])
   </script>
   ```

5. 如果`value`可以更换，那么就可以在组件标签上多次使用`v-model`

   ```vue
   <AtguiguInput v-model:abc="userName" v-model:xyz="password"/>
   ```

### $attrs 

1. 概述：`$attrs`用于实现**当前组件的父组件**，向**当前组件的子组件**通信（**祖→孙**）。

2. 具体说明：`$attrs`是一个对象，包含所有父组件传入的标签属性。

   >  注意：`$attrs`会自动排除`props`中声明的属性(可以认为声明过的 `props` 被子组件自己“消费”了)

父组件：

```vue
<template>
  <div class="father">
    <h3>父组件</h3>
		<Child :a="a" :b="b" :c="c" :d="d" v-bind="{x:100,y:200}" :updateA="updateA"/>
  </div>
</template>

<script setup lang="ts" name="Father">
	import Child from './Child.vue'
	import { ref } from "vue";
	let a = ref(1)
	let b = ref(2)
	let c = ref(3)
	let d = ref(4)

	function updateA(value){
		a.value = value
	}
</script>
```

子组件：

```vue
<template>
	<div class="child">
		<h3>子组件</h3>
		<GrandChild v-bind="$attrs"/>
	</div>
</template>

<script setup lang="ts" name="Child">
	import GrandChild from './GrandChild.vue'
</script>
```

孙组件：

```vue
<template>
	<div class="grand-child">
		<h3>孙组件</h3>
		<h4>a：{{ a }}</h4>
		<h4>b：{{ b }}</h4>
		<h4>c：{{ c }}</h4>
		<h4>d：{{ d }}</h4>
		<h4>x：{{ x }}</h4>
		<h4>y：{{ y }}</h4>
		<button @click="updateA(666)">点我更新A</button>
	</div>
</template>

<script setup lang="ts" name="GrandChild">
	defineProps(['a','b','c','d','x','y','updateA'])
</script>
```

### $refs、$parent

1. 概述：实现**祖孙组件**直接通信

2. 具体使用：

   * 在祖先组件中通过`provide`配置向后代组件提供数据
   * 在后代组件中通过`inject`配置来声明接收数据

3. 具体编码：

   【第一步】父组件中，使用`provide`提供数据

   ```vue
   <template>
     <div class="father">
       <h3>父组件</h3>
       <h4>资产：{{ money }}</h4>
       <h4>汽车：{{ car }}</h4>
       <button @click="money += 1">资产+1</button>
       <button @click="car.price += 1">汽车价格+1</button>
       <Child/>
     </div>
   </template>
   
   <script setup lang="ts" name="Father">
     import Child from './Child.vue'
     import { ref,reactive,provide } from "vue";
     // 数据
     let money = ref(100)
     let car = reactive({
       brand:'奔驰',
       price:100
     })
     // 用于更新money的方法
     function updateMoney(value:number){
       money.value += value
     }
     // 提供数据
     provide('moneyContext',{money,updateMoney})
     provide('car',car)
   </script>
   ```
   
   > 注意：子组件中不用编写任何东西，是不受到任何打扰的
   
   【第二步】孙组件中使用`inject`配置项接受数据。
   
   ```vue
   <template>
     <div class="grand-child">
       <h3>我是孙组件</h3>
       <h4>资产：{{ money }}</h4>
       <h4>汽车：{{ car }}</h4>
       <button @click="updateMoney(6)">点我</button>
     </div>
   </template>
   
   <script setup lang="ts" name="GrandChild">
     import { inject } from 'vue';
     // 注入数据
    let {money,updateMoney} = inject('moneyContext',{money:0,updateMoney:(x:number)=>{}})
     let car = inject('car')
</script>
   ```

### provide、inject

1. 概述：实现**祖孙组件**直接通信

2. 具体使用：

   * 在祖先组件中通过`provide`配置向后代组件提供数据
   * 在后代组件中通过`inject`配置来声明接收数据

4. 具体编码：

   【第一步】父组件中，使用`provide`提供数据

   ```vue
   <template>
     <div class="father">
       <h3>父组件</h3>
       <h4>资产：{{ money }}</h4>
       <h4>汽车：{{ car }}</h4>
       <button @click="money += 1">资产+1</button>
       <button @click="car.price += 1">汽车价格+1</button>
       <Child/>
     </div>
   </template>
   
   <script setup lang="ts" name="Father">
     import Child from './Child.vue'
     import { ref,reactive,provide } from "vue";
     // 数据
     let money = ref(100)
     let car = reactive({
       brand:'奔驰',
       price:100
     })
     // 用于更新money的方法
     function updateMoney(value:number){
       money.value += value
     }
     // 提供数据
     provide('moneyContext',{money,updateMoney})
     provide('car',car)
   </script>
   ```
   
   > 注意：子组件中不用编写任何东西，是不受到任何打扰的
   
   【第二步】孙组件中使用`inject`配置项接受数据。
   
   ```vue
   <template>
     <div class="grand-child">
       <h3>我是孙组件</h3>
       <h4>资产：{{ money }}</h4>
       <h4>汽车：{{ car }}</h4>
       <button @click="updateMoney(6)">点我</button>
     </div>
   </template>
   
   <script setup lang="ts" name="GrandChild">
     import { inject } from 'vue';
     // 注入数据
    let {money,updateMoney} = inject('moneyContext',{money:0,updateMoney:(x:number)=>{}})
     let car = inject('car')
</script>
   ```


















## 其他
https://v3-migration.vuejs.org/zh/breaking-changes/


- 过渡类名 `v-enter` 修改为 `v-enter-from`、过渡类名 `v-leave` 修改为 `v-leave-from`。


- `keyCode` 作为 `v-on` 修饰符的支持。

- `v-model` 指令在组件上的使用已经被重新设计，替换掉了 `v-bind.sync。`

- `v-if` 和 `v-for` 在同一个元素身上使用时的优先级发生了变化。

- 移除了`$on`、`$off` 和 `$once` 实例方法。

- 移除了过滤器 `filter`。

- 移除了`$children` 实例 `propert`。