【Vue3】（三）vue3中的pinia状态管理、组件通信方式及总结、插槽

简化的API、更好的TypeScript集成、开箱即用的DevTools集成、模块化和灵活性、易于测试、轻量级、持久化和插件支持
Pinia提供了一个更加直观和简洁的API，使得状态管理变得更加容易理解和实施。对于开发者来说，这意味着更少的学习曲线和更快的开发速度。由于Pinia自底向上设计了对TypeScript的支持，使用TypeScript的开发者将会享受到无缝的类型推导和更少的类型断言。Pinia与Vue DevTools的集成提供了更好的调试体验，允许开发者轻松追踪和操作状态，从而提高开发效率。Pinia支持将状态分割为不同的模块，使得状态管理在大型应用中更加清晰和可维护。此外，它的灵活性允许你根据需要轻松地添加插件和中间件。由于Pinia的设计，编写单元测试变得更加直观。你可以轻松地模拟actions和测试state的变更。Pinia的代码库比Vuex更小，对于注重应用大小的项目来说，这是一个明显的优势。Pinia支持通过插件来扩展其功能，例如状态持久化，这使得在浏览器刷新或关闭后恢复用户状态变得简单。

综上所述，Pinia为开发Vue应用的状态管理提供了一个现代化、高效和灵活的解决方案。随着Vue 3的推进，Pinia正在成为越来越多Vue开发者的首选状态管理库。

4、安装pinia

1、安装依赖

安装pinia依赖：npm i pinia

2、项目配置

目录：main.ts

// 引入pinia
import { createPinia } from "pinia";
// 创建pinia
const pinia = createPinia()
// 安装pinia
app.use(pinia)

3、存储/读取pinia中的数据

（1）在src下创建store目录

（2）在store目录下创建ts文件（最好能明确地看出属于哪个组件使用）

例如：count.ts

import { defineStore } from "pinia";
// 官方推荐使用Hooks的方式命名
export const useCountStore = defineStore('count',{
  // 状态/数据（官方要求必须写成一个函数）
  // state: 真正存储数据的地方（类似于Vue2中的data）
  state(){
    return{
      sum: 6
    }
  }
})

（3）读取pinia中的值

// 类似Hooks的思想
import { useCountStore } from "@/store/count";

const countStore = useCountStore()

// 以下两种方式都可以拿到state中的数据
console.log('countStore', countStore.sum)
console.log('countStore', countStore.$state.sum)

4、修改pinia中的数据

（1）修改单个数据：直接修改

 countStore.sum += 1

（2）修改多个数据：$patch 批量修改

countStore.$patch({
  sum:888,
  address:'陕西',
  city:'西安'
})

（1）和（2）的区别：方法（1）在修改多个数据的时候，会触发多个mutatuons事件，但是方法（2）在修改数据的时候，只会触发一个$patch事件

（3）使用action修改数据：处理复杂数据时使用

需要在pinia中定义action函数

export const useCountStore = defineStore('count',{
  // actions里面放置的是一个一个的方法，用于响应组件中的动作
  actions:{
    increment(value){
      console.log('increment被调用了',value)
      // 修改数据
      // this是当前的store
      console.log('this.sum', this.sum)
      this.sum += value
    }
  },
  // 状态/数据（官方要求必须写成一个函数）
  // state: 真正存储数据的地方（类似于Vue2中的data）
  state(){
    return{
      sum: 6,
      city:'山西',
      address: '未知'
    }
  }
})

使用action中定义的修改数据的函数

 // 第三种修改数据的方式：使用action属性修改数据
    countStore.increment(n.value)

5、storeToRefs（保持store中数据的响应式）

toRefs会将所包裹的数据全部变成ref对象，包括数据和方法，在这里不适用（vue3自带的）
storeToRefs只会关注store中的数据，不会对方法进行ref包裹（pinia自带的）

import { storeToRefs } from "pinia";
// 解构赋值countStore中的数据
// 1、为了保证数据的响应式，需要使用storeToRefs
// 2、storeToRefs只会关注store中的数据，不会对方法进行ref包裹
const {sum,city,address} = storeToRefs(countStore)

6、getters

概念：当state中的数据，需要经过处理后再使用，可以使用getters配置。

在store中追加getters配置

export const useCountStore = defineStore('count',{
  // state: 真正存储数据的地方（类似于Vue2中的data）
  state(){
    return{
      sum: 6,
      city:'山西',
      address: 'chinese'
    }
  },
  // 配置getters
  getters:{
    // 写法一：
    bigSum:(state)=>{
      return state.sum * 10
    },
    // 写法二：
    upperaddress(){
      // this可以拿到当前这个store对象
      console.log('this', this)
      return this.address.toUpperCase()
    }
  }
})

