跳至主要內容

Vue 3

T4makoVueVue大约 42 分钟

Vue 3

1. Vue3 简介

2. 创建 Vue3 工程

2.1. 【基于 vue-cli 创建】

点击查看 官方文档open in new window

备注:目前vue-cli已处于维护模式,官方推荐基于 Vite 创建项目。

## 查看@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

2.2. 【基于 vite 创建】(推荐)

vite 是新一代前端构建工具,官网地址:https://vitejs.cnopen in new windowvite的优势如下:

  • 轻量快速的热重载(HMR),能实现极速的服务启动。
  • TypeScriptJSXCSS 等支持开箱即用。
  • 真正的按需编译,不再等待整个应用编译完成。
## 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

总结:

  • Vite 项目中,index.html 是项目的入口文件,在项目最外层。
  • 加载 index.html 后,Vite 解析 <script type="module" src="xxx"> 指向的 JavaScript
  • Vue3 中是通过 createApp 函数创建一个应用实例。
<!-- 入口文件 index.html -->
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8">
    <link rel="icon" href="/favicon.ico">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Vite App</title>
  </head>
  <body>
    <div id="app"></div>
    <script type="module" src="/src/main.ts"></script>
  </body>
</html>
/* main.js */
import './assets/main.css'

// 导入方法
import { createApp } from 'vue'
// 导入根组件
import App from './App.vue'
// createApp() 创建应用实例并挂载在 id 为 app 的 div 上
createApp(App).mount('#app')

自己动手编写一个 App 组件

<template>
  <div class="app">
    <h1>你好啊!</h1>
  </div>
</template>

<script lang="ts">
  export default {
    name:'App' //组件名
  }
</script>

<style>
  .app {
    background-color: #ddd;
    box-shadow: 0 0 10px;
    border-radius: 10px;
    padding: 20px;
  }
</style>

相关信息

Vue3 向下兼容 Vue2 语法,且 Vue3 中的模板中可以没有根标签

3. Vue3 核心语法

3.1. 【OptionsAPI 与 CompositionAPI】

  • Vue2API 设计是Options(配置)风格的。
  • Vue3API设计是 Composition(组合)风格的。

Options API 的弊端

Options 类型的 API,数据、方法、计算属性等,是分散在:datamethodscomputed中的,若想新增或者修改一个需求,就需要分别修改:datamethodscomputed,不便于维护和复用。

Composition API 的优势

可以用函数的方式,更加优雅的组织代码,让相关功能的代码更加有序的组织在一起。

3.2. setup

setup 概述

setupVue3 中一个新的配置项,值是一个函数,它是 Composition API “表演的舞台,组件中所用到的:数据、方法、计算属性、监视......等等,均配置在setup中。

特点如下:

  • setup 函数返回的对象中的内容,可直接在模板中使用。
  • setup 中访问 thisundefined(处理数据时,没有 this)
  • setup 函数会在 beforeCreate 之前调用,它是「领先」所有钩子执行的。

相关信息

直接声明的变量 let a = xxx 不是响应式的

setup() 无需使用 this,this 是 undefined

<template>
  <div class="person">
    <h2>姓名:{{name}}</h2>
    <h2>年龄:{{age}}</h2>
    <button @click="changeName">修改名字</button>
    <button @click="changeAge">年龄+1</button>
    <button @click="showTel">点我查看联系方式</button>
  </div>
</template>

<script lang="ts">
  export default {
    name:'Person',
    setup(){
      // 数据,原来写在data中(注意:此时的name、age、tel数据都不是响应式数据)
      let name = '张三'
      let age = 18
      let tel = '13888888888'

      // 方法,原来写在methods中
      function changeName(){
        name = 'zhang-san' //注意:此时这么修改name页面是不变化的
        console.log(name)
      }
      function changeAge(){
        age += 1 //注意:此时这么修改age页面是不变化的
        console.log(age)
      }
      function showTel(){
        alert(tel)
      }

      // 返回一个对象,对象中的内容,模板中可以直接使用
      return {name,age,tel,changeName,changeAge,showTel}
    }
  }
</script>

setup 的返回值

  • 若返回一个 对象:则对象中的:属性、方法等,在模板中均可以直接使用**(重点关注)**
  • 若返回一个 函数:则可以自定义渲染内容(用的少),代码如下:
setup(){
  return ()=> '你好啊!' // 页面为 你好啊!
}

setup 与 Options API 的关系

  • Vue2 的配置(datamethos......)中 可以访问到 setup 中的属性、方法。
  • 但在 setup不能访问到 Vue2 的配置(datamethos......)。
  • 如果与 Vue2 冲突,则 setup 优先。

setup 语法糖

setup 函数有一个语法糖,可以把 setup 独立出去,无需写 setup() 函数和 return 语句,代码如下:

<template>
  <div class="person">
    <h2>姓名:{{name}}</h2>
    <h2>年龄:{{age}}</h2>
    <button @click="changName">修改名字</button>
    <button @click="changAge">年龄+1</button>
    <button @click="showTel">点我查看联系方式</button>
  </div>
</template>

<script lang="ts">
  export default {
    name:'Person',
  }
</script>

<!-- 下面的写法是setup语法糖 -->
<script setup lang="ts">
  console.log(this) //undefined
  
  // 数据(注意:此时的 name、age、tel 都不是响应式数据)
  let name = '张三'
  let age = 18
  let tel = '13888888888'

  // 方法
  function changName(){
    name = '李四'//注意:此时这么修改name页面是不变化的
  }
  function changAge(){
    console.log(age)
    age += 1 //注意:此时这么修改age页面是不变化的
  }
  function showTel(){
    alert(tel)
  }
</script>

扩展:vite 中的插件简化,使用一个 script 标签定义 setup() 和 name:

  1. 第一步:npm i vite-plugin-vue-setup-extend -D
  2. 第二步:vite.config.ts (vite 配置文件)
// vite.config.ts
import { defineConfig } from 'vite'
import VueSetupExtend from 'vite-plugin-vue-setup-extend'

export default defineConfig({
  plugins: [ VueSetupExtend() ] // 添加
})
  1. 第三步:<script setup lang="ts" name="Person">

3.3. 【ref 创建:基本类型的响应式数据】

  • 引入:import {ref} from 'vue'
  • **作用:**定义响应式变量
  • 语法:let xxx = ref(初始值)
  • **返回值:**一个 RefImpl 的实例对象,简称 ref 对象或 refref 对象的 value 属性是响应式的

相关信息

JS 中操作数据需要: xxx.value,但模板中不需要 .value,直接使用即可

对于 let name = ref('xxx') 来说,name 不是响应式的,name.value 是响应式的。

<template>
  <div class="person">
    <h2>姓名:{{name}}</h2>
    <h2>年龄:{{age}}</h2>
    <button @click="changeName">修改名字</button>
    <button @click="changeAge">年龄+1</button>
    <button @click="showTel">点我查看联系方式</button>
  </div>
