Vue3学习与实战 · 组件通信

在使用Vue3构建中大型web应用时， 组件通信 肯定是不可避免的。本文就具体介绍一下使用Vue3的 props、 $emit、expose / ref、$attrs、v-model、provide / inject、Vuex、mitt 等方式进行组件通信。

1.props

用 props 传数据给子组件有两种方法，如下

1. 混合写法：Option API + setup

// Parent.vue 传参  
<child :msg1="msg1" :msg2="msg2"></child>
<script>  
import child from "./child.vue"  
import { ref, reactive } from "vue"  
export default {  
    data(){  
        return {  
            msg1:"这是传级子组件的信息1"  
        }  
    },  
    setup(){  
        // 创建一个响应式数据  
          
        // 写法一 适用于基础类型  ref 还有其他用处，下面章节有介绍  
        const msg2 = ref("这是传级子组件的信息2")  
          
        // 写法二 适用于复杂类型，如数组、对象  
        const msg2 = reactive(["这是传级子组件的信息2"])  
          
        return {  
            msg2  
        }  
    }  
}  
</script>  

// Child.vue 接收
<script>  
export default {  
  props: ["msg1", "msg2"],// 如果这行不写，下面就接收不到  
  setup(props) {  
    console.log(props) // { msg1:"这是传给子组件的信息1", msg2:"这是传给子组件的信息2" }  
  },  
}  
</script>  

2. 纯 Vue3 写法：Composition API（<script setup>）

// Parent.vue 传参  
<child :msg2="msg2"></child>  
<script setup>  
import child from "./child.vue"  
import { ref, reactive } from "vue"  
const msg2 = ref("这是传给子组件的信息2")  
// 或者复杂类型  
const msg2 = reactive(["这是传级子组件的信息2"])  
</script>

// Child.vue 接收  
<script setup>  
// 不需要引入 直接使用  
// import { defineProps } from "vue"  
const props = defineProps({  
  // 写法一  
  msg2: String  
  // 写法二  
  msg2:{  
    type:String,  
    default:""  
  }  
})  
console.log(props) // { msg2:"这是传级子组件的信息2" }  
</script>

注意：

• 如果父组件是混合写法，子组件纯 Vue3 写法的话，是接收不到父组件里 data 的属性，只能接收到父组件里 setup 函数里传的属性。
• 如果父组件是纯 Vue3 写法，子组件混合写法，可以通过 props 接收到 data 和 setup 函数里的属性，但是子组件要是在 setup 里接收，同样只能接收到父组件中 setup 函数里的属性，接收不到 data 里的属性。
• 官方推荐纯 Composition API（<script setup>）。

2.$emit

// Child.vue 派发  
<template>  
// 写法一  
<button @click="emit('myClick')">按钮</buttom>  
// 写法二  
<button @click="handleClick">按钮</buttom>  
</template>  
<script setup>  
  
// 方法一 适用于Vue3.2版本 不需要引入  
// import { defineEmits } from "vue"  
// 对应写法一  
const emit = defineEmits(["myClick","myClick2"])  
// 对应写法二  
const handleClick = ()=>{  
  emit("myClick", "这是发送给父组件的信息")  
}  
  
// 方法二 不适用于 Vue3.2版本，该版本 useContext()已废弃  
import { useContext } from "vue"  
const { emit } = useContext()  
const handleClick = ()=>{  
  emit("myClick", "这是发送给父组件的信息")  
}  
</script>

// Parent.vue 响应  
<template>  
<child @myClick="onMyClick"></child>  
</template>  
<script setup>  
import child from "./child.vue"  
const onMyClick = (msg) => {  
  console.log(msg) // 这是父组件收到的信息  
}  
</script>

3.expose / ref

父组件获取子组件的属性或者调用子组件方法

// Child.vue  
<script setup>  
// 方法一 不适用于Vue3.2版本，该版本 useContext()已废弃  
import { useContext } from "vue"  
const ctx = useContext()  
// 对外暴露属性方法等都可以  
ctx.expose({  
  childName: "这是子组件的属性",  
  someMethod(){  
    console.log("这是子组件的方法")  
  }  
})  
  
// 方法二 适用于Vue3.2版本, 不需要引入  
// import { defineExpose } from "vue"  
defineExpose({  
  childName: "这是子组件的属性",  
  someMethod(){  
    console.log("这是子组件的方法")  
  }  
})  
</script>

// Parent.vue  注意 ref="comp"  
<template>  
<child ref="comp"></child>  
<button @click="handlerClick">按钮</button>  
</template>  
<script setup>  
import child from "./child.vue"  
import { ref } from "vue"  
const comp = ref(null)  
const handlerClick = () => {  
  console.log(comp.value.childName) // 获取子组件对外暴露的属性  
  comp.value.someMethod() // 调用子组件对外暴露的方法  
}  
</script>

4.attrs