使用getters处理后的数据

<template>
  <div class="count">
    <h2>当前求和为：{{ sum }}，放大10倍后：{{ bigSum }}</h2>
    <h2>当前地址为：{{ address }}，转换成大写后：{{ upperaddress }}</h2>
  </div>
</template>

<script setup lang="ts">
import { ref } from "vue";
// Hooks的思想
import { useCountStore } from "@/store/count";
import { storeToRefs } from "pinia";

const countStore = useCountStore();

// 解构赋值countStore中的数据
// 1、为了保证数据的响应式，需要使用storeToRefs
// 2、storeToRefs只会关注store中的数据，不会对方法进行ref包裹
const { sum, city, address, bigSum, upperaddress } = storeToRefs(countStore);

</script>

7、监听store中数据的变化：$subscribe

订阅方法的使用:类似watch属性，可以监听state及其变化
两个参数：本次修改的信息；真正的数据

talkStore.$subscribe((mutate, state) => {
  console.log("$subscribe监听事件的变化", mutate, state);
  // 实现一个无感刷新数据的方法
  localStorage.setItem('talkList',JSON.stringify(state.talkList))  // 将数据存到本地存储
});

8、store的组合式写法

export const useTalkStore = defineStore('talk', () => {
  // 直接定义的数据，相当于state
  const talkList = reactive(
    JSON.parse(localStorage.getItem('talkList') as string) || []
  )
  // 直接定义的方法，就相当于action
  async function getATalk() {
    // 发请求
    // {data:{content:title}} => 这个写法的意思是：将返回的结果对象赋值给data，然后再结构data给content，最后再把content赋值给title
    let {
      data: { content: title },
    } = await axios.get("https://api.uomg.com/api/rand.qinghua?fromat=json");
    // 将请求回来的字符串包装成一个对象
    let obj = { id: nanoid(), title };
    console.log("obj", obj);
    talkList.unshift(obj);
  }

  // 注意：最后一定要return，要不然没法使用
  return {talkList,getATalk}
})

二、【props】传参

概述：props是使用频率最高的一种通信方式。作用：父传子、子传父

若父传子：属性值是非函数（变量）
若子传父：属性值是函数（方法）

父组件：

<template>
  <div class="father">
    <h3>父组件1</h3>
    <h4>父亲的车：{{ car }}</h4>
    <!-- 父传子【参数】：使用 属性传参 的方式传递参数 -->
    <!-- 父传子【方法】：使用 属性传参 的方式传递参数-->
    <h5>父组件接收到子组件的参数：{{ sonParams }}</h5>
    <Child :dirver="car" :sendSon="getSonParams"/>
  </div>
</template>
<script setup lang="ts" name="father">
import Child from "./Child.vue";
import { ref } from "vue";

let car = ref('小米')
let sonParams = ref()

// 方法
function getSonParams(params:type) {
  console.log('params', params)
  sonParams.value = params
}
</script>

子组件：

<template>
  <div class="child"> 
    <h3>子组件2</h3>
    <h4>儿子的玩具：{{ toy }}</h4>
    <!-- 子组件使用父组件参数 -->
    <h5>子组件拿到父组件的参数:{{ dirver }}</h5>
    <!-- 复杂写法 -->
    <button @click="handleFatherFun">方法1：触发父组件的方法实例</button>
    <br />
    <button @click="sendSon(toy)">方法2：把子组件的参数传递给父组件</button>
  </div>
</template>
<script setup lang="ts" name="Child">
import { ref } from "vue";

let toy = ref('奥特曼') 

// 子组件接收：声名接收函数:defineProps 数组
let props = defineProps(['dirver','sendSon'])

function handleFatherFun(params:type) {
  // 使用props.拿到父组件传递的参数
  props.sendSon(toy.value)
}
</script>

图解代码：

三、【自定义事件】传参

在 Vue3 中，自定义事件是一种常用的机制，用于在组件之间传递数据。通过自定义事件，子组件可以向父组件发送数据，从而实现组件间的通信。

父组件：

<template>
  <div>
    <h3>父组件</h3>
    <!-- 给子组件Child绑定事件 -->
    <h4 v-show="toy">子给的玩具：{{ toy }}</h4>
    <!-- 官方推荐：自定义事件使用kabab-case的事件名（a-b） -->
    <Child @send-toy="saveToy"/>
  </div>