</template>

<script setup lang="ts" name="Person">
  import {ref} from 'vue'
  // name和age是一个RefImpl的实例对象,简称ref对象,它们的value属性是响应式的。
  let name = ref('张三')
  let age = ref(18)
  // tel就是一个普通的字符串,不是响应式的
  let tel = '13888888888'

  function changeName(){
    // JS中操作ref对象时候需要.value
    name.value = '李四'
    console.log(name.value)

    // 注意:name不是响应式的,name.value是响应式的,所以如下代码并不会引起页面的更新。
    // name = ref('zhang-san')
  }
  function changeAge(){
    // JS中操作ref对象时候需要.value
    age.value += 1 
    console.log(age.value)
  }
  function showTel(){
    alert(tel)
  }
</script>

3.4. 【reactive 创建:对象类型的响应式数据】

  • 引入: import {reactive} from 'vue'
  • **作用:**定义一个 响应式对象(基本类型不要用它,要用 ref,否则报错)
  • 语法:let 响应式对象= reactive(源对象)
  • **返回值:**一个 Proxy 的实例对象,简称:响应式对象

相关信息

reactive 定义的响应式数据是不可整体修改(不可直接用对象赋值)

<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>

3.5. 【ref 创建:对象类型的响应式数据】

  • 其实 ref 接收的数据可以是:基本类型对象类型
  • ref 接收的是对象类型,内部其实也是调用了 reactive 函数

相关信息

使用 ref 创建对象类型的响应式数据时,在 setup 中也要使用 .value 来操作

由于 ref 底层还是 reactive,因此 ref 要 .value ,reactive 不需要

<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>

3.6. 【ref 对比 reactive】

宏观角度看:

  • ref 用来定义:基本类型数据对象类型数据
  • reactive 用来定义:对象类型数据