• attrs：包含父作用域里除 class 和 style 除外的非 props 属性集合 。

// Parent.vue 传参  
<child :msg1="msg1" :msg2="msg2" title="3333"></child>  
<script setup>  
import child from "./child.vue"  
import { ref, reactive } from "vue"  
const msg1 = ref("1111")  
const msg2 = ref("2222")  
</script>

// Child.vue 接收  
<script setup>  
import { defineProps, useContext, useAttrs } from "vue"  
// 3.2版本不需要引入 defineProps，直接用  
const props = defineProps({  
  msg1: String  
})  
// 方法一 不适用于 Vue3.2版本，该版本 useContext()已废弃  
const ctx = useContext()  
// 如果没有用 props 接收 msg1 的话就是 { msg1: "1111", msg2:"2222", title: "3333" }  
console.log(ctx.attrs) // { msg2:"2222", title: "3333" }  
  
// 方法二 适用于 Vue3.2版本  
const attrs = useAttrs()  
console.log(attrs) // { msg2:"2222", title: "3333" }  
</script>

5.v-model

可以支持多个数据双向绑定

// Parent.vue  
<child v-model:key="key" v-model:value="value"></child>  
<script setup>  
import child from "./child.vue"  
import { ref, reactive } from "vue"  
const key = ref("1111")  
const value = ref("2222")  
</script>

// Child.vue  
<template>  
<button @click="handlerClick">按钮</button>  
</template>  
<script setup>  
  
// 方法一  不适用于 Vue3.2版本，该版本 useContext()已废弃  
import { useContext } from "vue"  
const { emit } = useContext()  
  
// 方法二 适用于 Vue3.2版本，不需要引入  
// import { defineEmits } from "vue"  
const emit = defineEmits(["key","value"])  
  
// 用法  
const handlerClick = () => {  
emit("update:key", "新的key")  
emit("update:value", "新的value")  
}  
</script>

6.provide / inject 依赖注入

• provide：可以为后代组件提供数据和事件。
• inject：在任何后代组件中接收想要添加在这个组件上的数据，不管组件嵌套多深都可以直接拿来用。

// Parent.vue  
<script setup>  
import { provide } from "vue"  
provide("name", "沐华")  
</script>

// Child.vue  
<script setup>  
import { inject } from "vue"  
const name = inject("name")  
console.log(name) // 沐华  
</script>

7.Vuex

• 配置、导入

// store/index.js  
import { createStore } from "vuex"  
export default createStore({  
  state:{ count: 1 },  
  getters:{  
    getCount: state => state.count  
  },  
  mutations:{  
    add(state){  
      state.count++  
    }  
  }  
})

// main.js  
import { createApp } from "vue"  
import App from "./App.vue"  
import store from "./store"  
createApp(App).use(store).mount("#app")

• 使用

// Page.vue  
// 方法一 直接使用  
<template>  
<div>{{ $store.state.count }}</div>  
<button @click="$store.commit('add')">按钮</button>  
</template>

// 方法二 获取  
<script setup>  
import { useStore, computed } from "vuex"  
const store = useStore()  
console.log(store.state.count) // 1

const count = computed(()=>store.state.count) // 响应式，会随着vuex数据改变而改变  
console.log(count) // 1   
</script>

详细事例可参考：Vuex状态管理

8.mitt

在Vue3 中没有了 EventBus 跨组件通信，但是现在有了一个替代的方案 mitt.js，原理还是 EventBus。

先安装 mitt.js

npm i mitt -S

然后像以前封装 EventBus 一样，封装：

// mitt.js  
import mitt from 'mitt'  
const mitt = mitt()  
export default mitt  

然后在两个组件之间通信使用：

// 组件 A  
<script setup>  
import mitt from './mitt'  
const handleClick = () => {  
  mitt.emit('handleChange')  
}  
</script>

// 组件 B   
<script setup>  
import mitt from './mitt'  
import { onUnmounted } from 'vue'  
const someMethod = () => { 
  // do something
}  
mitt.on('handleChange',someMethed)  
onUnmounted(()=>{  
  mitt.off('handleChange',someMethed)  
})  
</script>

---

《Vue3学习与实战》系列

• Vue3学习与实战 · 组件通信（本文）
• Vue3学习与实战 · 全局挂载使用Axios
• Vue3学习与实战 · 配置使用vue-router路由
• Vue3学习与实战 · Vuex状态管理
• vue3 + vite实现异步组件和路由懒加载
• Vite+Vue3+Vant快速构建项目

---

欢迎访问：天问博客

本文作者： Tiven
发布时间： 2021-12-28
最后更新： 2023-07-17
本文标题： Vue3学习与实战 · 组件通信
本文链接： https://www.tiven.cn/p/97da9e37/
版权声明： 本作品采用 CC BY-NC-SA 4.0 许可协议进行许可。转载请注明出处！