</template>

<script setup lang="ts">
import Child from "./child.vue";
import { ref } from "vue";

let toy = ref('')
// 用于处理子组件传递过来的数据
function saveToy(value:any) {
  console.log('saveToy', value)
  toy.value = value
}
</script>

子组件：

<template>
  <div class="child">
    <h3>子组件</h3>
    <h4>玩具：{{ toy }}</h4>
    <button @click="emit('send-toy',toy)"></button>
  </div>
</template>

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

let toy = ref('奥特曼')
// 声明事件
let emit = defineEmits(['send-toy'])
</script>

图解代码：

四、【mitt】传参

1、认识mitt

mitt是vue3提供的一个工具，能够实现跨组件通信

下载mitt依赖：npm i mitt

① 创建mitt文件目录

目录地址：src/utils/emitter.ts

② 创建mitt对象

src/utils/emitter.ts

// 引入itt
import mitt from 'mitt'
// 调用mitt，得到emitter，emitter能：绑定事件，触发事件
const emitter = mitt()
// 暴露emitter
export default emitter

③ 项目引入mitt（例如：main.ts）

// 引入mitt
import emitter from "@/utils/emitter";

④ mitt语法介绍

// 绑定事件
emitter.on('tast1',()=>{
  console.log('tast1被触发了')
})

emitter.on('tast2',()=>{
  console.log('tast2被触发了')
})

// 触发事件
setTimeout(() => {
  emitter.emit('tast1')
  emitter.emit('tast2')
}, 1000);

// 解除事件
setTimeout(() => {
  // 清除单个事件
  emitter.off('tast1')
  // 清除所有事件
  emitter.all.clear()
}, 3000);

2、使用mitt

组件1：

<template>
  <div class="child1">
    <h2>子组件1</h2>
    <h3>玩具：{{ toy }}</h3>
    <button @click="emitter.emit('send-toy',toy)">玩具给Childe2玩</button>
  </div>
</template>

<script setup lang="ts">
import { ref } from "vue";
import emitter from "@/utils/emitter";

let toy = ref('奥特曼')
</script>

组件2：

<template>
  <div class="child2">
    <h2>子组件2</h2>
    <h3>电脑：{{ computer }}</h3>
    <h4>Child1传递的玩具{{ toy }}</h4>
  </div>
</template>

<script setup lang="ts">
import { ref,onUnmounted } from "vue";
import emitter from "@/utils/emitter";
// 数据
let computer = ref('联想')
let toy = ref()

// 给emitter绑定send-toy事件
emitter.on('send-toy',(value:any)=>{
  console.log('send-toy',value)
  toy.value = value
})
// 在组件卸载时，解绑emitter
onUnmounted(()=>{
  emitter.all.clear()
})
</script>

图解代码：

注意：当绑定事件的组件卸载时，最好清除掉emitter绑定的事件，防止内存占用

五、【v-model】传参（平常基本不写）

v-model传参方式一般适用于UI组件库底层的传参使用，所以，这里不做具体介绍，只说明底层原理，平常用的时候还是使用v-model即可

父组件：

<template>
  <div class="father">
    <h3>父组件</h3>
    <!-- v-model用在html标签上 -->
    <!-- <input type="text" v-model="userName"/> -->
    <!-- v-model的底层原理: -->
    <!-- <input type="text" :value="userName" @input="userName = (<HTMLInputElement>$event.target).value"> -->

    <!-- v-model用在组件标签上 -->
    <!-- <Zhang v-model="userName"/> -->
    <!-- v-model实现组件传参的基本原理： -->
    <Zhang 
      :modelValue="userName" 
      @update:modelValue="userName = $event"
    />

  </div>
</template>

<script setup lang="ts">
import { ref } from "vue";
import Zhang from "./zhang.vue";
// 数据
let userName = ref('张三')
</script>

子组件：

<template>
  <div>
    <h2>子组件</h2>
    <input 
      type="text" 
      :value="modelValue"
      @input="emits('update:modelValue',(<HTMLInputElement>$event.target).value)"
    />
  </div>
</template>

<script setup lang="ts">
defineProps(['modelValue'])
const emits = defineEmits(['update:modelValue'])
</script>

拓展：

修改v-model的事件名称

六、【$attrs】传参

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

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

注意：$attrs会自动排除props中声明的属性（可以任务声明过的props被子组件自己“消费”了），也就是说：当父（祖-父-子）组件中以props的方式使用了某个属性，在子组件中就不能使用这个属性了
// 如果在父组件中用defineProps接收了a参数，那么a参数就没法继续传递了
defineProps(['a'])

