Vue中元件通訊的幾種方法（Vue3的7種和Vue2的12種元件通訊）

Vue3元件通訊方式：

• props

• $emit

• expose / ref

• $attrs

• v-model

• provide / inject

• Vuex

使用方法：

props
用 props 傳資料給子元件有兩種方法，如下

方法一，混合寫法

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

方法二，純 Vue3 寫法

// 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 裡的屬性

官方也說了，既然用了 3，就不要寫 2 了，所以不推薦混合寫法。下面的例子，一律只用純 Vue3 的寫法，就不寫混合寫法了

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

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>

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>

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>

provide / inject
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>

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>

Vue2.x 元件通訊方式

Vue2.x 元件通訊共有12種:

• props
• $emit / v-on
• .sync
• v-model
• ref
• $children / $parent
• $attrs / $listeners
• provide / inject
• EventBus
• Vuex
• $root
• slot

父子元件通訊可以用：

• props
• $emit / v-on
• $attrs / $listeners
• ref
• sync
• v-model
• $children / $parent

兄弟元件通訊可以用：

• EventBus
• Vuex
• $parent

跨層級元件通訊可以用：

• provide/inject
• EventBus
• Vuex
• $attrs / $listeners
• $root

使用方法：
props
父元件向子元件傳送資料，這應該是最常用的方式了

子元件接收到資料之後，不能直接修改父元件的資料。會報錯，所以當父元件重新渲染時，資料會被覆蓋。如果子元件內要修改的話推薦使用 computed

// Parent.vue 傳送
<template>
   <child :msg="msg"></child>
</template>

// Child.vue 接收
export default {
 // 寫法一 用陣列接收
 props:['msg'],
 // 寫法二 用物件接收，可以限定接收的資料型別、設定預設值、驗證等
 props:{
     msg:{
         type:String,
         default:'這是預設資料'
    }
},
 mounted(){
     console.log(this.msg)
},
}

.sync
可以幫我們實現父元件向子元件傳遞的資料 的雙向繫結，所以子元件接收到資料後可以直接修改，並且會同時修改父元件的資料

// Parent.vue
<template>
   <child :page.sync="page"></child>
</template>
<script>
export default {
   data(){
       return {
           page:1
      }
  }
}

// Child.vue
export default {
   props:["page"],
   computed(){
       // 當我們在子元件裡修改 currentPage 時，父元件的 page 也會隨之改變
       currentPage {
           get(){
               return this.page
          },
           set(newVal){
               this.$emit("update:page", newVal)
          }
      }
  }
}
</script>

v-model
和 .sync 類似，可以實現將父元件傳給子元件的資料為雙向繫結，子元件通過 $emit 修改父元件的資料

// Parent.vue
<template>
   <child v-model="value"></child>
</template>
<script>
export default {
   data(){
       return {
           value:1
      }
  }
}

// Child.vue
<template>
   <input :value="value" @input="handlerChange">
</template>
export default {
   props:["value"],
   // 可以修改事件名，預設為 input
   model:{
       event:"updateValue"
  },
   methods:{
       handlerChange(e){
           this.$emit("input", e.target.value)
           // 如果有上面的重新命名就是這樣
           this.$emit("updateValue", e.target.value)
      }
  }
}
</script>

ref
ref 如果在普通的DOM元素上，引用指向的就是該DOM元素;

如果在子元件上，引用的指向就是子元件例項，然後父元件就可以通過 ref 主動獲取子元件的屬性或者呼叫子元件的方法

// Child.vue
export default {
   data(){
       return {
           name:"沐華"
      }
  },
   methods:{
       someMethod(msg){
           console.log(msg)
      }
  }
}

// Parent.vue
<template>
   <child ref="child"></child>
</template>
<script>
export default {
   mounted(){
       const child = this.$refs.child
       console.log(child.name) // 沐華
       child.someMethod("呼叫了子元件的方法")
  }
}
</script>

$emit / v-on
子元件通過派發事件的方式給父元件資料，或者觸發父元件更新等操作

// Child.vue 派發
export default {
 data(){
     return { msg: "這是發給父元件的資訊" }
},
 methods: {
     handleClick(){
         this.$emit("sendMsg",this.msg)
    }
},
}
// Parent.vue 響應
<template>
   <child v-on:sendMsg="getChildMsg"></child>
   // 或 簡寫
   <child @sendMsg="getChildMsg"></child>
</template>

export default {
   methods:{
       getChildMsg(msg){
           console.log(msg) // 這是父元件接收到的訊息
      }
  }
}

$attrs / $listeners
多層巢狀元件傳遞資料時，如果只是傳遞資料，而不做中間處理的話就可以用這個，比如父元件向孫子元件傳遞資料時

$attrs：包含父作用域裡除 class 和 style 除外的非 props 屬性集合。通過 this.$attrs 獲取父作用域中所有符合條件的屬性集合，然後還要繼續傳給子元件內部的其他元件，就可以通過 v-bind="$attrs"

$listeners：包含父作用域裡 .native 除外的監聽事件集合。如果還要繼續傳給子元件內部的其他元件，就可以通過 v-on="$linteners"

使用方式是相同的

// Parent.vue
<template>
   <child :name="name" title="1111" ></child>
</template
export default{
   data(){
       return {
           name:"沐華"
      }
  }
}

// Child.vue
<template>
   // 繼續傳給孫子元件
   <sun-child v-bind="$attrs"></sun-child>
