Vue3.x 從零開始(四)—— 更完善的組件傳參

在如今的前端開發工作中, 組件之間的參數傳遞是一個非常常見的問題

Vue 2 已經有了一套非常實用的組件傳參機制,Vue 3 在原本的基礎上做了些改進

 

 

一、父組件傳參到子組件

《Vue3.x 從零開始(二)—— 重新認識 Vue 組件》中已經介紹過 Props

這是最常用的父對子傳參方式 

 

上面演示的參數只是簡單的字符串,也可以通過 v-bind 指令傳入 Number、Function、Object 等類型

 

除了傳遞基本的參數之外,props 還可以用來傳遞組件

由於組件是變量的形式傳入,所以在子組件中需要動態渲染組件,這就會用到內置組件 <component />

<component /> 組件會接收 is 參數,並基於這個參數渲染組件,所以我們只要通過 is 屬性傳入組件變量即可

子組件定義 prop:

父組件傳入組件: 

在父組件部分,我們需要把 Alert 組件傳給子組件,所以需要引入組件之後,將 Alert 組件保存到 data

data 是具有響應性的,而組件作爲變量傳遞的時候,是不需要具備響應性的

所以我使用了 markRaw 方法來消除響應性( markRaw 會標記一個對象,使其永遠不會轉換爲代理,只返回對象本身)

而在 Vue 2.x 中並沒有類似的方法,會對整個組件做數據劫持,導致額外的性能開銷

 

在寫文的時候有同事提出了一個問題:prop 傳入組件和 slot 有什麼區別?

slot 是在父組件中插入組件,被插入的內容和子組件無關,所有邏輯都在父組件中完成

而 prop 傳入的組件恰恰相反,父組件只是決定傳入的內容,相關邏輯是在子組件中完成

 

 

二、子組件傳參到父組件

子組件通常使用自定義事件的方式向父組件傳參,即 $emit

this.$emit('event-name', data);

$emit 函數接收的第一個參數是自定義的事件名稱,這個事件名稱建議採用全小寫的 kebab-case 事件名

除了事件名稱外,$emit 還可以接收數量不定的額外參數,這些額外參數會按順序傳遞給父組件的事件處理函數


來看一下自定義事件的完整用法,首先在子組件中通過 $emit 定義事件和需要傳遞的參數

然後在父組件中監聽該事件,並通過事件處理函數接收子組件的傳參

 


通過 $emit 我們還可以做一些更厲害的事情,比如對 prop 實現雙向綁定

prop 是單向下行綁定,也就是說,父級 prop 的更新會在子組件中響應,而子組件無法修改 prop 的值

如果子組件確實需要修改 prop 的值,需要使用 update:prop 事件

比如有一個 prop 的屬性名爲 text,我們可以在子組件中通過 $emit 觸發 update:text 事件並傳參,然後在父組件進行賦值

Vue 3 爲了提升開發者的效率,還提供了 v-model 語法。在父組件中使用 v-model:prop ,就不需要監聽 update 事件了

// Vue 2 中的 .sync 修飾符已移除

 

但子組件還是要用 $emit 觸發 update 事件 this.$emit('update:text', data); 

 

如果是 Vue 2 的用戶,應該已經發現 Vue 3 中 v-model 的用法已經發生了改變

在 Vue 2 中,在組件上使用 v-model 相當於綁定了一個屬性名爲 value 的 prop,並監聽了 input 事件

而在 Vue 3 中,v-model 相當於傳遞了一個名爲 modelValue 的 prop,並監聽 update:modelValue 事件 

<child-component v-model="text" />
<!-- 在 Vue 3 中,這兩種寫法是等價的 -->
<child-component
  :modelValue="text"
  @update:modelValue="text = $event"
/>

也就是說,Vue 3 中的 v-model 是 prop + update 的語法糖,只是當 prop 被定義爲 modelValue 的時候可以省略 :modelValue 

 

 

三、深層次的組件傳參

上面介紹是父子組件之間的數據傳遞,而對於深嵌套的祖孫組件:

App.vue
└─ Home.vue
   └─ Footer.vue
      ├─ FooterItem.vue
      └─ FooterTips.vue

像這樣的結構,如果 Home 要傳遞一個參數給 FooterTips,繼續使用 prop 或者 $emit 就會很複雜

// 在 Vue 2 中可以使用 event bus 來處理,但 Vue 3 中移除了 $on、$off,所以已經無法構建 event bus 了

這時候可以使用 provide / inject

首先在孫組件 footer-tips 中通過 inject 定義需要傳入的參數,inject 可以是一個由屬性名組成的字符串數組

然後在祖父級組件中通過 provide 傳入對應的參數

 

provide 也可以是一個對象,但爲了更安全的開發組件,建議始終將 provide 定義爲返回對象的函數

如果需要定義 inject 的默認值,也可以像 props 一樣,將 inject 定義爲對象:

inject: {
  author: {
    default: '這是一個沉默的作者',
  },
  // 如果是 Object 或者 Array 這種引用類型,需要用函數返回
  info: {
    default: () => ({
      name: 'wise',
      home: 'China',
    }),
  },
},

 

在上一篇博客《Vue3.x 從零開始(三)—— 使用 Composition API 優化組件》中已經介紹過 setup

如果需要在 setup 中使用 provide,需要引入 Vue 提供的 provide 全局方法:

import { provide, ref } from 'vue';

setup() {
  // 使用 ref 提供響應性
  const author = ref('Wise.Wrong');
  // provide 可以定義兩個參數,分別爲 key 和 value
  provide('author', author.value);
}

同樣的,setup 中的 inject 也需要全局引入

import { inject } from 'vue';

setup() {
  // inject 接收兩個參數,分別爲 key 和默認值,默認值可以爲空
  const author = inject('author', '這裏是默認值');
  return { author };
},

 

  

四、子組件傳參到子組件

在工作中經常也會遇到平級的兩個組件組件的通信

App.vue
└─ Home.vue
  ├─ Header.vue
  └─ Footer.vue

比如這裏的 Header 和 Footer 都是 Home 的子組件,Footer 中有某個字段受 Header 的影響

對於這種情況,應該將交互邏輯放到父組件中處理,這種思路叫做狀態提升

比如上圖的例子,可以在父組件 Home 中定義一個字段,通過 prop 傳入 Footer 組件

然後在 Header 組件中通過 $emit 觸發自定義事件,拋出需要傳遞給 Footer 的數據

同時在 Home 組件中監聽該事件,並將接到的參數賦值到傳入 Footer 的 prop

 

子組件與子組件的通信,在實際業務場景中會有所不同,但只要牢記狀態提升,將交互邏輯放到父組件來處理,絕大部分情況都能迎刃而解


  

除了上面提到的情況外,還有可能遇到特別複雜的情況,比如:

1. 孫組件對祖父級組件傳參;

2. 孫組件對孫組件傳參。

通常來說,這些問題都可以通過良好的組件設計來規避

但隨着業務規模的不斷擴大,有些複雜的業務場景確實需要直面這些問題,這時候就需要進行狀態管理

Vue 團隊開發了 Vuex 來集中式存儲和管理應用中所有組件的狀態

在後面的文章中我會提到如何在 Vue 3 中使用 Vuex,但不會單獨介紹 Vuex 的用法

關於 Vuex 的基本用法可以參考我以前的博客《Vue 爬坑之路(四)—— 與 Vuex 的第一次接觸》

如果想更進一步,建議閱讀 Vuex 的官方文檔~

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章