区别:

  • ref 创建的变量必须使用 .value(可以使用 volar 插件自动添加 .value

  • reactive 重新分配一个新对象,会 失去 响应式(可以使用 Object.assign 去整体替换)

  • 使用原则:

    • 若需要一个基本类型的响应式数据,必须使用 ref
    • 若需要一个响应式对象,层级不深,refreactive 都可以
    • 若需要一个响应式对象,且层级较深,推荐使用 reactive

3.7. 【toRefs 与 toRef】

  • 引入:import {toRefs} from 'vue'

  • 作用:将一个响应式对象中的每一个属性,转换为 ref 对象(通常在结构赋值时使用)

  • 备注:toRefstoRef 功能一致,但 toRefs 可以批量转换(通常使用 toRefs)

  • 语法如下:

<template>
  <div class="person">
    <h2>姓名:{{person.name}}</h2>
    <h2>年龄:{{person.age}}</h2>
    <h2>性别:{{person.gender}}</h2>
    <button @click="changeName">修改名字</button>
    <button @click="changeAge">修改年龄</button>
    <button @click="changeGender">修改性别</button>
  </div>
</template>

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

  // 数据
  let person = reactive({name:'张三', age:18, gender:'男'})
	
  // 通过toRefs将person对象中的n个属性批量取出,且依然保持响应式的能力
  let {name,gender} =  toRefs(person)
	
  // 通过toRef将person对象中的gender属性取出,且依然保持响应式的能力
  let age = toRef(person,'age')

  // 方法
  function changeName(){
    name.value += '~'
  }
  function changeAge(){
    age.value += 1
  }
  function changeGender(){
    gender.value = '女'
  }
</script>

3.8. 【computed】

  • 引入:import {computed} from 'vue'
  • 使用:
    • let val = computed(()=>{return val.value})
    • let val = computed({get(){return val},set(val){return val}})

作用:根据已有数据计算出新数据(和 Vue2 中的 computed 作用一致)

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

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

  let firstName = ref('zhang')
  let lastName = ref('san')

  // 计算属性——只读取,不修改
  /* let fullName = computed(()=>{
    return firstName.value + '-' + lastName.value
  }) */


  // 计算属性——既读取又修改
  let fullName = computed({
    // 读取
    get(){
      return firstName.value + '-' + 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>

3.9.【watch】

  • 引入: import {watch} from 'vue'
  • 作用:监视数据的变化(和 Vue2 中的 watch 作用一致)
  • 特点:Vue3 中的 watch 只能监视以下 四种数据
    • ref 定义的数据。
    • reactive 定义的数据。
    • 函数返回一个值( getter 函数)
    • 一个包含上述内容的数组。

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

* 情况一:监视 ref 定义基本数据类型

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

使用:

let stopValue = compute(要检视的值,(newValue,oldValue) => { // 若参数只有一个,为 newValue
    // 操作
    if(newValue > 10) {
        stopWatch() // 停止检视
    }
})
<template>
  <div class="person">
    <h1>情况一:监视【ref】定义的【基本类型】数据</h1>
    <h2>当前求和为:{{sum}}</h2>
    <button @click="changeSum">点我sum+1</button>
  </div>
</template>

<script lang="ts" setup name="Person">
  import {ref,watch} from 'vue'
  // 数据
  let sum = ref(0)
  // 方法
  function changeSum(){
    sum.value += 1
  }
  // 监视,情况一:监视【ref】定义的【基本类型】数据
  const stopWatch = watch(sum,(newValue,oldValue)=>{
    console.log('sum变化了',newValue,oldValue)
    if(newValue >= 10){
      stopWatch()
    }
  })
</script>

* 情况二:监视 ref 定义的对象(深度监视)

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

  • 若修改的是ref定义的对象中的属性,newValueoldValue 都是新值,因为它们是同一个对象
  • 若修改整个 ref 定义的对象,newValue 是新值, oldValue 是旧值,因为不是同一个对象
<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的第二个参数是:监视的回调
    watch的第三个参数是:配置对象(deep、immediate等等.....) 
  */
  watch(person,(newValue,oldValue)=>{
    console.log('person变化了',newValue,oldValue)
  },{deep:true})
  
</script>

* 情况三 监视 reactive 定义的对象类型数据

监视reactive定义的【对象类型】数据,且默认开启了深度监视。

<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 定义的对象中的某个属性

监视 refreactive 定义的【对象类型】数据中的 某个属性,注意点如下:

  • 若被监视属性值 不是【对象类型】,需要写成函数形式

    watch(() => obj.val,(newValue,oldValue) => {
        // do sth
    })
    
  • 若被监视属性值是 依然 是【对象类型】,可直接编,也可写成函数,建议写成函数,写法如下:

    watch(() => obj.val,(newValue,oldValue) => {
      // do sth
    },{deep:true}) // 深度监视
    

相关信息

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

<template>
  <div class="person">
    <h1>情况四:监视【ref】或【reactive】定义的【对象类型】数据中的某个属性</h1>
    <h2>姓名:{{ person.name }}</h2>
    <h2>年龄:{{ person.age }}</h2>
    <h2>汽车:{{ person.car.c1 }}、{{ person.car.c2 }}</h2>
    <button @click="changeName">修改名字</button>
    <button @click="changeAge">修改年龄</button>
    <button @click="changeC1">修改第一台车</button>
    <button @click="changeC2">修改第二台车</button>
    <button @click="changeCar">修改整个车</button>
  </div>
</template>

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

  // 数据
  let person = reactive({
    name:'张三',
    age:18,
    car:{
      c1:'奔驰',
      c2:'宝马'
    }
  })
  // 方法
  function changeName(){
    person.name += '~'
  }
  function changeAge(){
    person.age += 1
  }
  function changeC1(){
    person.car.c1 = '奥迪'
  }
  function changeC2(){
    person.car.c2 = '大众'
  }
  function changeCar(){
    person.car = {c1:'雅迪',c2:'爱玛'}
  }

  // 监视,情况四:监视响应式对象中的某个属性,且该属性是基本类型的,要写成函数式
  /* watch(()=> person.name,(newValue,oldValue)=>{
    console.log('person.name变化了',newValue,oldValue)
  }) */

  // 监视,情况四:监视响应式对象中的某个属性,且该属性是对象类型的,可以直接写,也能写函数,更推荐写函数
  watch(()=>person.car,(newValue,oldValue)=>{
    console.log('person.car变化了',newValue,oldValue)
  },{deep:true})
</script>

* 情况五 监视上述的多个数据

监视上述的多个数据

<template>
  <div class="person">
    <h1>情况五:监视上述的多个数据</h1>
    <h2>姓名:{{ person.name }}</h2>
    <h2>年龄:{{ person.age }}</h2>
    <h2>汽车:{{ person.car.c1 }}、{{ person.car.c2 }}</h2>
    <button @click="changeName">修改名字</button>
    <button @click="changeAge">修改年龄</button>
    <button @click="changeC1">修改第一台车</button>
    <button @click="changeC2">修改第二台车</button>
    <button @click="changeCar">修改整个车</button>
  </div>
</template>

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

  // 数据
  let person = reactive({
    name:'张三',
    age:18,
    car:{
      c1:'奔驰',
      c2:'宝马'
    }
  })
  // 方法
  function changeName(){
    person.name += '~'
  }
  function changeAge(){
    person.age += 1
  }
  function changeC1(){
    person.car.c1 = '奥迪'
  }
  function changeC2(){
    person.car.c2 = '大众'
  }
  function changeCar(){
    person.car = {c1:'雅迪',c2:'爱玛'}
  }

  // 监视,情况五:监视上述的多个数据
  watch([()=>person.name,person.car],(newValue,oldValue)=>{
    console.log('person.car变化了',newValue,oldValue)
  },{deep:true})

</script>

3.10. 【watchEffect】

  • 立即运行一个函数,同时响应式地追踪其依赖,并在依赖更改时重新执行该函数(立即执行,用到谁就执行函数)

  • 引入:import {watchEffect} from 'vue'

  • watch对比watchEffect

    • 都能监听响应式数据的变化,不同的是监听数据变化的方式不同

    • watch:要明确指出监视的数据

    • watchEffect:不用明确指出监视的数据(函数中用到哪些属性,那就监视哪些属性)

  • 示例代码:

    <template>
      <div class="person">
        <h1>需求:水温达到50℃,或水位达到20cm,则联系服务器</h1>
        <h2 id="demo">水温:{{temp}}</h2>
        <h2>水位:{{height}}</h2>
        <button @click="changePrice">水温+1</button>
        <button @click="changeSum">水位+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 changePrice(){
        temp.value += 10
      }
      function changeSum(){
        height.value += 1
      }
    
      // 用watch实现,需要明确的指出要监视:temp、height
      watch([temp,height],(value)=>{
        // 从value中获取最新的temp值、height值
        const [newTemp,newHeight] = value
        // 室温达到50℃,或水位达到20cm,立刻联系服务器
        if(newTemp >= 50 || newHeight >= 20){
          console.log('联系服务器')
        }
      })
    
      // 用watchEffect实现
      const stopWtach = watchEffect(()=>{
        // 室温达到50℃,或水位达到20cm,立刻联系服务器
        if(temp.value >= 50 || height.value >= 20){
          console.log(document.getElementById('demo')?.innerText)
          console.log('联系服务器')
        }
        // 水温达到100,或水位达到50,取消监视
        if(temp.value === 100 || height.value === 50){
          console.log('清理了')
          stopWtach()
        }
      })
    </script>
    

3.11. 【标签的 ref 属性】

  • 引入: import {ref} from 'vue'

作用:用于注册模板引用

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

用在普通 DOM 标签上:

<template>
  <div class="person">
    <h1 ref="title1">AAA</h1>
    <h2 ref="title2">BBB</h2>
    <h3 ref="title3">CCC</h3>
    <input type="text" ref="inpt"> <br><br>
    <button @click="showLog">点我打印内容</button>
  </div>
</template>

<script lang="ts" setup name="Person">
  import {ref} from 'vue'
	
  let title1 = ref() // 获取 dom 元素
  let title2 = ref()
  let title3 = ref()

  function showLog(){
    // 通过id获取元素
    const t1 = document.getElementById('title1')
    // 打印内容
    console.log((t1 as HTMLElement).innerText)
    console.log((<HTMLElement>t1).innerText)
    console.log(t1?.innerText)
    
		/************************************/
		
    // 通过ref获取元素
    console.log(title1.value)
    console.log(title2.value)
    console.log(title3.value)
  }
</script>

用在组件标签上:

<!-- 父组件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>

3.12. 【props】

props 主要为父组件传值给子组件(App.vue 组件导入 Hello.vue,App 为父组件,Hello 为子组件)

子组件

  • import { defineProps } from 'vue';`
  • 使用 defineProps(['xxx']) 接收值

相关信息

import 后的 '@' 表示 src 目录

ts 回顾:

/* /src/types/index.ts */
// 定义一个接口,限制每个 Person 对象的格式
export interface PersonInter {
id:string,
name:string,
 age:number
}

// 定义一个自定义类型 Persons
export type Persons = Array<PersonInter>

App.vue 中代码:

<template>
	<!-- 为 Person 组件传入 persons 数组,使用数据绑定方式 -->
	<!-- 若没有 : ,传递的是字符串 -->
	<Person :list="persons" a = 123456/> 
</template>

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

 let persons = reactive<Persons>([
  {id:'e98219e12',name:'张三',age:18},
   {id:'e98219e13',name:'李四',age:19},
    {id:'e98219e14',name:'王五',age:20}
  ])
</script>

Person.vue 中代码:

<template>
<div class="person">
<ul>
  <li v-for="item in list" :key="item.id"> <!-- 推荐指定 key 的值,默认为 index -->
     {{item.name}}--{{item.age}}
   </li>
 </ul>
</div>
</template>

<script lang="ts" setup name="Person">
import {defineProps} from 'vue'
import {type PersonInter} from '@/types'

// 第一种写法:仅接收
// const props = defineProps(['list'])

// 第二种写法:接收+限制类型
// defineProps<{list:Persons}>()

// 第三种写法:接收+限制类型+指定默认值+限制必要性
let props = withDefaults(defineProps<{list?:Persons}>(),{
  list:()=>[{id:'asdasg01',name:'小猪佩奇',age:18}]
})
console.log(props)
</script>

3.13. 【生命周期】

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

  • 规律:

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

  • Vue2的生命周期

    创建阶段:beforeCreatecreated

    挂载阶段:beforeMountmounted

    更新阶段:beforeUpdateupdated

    销毁阶段:beforeDestroydestroyed

  • Vue3的生命周期

    创建阶段:setup

    挂载阶段:onBeforeMountonMounted

    更新阶段:onBeforeUpdateonUpdated

    卸载阶段:onBeforeUnmountonUnmounted

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

  • 示例代码:

    <template>
      <div class="person">
        <h2>当前求和为:{{ sum }}</h2>
        <button @click="changeSum">点我sum+1</button>
      </div>
    </template>
    
    <!-- vue3写法 -->
    <script lang="ts" setup name="Person">
      import { 
        ref, 
        onBeforeMount, 
        onMounted, 
        onBeforeUpdate, 
        onUpdated, 
        onBeforeUnmount, 
        onUnmounted 
      } from 'vue'
    
      // 数据
      let sum = ref(0)
      // 方法
      function changeSum() {
        sum.value += 1
      }
      console.log('setup')
      // 生命周期钩子
      onBeforeMount(()=>{
        console.log('挂载之前')
      })
      onMounted(()=>{
        console.log('挂载完毕')
      })
      onBeforeUpdate(()=>{
        console.log('更新之前')
      })
      onUpdated(()=>{
        console.log('更新完毕')
      })
      onBeforeUnmount(()=>{
        console.log('卸载之前')
      })
      onUnmounted(()=>{
        console.log('卸载完毕')
      })
    </script>
    

3.14. 【自定义 hook】

  • 什么是 hook ?—— 本质是一个函数,把 setup 函数中使用的 Composition API 进行了封装,类似于 vue2.x 中的 mixin

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

示例代码:

  • useSum.ts 中内容如下:

    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 中内容如下:

    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}
    }
    
  • 组件中具体使用:

    <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,getg} = useDog()
    </script>
    

4. 路由

4.1. 【对路由的理解】

4.2. 【基本切换效果】

vue-router 的安装:

npm i vue-router

在 src 下创建 router 文件夹,编写 index.js

  • Vue3 中要使用 vue-router 的最新版本

  • 路由配置文件代码如下:

    /* /src/router/index.js */
    import {createRouter,createWebHistory} from 'vue-router'
    // 导入切换的组件
    import Home from '@/pages/Home.vue'
    import News from '@/pages/News.vue'
    import About from '@/pages/About.vue'
    // 定义路由对象
    const router = createRouter({
    	history:createWebHistory(),
    	routes:[
    		{
    			path:'/home', // 路径
    			component:Home // 组件
    		},
    		{
    			path:'/about',
    			component:About
    		}
    	]
    })
    export default router // 默认暴露
    
  • main.ts 代码如下:

    import './assets/main.css'
    import router from './router/index'
    
    // 导入方法
    import { createApp } from 'vue'
    // 导入根组件
    import App from './App.vue'
    // createApp() 创建应用实例并挂载在 id 为 app 的 div 上
    const app = createApp(App)
    app.use(router)
    app.mount('#app')
    
  • App.vue 代码如下

    使用 RouterLink 组件代替 a 标签

    属性 to 代表路径,active-class 代表组件激活时的 css 样式

    <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>
    

4.3. 【两个注意点】

相关信息

  • 路由组件通常存放在 pagesviews 文件夹,一般组件通常存放在 components 文件夹
  • 通过点击导航,视觉效果上 「消失」 了的路由组件,默认是被 卸载 掉的,需要的时候再去 挂载

4.4.【路由器工作模式】

  1. history 模式

    优点:URL更加美观,不带有#,更接近传统的网站URL

    缺点:后期项目上线,需要服务端配合处理路径问题,否则刷新会有404错误。

    const router = createRouter({
    	history:createWebHistory(), //history模式
    	/******/
    })
    
  2. hash 模式

    优点:兼容性更好,因为不需要服务器端处理路径。

    缺点:URL带有#不太美观,且在SEO优化方面相对较差。

    const router = createRouter({
    	history:createWebHashHistory(), //hash模式
    	/******/
    })
    

4.5. 【to 的两种写法】

  • 字符串形式 to = '/xxx'
  • 对象形式 :to = {path:'/xxx'}
<!-- 第一种:to的字符串写法 -->
<router-link active-class="active" to="/home">主页</router-link>

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

4.6. 【命名路由】

作用:可以简化路由跳转及传参,通过 to 跳转时,使用 to 的对象形式的 name 属性跳转

给路由规则命名:

routes:[
  {
    name:'zhuye',
    path:'/home',
    component:Home
  },
  {
    name:'xinwen',
    path:'/news',
    component:News,
  },
  {
    name:'guanyu',
    path:'/about',
    component:About
  }
]

跳转路由:

<!--简化前:需要写完整的路径(to的字符串写法) -->
<router-link to="/news/detail">跳转</router-link>

<!--简化后:直接通过名字跳转(to的对象写法配合name属性) -->
<router-link :to="{name:'guanyu'}">跳转</router-link>

4.7. 【嵌套路由】

  1. 编写 News 的子路由:Detail.vue

  2. 配置路由规则,使用 children 配置项:

    /* /src/router/index.ts */
    const router = createRouter({
      history:createWebHistory(),
    	routes:[
    		{
    			name:'zhuye',
    			path:'/home',
    			component:Home
    		},
    		{
    			name:'xinwen',
    			path:'/news',
    			component:News,
    			children:[
    				{
    					name:'xiang',
    					path:'detail',
    					component:Detail
    				}
    			]
    		},
    		{
    			name:'guanyu',
    			path:'/about',
    			component:About
    		}
    	]
    })
    export default router
    
  3. 跳转路由:

    to 属性要加 完整路径

    <!-- News.vue -->
    <!-- 导航区 -->
    <ul>
      <li v-for="news in newsList" :key="news.id">
        <RouterLink to="/news/detail">{{news.title}}</RouterLink>
      </li>
    </ul>
    <!-- 展示区 -->
    <div class="news-content">
      <RouterView></RouterView>
    </div>
    

4.8. 【路由传参】

query 参数

  • 传递参数

    • 写法一:to 字符串拼接

      在 router-link 组件上的 to 属性使用字符串拼接的方式进行传递参数

      <!-- 跳转并携带 query 参数(to 的字符串写法) -->
      <router-link to="/news/detail?a=1&b=2&content=欢迎你">
      	跳转
      </router-link>
      
    • 写法二:to 的对象写法

      使用 to 属性的对象写法,包含参数 path、query

      <!-- 跳转并携带 query 参数(to 的对象写法) -->
      <RouterLink 
        :to="{
          //name:'xiang', //用 name 也可以跳转
          path:'/news/detail',
          query:{
            id:news.id,
            title:news.title,
            content:news.content
          }
        }"
      >
        {{news.title}}
      </RouterLink>
      
  • 接收参数:

    从 vue-router 导入 useRouter 组件(它为一个 hooks)

    import {useRoute} from 'vue-router'
    const route = useRoute() // 接收参数
    // 打印query参数
    console.log(route.query)
    

params 参数

  • router 的更改:

    path 使用占位符的写法,?代表可有可无

routes:[
...
{
  name:'xinwen',
  path:'/news',
  component:News,
  children:[
    {
      name:'xiang',
      path:'detail/:id/:title/:content?', 
      component:Detail
    }
  ]
}
]
  • 传递参数

    • to 的字符串写法

      <!-- 跳转并携带 params 参数(to的字符串写法) -->
      <RouterLink :to="`/news/detail/001/新闻001/内容001`">{{news.title}}</RouterLink>
      
    • to 的对象写法

      必须通过 name 跳转

      <!-- 跳转并携带params参数(to的对象写法) -->
      <RouterLink 
        :to="{
          name:'xiang', 
          params:{
            id:news.id,
            title:news.title,
            content:news.title
          }
        }"
      >
        {{news.title}}
      </RouterLink>
      
  • 接收参数:

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

相关信息

  • 传递 params 参数时,若使用 to 的对象写法,必须使用 name 配置项,不能用 path
  • 传递 params 参数时,需要提前在规则中占位。
  • 如果参数没有响应式,可以使用 toRefs()

4.9. 【路由的 props 配置】

作用:让路由组件更方便的收到参数(可以将路由参数作为 props 传给组件)
底层相当于 <Detail a='' b=''>

路由的 props 的三种配置方法:

  • props 的 bool 值写法

    作用:把收到了每一组 params 参数,作为 props 传给 Detail 组件

    // /router/index.js
    {
    	name:'content',
    	path:'detail/:id/:title/:content',
    	component:Detail,
        props:true
    }
    

    接收参数:

    <template>
      <div>
        {{ id }}
        {{ title }}
        {{ content }}
      </div>
    </template>
    
    <script lang="ts" setup>
      defineProps(['id','title','content'])
    </script>
    
  • props 的函数写法

    可以自己决定将什么作为 props 给路由组件

    // /router/index.js
    {
    	name:'content',
    	path:'detail/:id/:title/:content',
    	component:Detail,
        props(route):{
            return route.query
        }
    }
    

    接收参数:

    <script lang="ts" setup>
      defineProps(['id','title','content'])
    </script>
    
  • props 的对象写法(用的少)

    可以自己决定将什么作为 props 给路由组件

    // /router/index.js
    {
    	name:'content',
    	path:'detail/:id/:title/:content',
    	component:Detail,
        props:{
          a:100,
          b:200
        }
    }
    

4.10. 【 replace 属性】

  1. 作用:控制路由跳转时操作浏览器历史记录的模式

  2. 浏览器的历史记录有两种写入方式:分别为pushreplace

    • push是追加历史记录(默认值)
    • replace是替换当前记录
  3. 开启replace模式:

    <RouterLink replace .......>News</RouterLink>
    

4.11. 【编程式导航】

编程式路由导航:脱离 <RouterLink>,使用 js 完成路由跳转(最常用)

路由组件的两个重要的属性:$route$router变成了两个 hooks

router.push() 方法中的参数与 to 的写法相同

  • 字符串写法
  • 对象写法

编程式路由导航实践:

import {useRoute,useRouter} from 'vue-router'

const route = useRoute()
const router = useRouter() // 获得路由器(导航的关键)

console.log(route.query)
console.log(route.parmas)
console.log(router.push)
console.log(router.replace)

onMounted(()=>{
    setTimeout(()=>{
        router.push('/content')
    },3000)
})

4.12. 【路由重定向】

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

  2. 具体编码:

    /* /router/index.js */
    {
        path:'/',
        redirect:'/about' // 在路径为 '/' 时,自动跳转到 '/about'
    }
    

5. pinia

5.1【介绍】

pinia 与 vue2 使用的 vuex 相似,目的是为了数据的集中管理,不同组件按需拿取数据

5.2【搭建 pinia 环境】

第一步:npm install pinia

第二步:操作 src/main.ts

import { createApp } from 'vue'
import App from './App.vue'

/* 引入createPinia,用于创建pinia */
import { createPinia } from 'pinia'

/* 创建pinia */
const pinia = createPinia()
const app = createApp(App)

/* 使用插件 */{}
app.use(pinia)
app.mount('#app')

此时开发者工具中已经有了 pinia 选项

5.3【存储 + 读取数据】

Store 是一个保存:状态业务逻辑 的实体,每个组件都可以 读取写入
它有三个概念:stategetteraction,相当于组件中的: datacomputedmethods

编码实现数据的存储:src/store/count.ts

  • 在 src 下创建 store 文件夹,存储组件对应的 js/ts 文件,建议:
    • 文件名与组件名对应
    • defineStore() 创建的对象名为 useXxxStore 的格式(hooks)
    • defineStore() 的第一个参数与文件名相同
/* src/store/count.ts */

// 引入 defineStore 用于创建 store
import {defineStore} from 'pinia'

// 定义并暴露一个store
export const useCountStore = defineStore('count',{ // 
  // 动作
  actions:{},
  // 状态
  state(){
    return { // 保存数据
      sum:6
    }
  },
  // 计算
  getters:{}
})

组件中读取 state 中的数据 src/component/Count.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>

相关信息

useSumStore() 方法返回的对象为 Proxy 对象,调用保存的数据名即可,自动为 ref 数据且无需 .value

5.4.【修改数据】(三种方式)

  1. 直接修改

    在 component 组件中直接修改

    countStore.sum = 666
    
  2. 批量修改

    在 component 组件中,通过引入的 store 对象的 $patch 方法,传入对象,可部分修改值

    countStore.$patch({
      sum:999,
      school:'atguigu'
    })
    
  3. 借助 action 修改(action中可以编写一些业务逻辑)

    /* src/store/count.ts */
    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
          }
        }
      },
      state(){
        return { // 保存数据
          sum:6
        }
      },
      // 计算
      getters:{}
    })
    

    组件中调用即可

    /* src/component/Count.ts */
    // 使用countStore
    const countStore = useCountStore()
    
    // 调用对应action
    countStore.incrementOdd(n.value)
    

5.5.【storeToRefs】

  • 借助storeToRefsstore中的数据转为ref对象,方便在模板中使用。
  • 注意:pinia提供的storeToRefs只会将数据做转换,而VuetoRefs会转换store中数据。
<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>

5.6.【getters】

  1. 概念:当state中的数据,需要经过处理后再使用时,可以使用 getters 配置。

  2. 追加 getters 配置。

    // 引入defineStore用于创建store
    import {defineStore} from 'pinia'
    
    // 定义并暴露一个store
    export const useCountStore = defineStore('count',{
      // 动作
      actions:{
        /************/
      },
      // 状态
      state(){
        return {
          sum:1,
          school:'atguigu'
        }
      },
      // 计算
      getters:{
        bigSum:(state):number => state.sum *10,
        upperSchool():string{
          return this. school.toUpperCase()
        }
      }
    })
    
  3. 组件中读取数据:

    const {increment,decrement} = countStore
    let {sum,school,bigSum,upperSchool} = storeToRefs(countStore)
    

5.7.【$subscribe】

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

talkStore.$subscribe((mutate,state)=>{
  console.log('LoveTalk',mutate,state)
  localStorage.setItem('talk',JSON.stringify(talkList.value))
})

案例:

/* src/store/talk.ts */
import {defineStore} from 'pinia'
import axios from 'axios'
import {nanoid} from 'nanoid'

export const useTalkStore = defineStore('talk',{
  actions:{
    async getATalk(){
      // 发请求,下面这行的写法是:连续解构赋值+重命名
      let {data:{content:title}} = await axios.get('https://api.test/')
      // 把请求回来的字符串,包装成一个对象
      let obj = {id:nanoid(),title}
      // 放到数组中
      this.talkList.unshift(obj)
    }
  },
  // 真正存储数据的地方
  state(){
    return {
      talkList:JSON.parse(localStorage.getItem('talkList') as string) || []
    }
  }
})
/* src/conpoment/talk.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('talkStore 里面保存的数据发生了变化',mutate,state)
    localStorage.setItem('talkList',JSON.stringify(state.talkList))
  })
  
  // 方法
  function getLoveTalk(){
    talkStore.getATalk()
  }
</script>

5.8. 【store组合式写法】

store 除了选项式写法,也支持组合是写法

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.test/')
    // 把请求回来的字符串,包装成一个对象
    let obj = {id:nanoid(),title}
    // 放到数组中
    talkList.unshift(obj)
  }
  return {talkList,getATalk}
})

6. 组件通信

Vue3 组件通信和 Vue2 的区别:

  • 移除事件总线,使用 mitt 代替。
  • vuex 换成了 pinia
  • .sync 优化到了 v-model
  • $listeners 所有的东西,合并到 $attrs 中了。
  • $children 被砍掉了

6.1. 【props】

概述:props 是使用频率最高的一种通信方式,常用与 :父 ↔ 子(父子之间的通信)

  • 父传子:属性值是 非函数
  • 子传父:属性值是 函数

父组件向子组件通过 props 传值时,值对子组件是可读的,不可修改,修改需要在父组件修改

举例,父组件:

<template>
  <div class="father">
    <h3>父组件,</h3>
		<h4>我的车:{{ car }}</h4>
		<h4>儿子给的玩具:{{ toy }}</h4>
		<Child :car="car" :getToy="getToy" a="a"/> <!-- 将数据 car,a 和方法 getToy() 传给子 -->
  </div>
</template>

<script setup lang="ts" name="Father">
	import Child from './Child.vue'
	import { ref } from "vue";
	// 数据
	const car = ref('奔驰')
	const toy = ref()
    let a = ref(10)
	// 方法
	function getToy(value:string){
		toy.value = value // 子组件调用方法,赋值给父组件的数据
	}
</script>

子组件

<template>
  <div class="child">
    <h3>子组件</h3>
		<h4>我的玩具:{{ toy }}</h4>
		<h4>父给我的车:{{ car }}</h4>
		<button @click="getToy(toy)">玩具给父亲</button> <!-- 调用方法 -->
      	<button @click="a++"> 修改 a 的值 </button> <!-- 报错,a 只读 -->
  </div>
</template>

<script setup lang="ts" name="Child">
	import { ref } from "vue";
	const toy = ref('奥特曼')
	
	defineProps(['car','getToy','a']) // 获得父组件的 car,a 数据,getToy 方法
</script>

6.2. 【自定义事件】

  1. 概述:自定义事件常用于:子 => 父
  2. 注意区分:原生事件、自定义事件
  • 原生事件:
    • 事件名是特定的( clickmosueenter 等等)
    • 事件对象 $event : 是包含事件相关信息的对象(pageXpageYtargetkeyCode
  • 自定义事件:
    • 事件名是任意名称,推荐命名为多个单词,使用 - 连接
    • 事件对象 $event: 是调用 emit 时所提供的数据,可以是任意类型!!!
    • 事件对象 $event 在原生事件与自定义事件中都存在

自定义事件案例:

  • 事件绑定

    <!-- component/Father.vue -->
    <template>
        <!-- 事件名为 abc,事件的回调:xyz() 方法 -->
    	<!-- 给子组件绑定了事件 abc,回调为 xyz() -->
        <Child @abc="xyz"/>
    </template>
    <script setup name = "Father" lang="ts">
      import Child from "@/components/Child.vue"
        // 事件的回调
    	function xyz(value:number){
            console.log(value)
        }
    </script>
    
  • 事件触发

    <!-- <!-- component/Child.vue --> -->
    <template>  
    </template>
    <script lang="ts" setup>
    import { onMounted } from 'vue';
      const emit = defineEmits(['abc']) // 接受自定义事件,名称一般都为 emit
      onMounted(() => {
        setTimeout(() => {
          emit('abc',123) // 在合适时机调用事件 emit('事件名',传递参数)
        }, 3000)
      });
    </script>
    
  1. 示例:

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

6.3. 【mitt】

概述:与消息订阅与发布( pubsub )功能类似,可以实现 任意组件 间通信

相关信息

发送者触发事件,接受者绑定事件

建议在组件销毁时,解绑事件

安装 mitt

npm i mitt

新建文件:src\utils\emitter.ts,创建 mitt 配置文件

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

// 创建emitter
const emitter = mitt()

// 默认暴露
export default emitter

emitter 的语法:

// 引入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.off('test') // 解绑 test1 事件
    // 清理事件
    // emitter.all 获取所有事件
    emitter.all.clear()
  }, 3000); 

// 创建并暴露mitt
export default emitter

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

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

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

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

组件间通信案例:

  • A 组件

    <!-- component/A.vue -->
    <template>
    	<!-- 事件名:eventName
    		传递数据:data
    		点击按钮时,触发事件,将 data 传递给绑定 eventName 的组件
    	-->
        <button @click="emitter.emit('eventName',data)">组件传值</button>
    </template>
    <script setup name = "Father" lang="ts">
        import { ref } from 'vue';
        import emitter from '@/utils/emitter';
        let data = ref('数据')
    </script>
    
  • B 组件

    <template>
        {{ getData }}
    </template>
    
    <script lang="ts" setup>
        import { ref,onUnmounted } from 'vue';
        import emitter from '@/utils/emitter';
        let getData = ref('123')
        emitter.on('eventName',(value:any) => { // 绑定事件,拿到数据
          getData.value = value
        })
        onUnmounted(()=>{ // 组件销毁时 解绑事件
          emitter.off('eventName')
        })
    </script>
    

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

6.4.【v-model】

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

  2. 前序知识 —— v-model 的本质::value + @input 事件

    <!-- 使用v-model指令 -->
    <input type="text" v-model="userName">
    
    <!-- v-model 的本质是下面这行代码 -->
    <!-- 
    	:value="userName" -> 实现数据到页面的绑定(v-bind)
    	@input="userName =(<HTMLInputElement>$event.target).value" -> 实现页面到数据的绑定(输入事件)
    -->
    <input 
      type="text" 
      :value="userName"
      @input="userName =(<HTMLInputElement>$event.target).value"
    >
    
  3. 组件标签上的 v-model 的本质::moldeValueupdate:modelValue事件

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

    AtguiguInput组件中:

    <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

    <!-- 也可以更换 value,例如改成 abc-->
    <AtguiguInput v-model:abc="userName"/>
    
    <!-- 上面代码的本质如下 -->
    <AtguiguInput :abc="userName" @update:abc="userName = $event"/>
    
    <!-- 相当于给子组件传递了 props,并添加自定义方法 update:abc -->
    

    AtguiguInput组件中:

    <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

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

6.5.【$attrs 】

  1. 概述:$attrs 用于实现 当前组件的父组件,向 当前组件的子组件 通信(祖→孙)。

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

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

$attrs 使用举例:

父组件(使用 props 向子组件传递,传递方法可以实现 孙 -> 父):

<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>

子组件(向孙组件传递 $attrs):

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

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

孙组件(使用 defineProps([]) 接受):

<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>

6.6. 【refsrefs、parent】

  1. 概述:

    • $refs 用于 :父 → 子。
    • $parent用于:子 → 父。
  2. 原理如下:

    属性说明
    $refs值为对象,包含所有被 ref 属性标识的 DOM 元素组件实例
    $parent值为对象,当前组件(子组件)的父组件 实例 对象

使用案例:

<!-- Father.vue -->
<template>
	<div class="father">
		<h3>父组件</h3>
		<h4>房产:{{ house }}</h4>
		<button @click="changeToy">修改 Child1 的玩具</button>
		<button @click="changeComputer">修改 Child2 的电脑</button>
		<button @click="getAllChild($refs)">让所有孩子的书变多</button> <!-- 获取所有子组件的引用 -->
		<Child1 ref="c1"/> <!-- 使用 ref 获得子组件的引用 -->
		<Child2 ref="c2"/>
	</div>
</template>

<script setup lang="ts" name="Father">
	import Child1 from './Child1.vue'
	import Child2 from './Child2.vue'
	import { ref,reactive } from "vue";
	let c1 = ref()
	let c2 = ref()

	// 数据
	let house = ref(4)
	// 方法
	function changeToy(){
		c1.value.toy = '小猪佩奇' // 修改子组件(Child1)的 toy 属性
	}
	function changeComputer(){
		c2.value.computer = '华为' // 修改子组件(Child2)的 computer 属性
	}
	function getAllChild(refs:{[key:string]:any}){
		console.log(refs)
		for (let key in refs){
			refs[key].book += 3
		}
	}
	// 向外部提供数据
	defineExpose({house})
</script>
<!-- Child1.vue -->
<template>
  <div class="child1">
    <h3>子组件1</h3>
		<h4>玩具:{{ toy }}</h4>
		<h4>书籍:{{ book }} 本</h4>
		<button @click="minusHouse($parent)">干掉父亲的一套房产</button>
  </div>
</template>
<script setup lang="ts" name="Child1">
	import { ref } from "vue";
	// 数据
	let toy = ref('奥特曼')
	let book = ref(3)
	// 方法
	function minusHouse(parent:any){
		parent.house -= 1
	}
	// 把数据交给外部
	defineExpose({toy,book})
</script>
<!-- Child2.vue -->
<template>
  <div class="child2">
    <h3>子组件2</h3>
		<h4>电脑:{{ computer }}</h4>
		<h4>书籍:{{ book }} 本</h4>
  </div>
</template>
<script setup lang="ts" name="Child2">
		import { ref } from "vue";
		// 数据
		let computer = ref('联想')
		let book = ref(6)
		// 把数据交给外部
		defineExpose({computer,book})
</script>

6.7. 【provide、inject】

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

  2. 具体使用:

    • 在祖先组件中通过 provide 配置向后代组件 提供数据
    • 在后代组件中通过 inject 配置来声明 接收数据
  3. 具体编码:

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

    <!-- Father.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配置项接受数据。

    <!-- GrandChild.vue -->
    <template>+0
      <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>
    

6.8. 【pinia】

参考前文

6.9. 【slot】

slot 插槽的作用:将组件多标签内的内容插入到原组件中

1. 默认插槽

默认插槽可以将组件中的内容放入原组件的单独位置(默认插槽的名称为 default)

父组件:
    <Category title="游戏">
      <!-- 将组件中内容放入原组件中 -->
      <ul>
        <li v-for="g in games" :key="g.id">{{ g.name }}</li>
      </ul>
    </Category>
子组件中:
        <template>
          <div class="item">
            <h3>{{ title }}</h3>
            <!-- 默认插槽 -->
            <slot></slot>
          </div>
        </template>

2. 具名插槽

当组件中的不同内容放入原组件中的不同位置,使用具名插槽

具名插槽,名称定义:

  • 在标签上写 v-slot:xxx 或简写为 #xxx

插槽使用:

  • <slot name="xxx"></slot>
父组件中:
        <Category title="今日热门游戏">
          <template v-slot:s1>
            <ul>
              <li v-for="g in games" :key="g.id">{{ g.name }}</li>
            </ul>
          </template>
          <template #s2>
            <a href="">更多</a>
          </template>
        </Category>
子组件中:
        <template>
          <div class="item">
            <h3>{{ title }}</h3>
            <slot name="s1"></slot>
            <slot name="s2"></slot>
          </div>
        </template>

3. 作用域插槽

用于数据在子组件,数据生成的结构由父组件(组件的使用者)决定

接受子组件 slot 传递的所有的 props v-slot="params"

带有名字的插槽:

  • <slot name="myName" :test="data"></slot>
  • <Component v-slot:myName="param">{{ param.test}}</Component>

编码案例:

父组件中:
	  <!-- params 为子组件 slot 传递的所有 props -->
      <Game v-slot="params">
      <!-- <Game v-slot:default="params"> -->
      <!-- <Game #default="params"> -->
        <ul>
          <li v-for="g in params.games" :key="g.id">{{ g.name }}</li>
        </ul>
      </Game>

子组件中:
      <template>
        <div class="category">
          <h2>game</h2>
          <!-- 使用 props 给父组件(插槽使用者)传值 -->
          <slot :games="games" a="哈哈"></slot>
        </div>
      </template>

      <script setup lang="ts" name="Category">
        import {reactive} from 'vue'
        let games = reactive([
          {id:'asgdytsa01',name:'英雄联盟'},
          {id:'asgdytsa02',name:'王者荣耀'},
          {id:'asgdytsa03',name:'红色警戒'},
          {id:'asgdytsa04',name:'斗罗大陆'}
        ])
      </script>

7. 其它 API

7.1.【shallowRef 与 shallowReactive 】

shallowRef

  1. 作用:创建一个响应式数据,但只对顶层属性进行响应式处理。

  2. 用法:

    let myVar = shallowRef(initialValue);
    
  3. 特点:只跟踪引用值的变化,不关心值内部的属性变化。

shallowReactive

  1. 作用:创建一个浅层响应式对象,只会使对象的最顶层属性变成响应式的,对象内部的嵌套属性则不会变成响应式的

  2. 用法:

    const myObj = shallowReactive({ ... });
    
  3. 特点:对象的顶层属性是响应式的,但嵌套对象的属性不是。

通过使用 shallowRef()shallowReactive() 来绕开深度响应
浅层式 API 创建的状态只在其顶层是响应式的,对所有深层的对象不会做任何处理,避免了对每一个内部属性做响应式所带来的性能成本,这使得属性的访问变得更快,可提升性能。

7.2.【readonly 与 shallowReadonly】

readonly:

  1. 作用:用于创建一个对象的深只读副本。

  2. 用法:

    const original = reactive({ ... });
    const readOnlyCopy = readonly(original);
    
  3. 特点:

    • 对象的 所有 嵌套属性都将变为只读。
    • 任何尝试修改这个对象的操作都会被阻止(在开发模式下,还会在控制台中发出警告)
  4. 应用场景:

    • 创建不可变的状态快照。
    • 保护全局状态或配置不被修改。

shallowReadonly:

  1. 作用:与 readonly 类似,但只作用于对象的顶层属性。

  2. 用法:

    const original = reactive({ ... });
    const shallowReadOnlyCopy = shallowReadonly(original);
    
  3. 特点:

    • 只将对象的顶层属性设置为只读,对象内部的嵌套属性仍然是可变的。

    • 适用于只需保护对象顶层属性的场景。

7.3.【toRaw 与 markRaw】

toRaw:

  1. 作用:用于获取一个响应式对象的原始对象, toRaw 返回的对象不再是响应式的,不会触发视图更新

    官网描述:这是一个可以用于临时读取而不引起代理访问/跟踪开销,或是写入而不触发更改的特殊方法。不建议保存对原始对象的持久引用,请谨慎使用。

    在需要将响应式对象传递给非 Vue 的库或外部系统时,使用 toRaw 可以确保它们收到的是普通对象

  2. 具体编码:

    import { reactive,toRaw,markRaw,isReactive } from "vue";
    
    /* toRaw */
    // 响应式对象
    let person = reactive({name:'tony',age:18})
    // 原始对象
    let rawPerson = toRaw(person)
    

markRaw:

  1. 作用:标记一个对象,使其 永远不会 变成响应式的。

    例如使用 mockjs 时,为了防止误把 mockjs 变为响应式对象,可以使用 markRaw 去标记 mockjs

  2. 编码:

    /* markRaw */
    let citys = markRaw([
      {id:'asdda01',name:'北京'},
      {id:'asdda02',name:'上海'},
      {id:'asdda03',name:'天津'},
      {id:'asdda04',name:'重庆'}
    ])
    // 根据原始对象 citys 去创建响应式对象 citys2 —— 创建失败,因为 citys 被 markRaw 标记了
    let citys2 = reactive(citys)
    

7.4.【customRef】

作用:**自定义 ref **,并对其依赖项跟踪和更新触发进行逻辑控制。

实现防抖效果(useSumRef.ts):

import {customRef } from "vue";

export default function(initValue:string,delay:number){
  let msg = customRef((track,trigger)=>{
    let timer:number
    return {
      get(){
        track() // 告诉 Vue 数据 msg 很重要,要对 msg 持续关注,一旦变化就更新
        return initValue
      },
      set(value){
        clearTimeout(timer)
        timer = setTimeout(() => {
          initValue = value
          trigger() //通知 Vue 数据 msg 变化了
        }, delay);
      }
    }
  }) 
  return {msg}
}

8. Vue3 新组件

8.1. 【Teleport】

  • 什么是 Teleport?—— Teleport 是一种能够将我们的 组件 html 结构 移动到指定位置的技术。
<teleport to='body' >
    <div class="modal" v-show="isShow">
      <h2>我是一个弹窗</h2>
      <p>我是弹窗中的一些内容</p>
      <button @click="isShow = false">关闭弹窗</button>
    </div>
</teleport>

8.2. 【Suspense】

  • 等待异步组件时渲染一些额外内容,让应用有更好的用户体验
  • 使用步骤:
    • 异步引入组件
    • 使用 Suspense 包裹组件,并配置好 defaultfallback
import { defineAsyncComponent,Suspense } from "vue";
const Child = defineAsyncComponent(()=>import('./Child.vue'))
<template>
    <div class="app">
        <h3>我是 App 组件</h3>
        <Suspense>
          <template v-slot:default>
            <Child/>
          </template>
          <template v-slot:fallback>
            <h3>加载中.......</h3>
          </template>
        </Suspense>
    </div>
</template>

8.3.【全局 API 转移到应用对象】

  • app.component
  • app.config
  • app.directive
  • app.mount
  • app.unmount
  • app.use

8.4.【其他】

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

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

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

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

  • 移除了$on$off$once 实例方法。

  • 移除了过滤器 filter

  • 移除了$children 实例 propert

    ......

评论
  • 按正序
  • 按倒序
  • 按热度
Powered by Waline v2.15.5