祖组件：

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

<script setup lang="ts">
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>

父组件：

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

<script setup lang="ts">
import GrandChild from "./grandChild.vue";
// 如果这里在defineProps接收了a参数，那么a参数就没法继续传递了
defineProps(['a'])
</script>

孙组件：

<template>
  <div class="grand-child">
    <h2>孙组件</h2>
    <h4>a:{{ a }}</h4>
    <h4>b:{{ b }}</h4>
    <h4>c:{{ c }}</h4>
    <h4>d:{{ d }}</h4>
    <button @click="updateA(6)">点我将爷爷组件中的a更新</button>
  </div>
</template>

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

七、【$refs和$parent】传参

1、概述

$refs：用于父→子
$parent：用于子→父

2、原理

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

3、组件使用实例

父组件：

<template>
  <div class="father">
    <h2>父组件</h2>
    <h4>房产：{{ house }}</h4>
    <button @click="changeToy">修改Child1的玩具</button>
    <button @click="changeComputer">修改Child2的电脑</button>
    <button @click="getAllChild($refs)">所有孩子的书增加</button>
    <Child1 ref="c1" />
    <Child2 ref="c2" />
  </div>
</template>

<script setup lang="ts">
import { ref } from "vue";
import Child1 from "./child1.vue";
import Child2 from "./child2.vue";

// 数据
let house = ref(4);
let c1 = ref();
let c2 = ref();

function changeToy() {
  console.log("c1.value", c1.value);
  c1.value.toy = "小猪佩奇";
}

function changeComputer() {
  console.log("c2.value", c2.value);
  c2.value.toy = "华为";
}

function getAllChild(refs: { [key:string]: any }) {
  console.log("所有子组件", refs);
  for (const key in refs) {
    console.log("refs", refs[key]);
    refs[key].book += 3;
  }
}

defineExpose({house})
</script>

子组件1：

<template>
  <div class="child1">
    <h2>子组件1</h2>
    <h4>玩具：{{ toy }}</h4>
    <h4>书籍：{{ book }}本</h4>
    <button @click="minusHouse($parent)">干掉父组件的一套房产</button>
  </div>
</template>

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

// 数据
let toy = ref('奥特曼')
let book = ref(3)

function minusHouse(parent:any) {
  console.log('parent', parent)
  parent.house -= 1 
}

// 把数据交给外部
defineExpose({toy,book})
</script>

子组件2：

<template>
  <div class="child2">
    <h2>子组件2</h2>
    <h4>电脑：{{ computer }}</h4>
    <h4>玩具：{{ book }}</h4>
  </div>
</template>

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

// 数据
let computer = ref('联想')

let book = ref('奥特曼')

// 把数据交给外部
defineExpose({computer,book})
</script>

4、$refs和$parent使用精髓

在父组件中，给子组件绑定ref属性，通过$refs可以获取到所有的子组件实例

在子组件，只有通过defineExpose宏函数，将想要暴露的数据暴露出去，父组件才能拿到数据

八、provide和inject

能够完全实现不借助于中间组件跨组件通信

父组件：

<template>
  <div class="father">
    <h2>父组件</h2>
    <h3>银子：{{ money }}元</h3>
    <h3>车子：一辆{{car.brand}},价值：{{car.price}}万元</h3>
    <Child />
  </div>
</template>

<script setup lang="ts">
import Child from "./child.vue";
import { ref, reactive, provide } from "vue";

let money = ref(100);
let car = reactive({
  brand: "奔驰",
  price: 1000,
});
// 孙组件修改祖先组件的money数据
function updateMoney(value: number) {
  money.value -= value;
}

// provide传参：向后代提供数据
provide("moneyContext", { money, updateMoney });
provide("car", car);
</script>

子组件：

<template>
  <div class="grandChild">
    <h2>孙组件</h2>
    <h3>父组件【银子】：{{ fatherMoney }}</h3>
    <h3>父组件【车子】：一辆{{fatherCar.brand}},价值：{{fatherCar.price}}万元</h3>
    <button @click="updateMoney(6)">修改money</button>
  </div>
</template>

<script setup lang="ts">
import { inject } from "vue";

let { fatherMoney, updateMoney } = inject("moneyContext", {
  fatherMoney: 0,
  updateMoney: (value:number) => {},
});
let fatherCar = inject("car", { brand: "未知", price: "未知" });
</script>

九、slot插槽