</template>
export default{
   props:["name"], // 這裡可以接收，也可以不接收
   mounted(){
       // 如果props接收了name 就是 { title:1111 }，否則就是{ name:"沐華", title:1111 }
       console.log(this.$attrs)
  }
}

$children / $parent
$children：獲取到一個包含所有子元件(不包含孫子元件)的 VueComponent 物件陣列，可以直接拿到子元件中所有資料和方法等

$parent：獲取到一個父節點的 VueComponent 物件，同樣包含父節點中所有資料和方法等

// Parent.vue
export default{
   mounted(){
       this.$children[0].someMethod() // 呼叫第一個子元件的方法
       this.$children[0].name // 獲取第一個子元件中的屬性
  }
}

// Child.vue
export default{
   mounted(){
       this.$parent.someMethod() // 呼叫父元件的方法
       this.$parent.name // 獲取父元件中的屬性
  }
}

provide / inject
provide / inject 為依賴注入，說是不推薦直接用於應用程式程式碼中，但是在一些外掛或元件庫裡卻是被常用，所以我覺得用也沒啥，還挺好用的

provide：可以讓我們指定想要提供給後代元件的資料或方法

inject：在任何後代元件中接收想要新增在這個元件上的資料或方法，不管元件巢狀多深都可以直接拿來用

要注意的是 provide 和 inject 傳遞的資料不是響應式的，也就是說用 inject 接收來資料後，provide 裡的資料改變了，後代元件中的資料不會改變，除非傳入的就是一個可監聽的物件

所以建議還是傳遞一些常量或者方法

// 父元件
export default{
   // 方法一 不能獲取 methods 中的方法
   provide:{
       name:"沐華",
       age: this.data中的屬性
  },
   // 方法二 不能獲取 data 中的屬性
   provide(){
       return {
           name:"沐華",
           someMethod:this.someMethod // methods 中的方法
      }
  },
   methods:{
       someMethod(){
           console.log("這是注入的方法")
      }
  }
}

// 後代元件
export default{
   inject:["name","someMethod"],
   mounted(){
       console.log(this.name)
       this.someMethod()
  }
}

EventBus
EventBus 是中央事件匯流排，不管是父子元件，兄弟元件，跨層級元件等都可以使用它完成通訊操作

定義方式有三種

// 方法一
// 抽離成一個單獨的 js 檔案 Bus.js ，然後在需要的地方引入
// Bus.js
import Vue from "vue"
export default new Vue()

// 方法二 直接掛載到全域性
// main.js
import Vue from "vue"
Vue.prototype.$bus = new Vue()

// 方法三 注入到 Vue 根物件上
// main.js
import Vue from "vue"
new Vue({
   el:"#app",
   data:{
       Bus: new Vue()
  }
})

使用如下，以方法一按需引入為例

// 在需要向外部傳送自定義事件的元件內
<template>
   <button @click="handlerClick">按鈕</button>
</template>
import Bus from "./Bus.js"
export default{
   methods:{
       handlerClick(){
           // 自定義事件名 sendMsg
           Bus.$emit("sendMsg", "這是要向外部傳送的資料")
      }
  }
}

// 在需要接收外部事件的元件內
import Bus from "./Bus.js"
export default{
   mounted(){
       // 監聽事件的觸發
       Bus.$on("sendMsg", data => {
           console.log("這是接收到的資料：", data)
      })
  },
   beforeDestroy(){
       // 取消監聽
       Bus.$off("sendMsg")
  }
}

Vuex
Vuex 是狀態管理器，集中式儲存管理所有元件的狀態。這一塊內容過長，如果基礎不熟的話可以看這個Vuex，然後大致用法如下
比如建立這樣的檔案結構

index.js 裡內容如下

import Vue from 'vue'
import Vuex from 'vuex'
import getters from './getters'
import actions from './actions'
import mutations from './mutations'
import state from './state'
import user from './modules/user'

Vue.use(Vuex)

const store = new Vuex.Store({
 modules: {
   user
},
 getters,
 actions,
 mutations,
 state
})
export default store
然後在 main.js 引入

import Vue from "vue"
import store from "./store"
new Vue({
   el:"#app",
   store,
   render: h => h(App)
})

然後在需要的使用元件裡

import { mapGetters, mapMutations } from "vuex"
export default{
   computed:{
       // 方式一 然後通過 this.屬性名就可以用了
       ...mapGetters(["引入getters.js裡屬性1","屬性2"])
       // 方式二
       ...mapGetters("user", ["user模組裡的屬性1","屬性2"])
  },
   methods:{
       // 方式一 然後通過 this.屬性名就可以用了
       ...mapMutations(["引入mutations.js裡的方法1","方法2"])
       // 方式二
       ...mapMutations("user",["引入user模組裡的方法1","方法2"])
  }
}

// 或者也可以這樣獲取
this.$store.state.xxx
this.$store.state.user.xxx

$root

$root 可以拿到 App.vue 裡的資料和方法

slot
就是把子元件的資料通過插槽的方式傳給父元件使用，然後再插回來

// Child.vue
<template>
   <div>
       <slot :user="user"></slot>
   </div>
</template>
export default{
   data(){
       return {
           user:{ name:"張三" }
      }
  }
}

// Parent.vue
<template>
   <div>
       <child v-slot="slotProps">
          {{ slotProps.user.name }}
       </child>
   </div>
</template>