插槽的用途就和它的名字一样：有一个缺槽，我们可以插入一些东西。

插槽 slot 通常用于两个父子组件之间，最常见的应用就是我们使用一些 UI 组件库中的弹窗组件时，弹窗组件的内容是可以让我们自定义的，这就是使用了插槽的原理。

1、默认插槽

父组件：

<template>
  <div class="father">
    <h2>父组件</h2>
    <div class="content">
      <!-- 默认插槽 -->
      <Category title="热门游戏列表">
        <ul>
          <li v-for="item in games"
              :key="item.id">{{ item.name }}</li>
        </ul>
      </Category>
    </div>
  </div>
</template>

<script setup lang="ts">
import Category from "./category.vue";
import { ref, reactive } from "vue";

let games = reactive([
  { id: "adadada01", name: "英雄联盟" },
  { id: "adadada02", name: "穿越火线" },
  { id: "adadada03", name: "红色警戒" },
  { id: "adadada04", name: "王者农药" },
]);

let imgUrl = ref("https://z1.ax1x.com/2023/11/19/piNxLo4.jpg");

let videoUrl = ref("http://clips.vorwaerts-gmbh.de/big_buck_bunny.mp4");
</script>

子组件：

<template>
  <div class="category">
    <h2>{{ title }}</h2>
    <!-- 默认插槽 -->
    <slot>默认插槽</slot>
  </div>
</template>

<script setup lang="ts" name="Category">
defineProps(["title"]);
</script>

2、具名插槽

父组件：

<template>
  <div class="father">
    <h2>父组件</h2>
    <div class="content">
      <!-- 具名插槽 -->
      <Category title="热门游戏列表">
        <template v-slot:s2>
          <ul>
            <li v-for="item in games"
                :key="item.id">{{ item.name }}</li>
          </ul>
        </template>
        <template v-slot:s1>
          <h3>描述信息</h3>
        </template>
      </Category>
    </div>
  </div>
</template>

<script setup lang="ts">
import Category from "./category.vue";
import { ref, reactive } from "vue";

let games = reactive([
  { id: "adadada01", name: "英雄联盟" },
  { id: "adadada02", name: "穿越火线" },
  { id: "adadada03", name: "红色警戒" },
  { id: "adadada04", name: "王者农药" },
]);

let imgUrl = ref("https://z1.ax1x.com/2023/11/19/piNxLo4.jpg");

let videoUrl = ref("http://clips.vorwaerts-gmbh.de/big_buck_bunny.mp4");
</script>

<style lang="scss" scoped>

子组件：

<template>
  <div class="category">
    <h2>{{ title }}</h2>
    <!-- 具名插槽 -->
    <slot name="s1"></slot>
    <slot name="s2"></slot>
  </div>
</template>

<script setup lang="ts" name="Category">
defineProps(["title"]);
</script>

3、作用域插槽

父组件：

<template>
  <div class="father">
    <h2>父组件</h2>
    <div class="content">
      <Game>
        <template v-slot="games">
          <ul>
            <li v-for="g in games.youxi"
                :key="g.id">
              {{ g.name }}
            </li>
          </ul>
        </template>
      </Game>

      <Game>
        <template v-slot="games">
          <ol>
            <li v-for="g in games.youxi"
                :key="g.id">
              {{ g.name }}
            </li>
          </ol>
        </template>
      </Game>
      <!-- 简写 -->
      <Game>
        <template #default="{youxi}">
          <div>
            <h3 v-for="g in youxi"
                :key="g.id">{{ g.name }}</h3>
          </div>
        </template>
      </Game>
    </div>
  </div>
</template>

<script setup lang="ts">
import Game from "./game.vue";
</script>

子组件：

<template>
  <div class="game">
    <h2>游戏列表</h2>
    <!-- 作用域插槽 -->
    <slot :youxi="games"></slot>
  </div>
</template>

<script setup lang="ts">
import { reactive } from "vue";

let games = reactive([
  { id: "adadada01", name: "英雄联盟" },
  { id: "adadada02", name: "穿越火线" },
  { id: "adadada03", name: "红色警戒" },
  { id: "adadada04", name: "王者农药" },
]);
</script>

十、Vue3组件通信总结

组件关系	传递方式
父传子	1、props 2、v-model 3、$refs 4、默认插槽、具名插槽
子传父	1、props 2、自定义事件 3、v-model 4、$parent 5、作用域插槽
祖传孙、孙传祖	1、$attrs 2、provide、inject
兄弟间、任意组件间	1、mitt 2、pinia