Vue中的provide與inject用法詳解
provide 與 inject 核心功能
provide 與 inject 是 Vue 提供的跨組件通信方案,用于解決多層級組件(父子、祖孫、更深層級)之間的數(shù)據(jù)傳遞問題。其核心功能是:
provide:在父組件(或祖先組件)中定義需要共享的數(shù)據(jù)或方法,作為“提供者”。inject:在子組件(或后代組件)中聲明需要接收的數(shù)據(jù)或方法,作為“消費(fèi)者”。- 特點(diǎn):無需通過 props 逐級傳遞(避免“props 鉆取”),直接跨層級通信,且不受層級深度限制。
Vue2 中的用法
Vue2 中 provide 與 inject 以組件選項(Options API)的形式使用。
1. 基本用法
- 父組件(提供者):通過
provide選項定義需要共享的數(shù)據(jù)(對象或返回對象的函數(shù))。 - 子組件(消費(fèi)者):通過
inject選項聲明需要注入的數(shù)據(jù)(字符串?dāng)?shù)組或配置對象)。
示例:
<!-- 父組件(Grandparent.vue) -->
<template>
<div>父組件</div>
<Parent />
</template>
<script>
import Parent from './Parent.vue'
export default {
components: { Parent },
// provide 可以是對象或函數(shù)(函數(shù)更靈活,可訪問 this)
provide() {
return {
theme: 'dark', // 非響應(yīng)式數(shù)據(jù)
user: this.currentUser // 可傳遞組件內(nèi)數(shù)據(jù)(需注意響應(yīng)式)
}
},
data() {
return {
currentUser: { name: '張三' }
}
}
}
</script>
<!-- 子組件(Child.vue,層級:Grandparent -> Parent -> Child) -->
<template>
<div>
主題:{{ theme }}
用戶名:{{ user.name }}
</div>
</template>
<script>
export default {
// inject 可以是字符串?dāng)?shù)組(直接指定 key)
// inject: ['theme', 'user']
// 也可以是對象(支持默認(rèn)值、重命名)
inject: {
theme: {
from: 'theme', // 對應(yīng) provide 的 key(可選,默認(rèn)與屬性名一致)
default: 'light' // 未提供時的默認(rèn)值
},
userName: {
from: 'user', // 注入 user 數(shù)據(jù)
default: () => ({ name: '匿名' }) // 默認(rèn)值為對象時需用函數(shù)返回
}
}
}
</script>2. 響應(yīng)式處理(Vue2 關(guān)鍵注意點(diǎn))
Vue2 中 provide 提供的數(shù)據(jù)默認(rèn)是非響應(yīng)式的。若需要響應(yīng)式,需通過以下方式:
- 傳遞組件的
data或computed中的響應(yīng)式對象(因為data中的屬性本身是響應(yīng)式的)。 - 避免直接傳遞基本類型(如字符串、數(shù)字),建議包裹在對象中。
示例(響應(yīng)式改造):
<!-- 父組件 -->
provide() {
return {
// 傳遞響應(yīng)式對象(data 中的屬性)
appState: this.appState
}
},
data() {
return {
appState: {
theme: 'dark', // 響應(yīng)式
user: { name: '張三' }
}
}
}
<!-- 子組件修改后,父組件會同步更新 -->
this.appState.theme = 'light' // 有效(響應(yīng)式)Vue3 中的用法
Vue3 中 provide 與 inject 主要通過 Composition API 實(shí)現(xiàn)(在 setup 函數(shù)或 <script setup> 中使用),同時支持響應(yīng)式傳遞。
1. 基本用法(<script setup>)
- 從
vue導(dǎo)入provide和inject函數(shù)。 provide(key, value):第一個參數(shù)為 key(字符串或 Symbol),第二個參數(shù)為要共享的值。inject(key, defaultValue):第一個參數(shù)為 key,第二個參數(shù)為可選默認(rèn)值。
示例:
<!-- 父組件(Grandparent.vue) -->
<template>
<div>父組件</div>
<Parent />
</template>
<script setup>
import { provide } from 'vue'
import Parent from './Parent.vue'
// 提供數(shù)據(jù)(可直接提供基本類型或?qū)ο螅?
provide('theme', 'dark')
// 提供響應(yīng)式數(shù)據(jù)(ref/reactive)
const user = { name: '張三' }
provide('user', user)
</script>
<!-- 子組件(Child.vue) -->
<template>
<div>
主題:{{ theme }}
用戶名:{{ user.name }}
</div>
</template>
<script setup>
import { inject } from 'vue'
// 注入數(shù)據(jù)(指定 key)
const theme = inject('theme', 'light') // 第二個參數(shù)為默認(rèn)值
const user = inject('user', () => ({ name: '匿名' })) // 默認(rèn)值為對象時建議用函數(shù)
</script>2. 響應(yīng)式處理(Vue3 優(yōu)勢)
Vue3 中,若 provide 傳遞的是 響應(yīng)式數(shù)據(jù)(ref 或 reactive),則 inject 后的數(shù)據(jù)會保持響應(yīng)式(修改時自動更新)。
示例(響應(yīng)式傳遞):
<!-- 父組件 -->
<script setup>
import { provide, ref, reactive } from 'vue'
// ref 響應(yīng)式(基本類型)
const theme = ref('dark')
provide('theme', theme)
// reactive 響應(yīng)式(對象)
const user = reactive({ name: '張三' })
provide('user', user)
// 父組件修改,子組件會同步更新
setTimeout(() => {
theme.value = 'light'
user.name = '李四'
}, 2000)
</script>
<!-- 子組件 -->
<script setup>
import { inject } from 'vue'
const theme = inject('theme')
const user = inject('user')
// 子組件修改響應(yīng)式數(shù)據(jù),父組件也會同步(若需禁止,可用 readonly)
// const user = inject('user') // 可修改
// const user = readonly(inject('user')) // 只讀,防止子組件修改
</script>3. 類型提示(TypeScript)
Vue3 中可通過 InjectionKey 實(shí)現(xiàn)類型約束(避免 key 沖突和類型錯誤):
// keys.ts
import type { InjectionKey } from 'vue'
export const themeKey: InjectionKey<string> = Symbol('theme')
export const userKey: InjectionKey<{ name: string }> = Symbol('user')
// 父組件
import { provide } from 'vue'
import { themeKey, userKey } from './keys'
provide(themeKey, 'dark') // 類型約束:必須是 string
provide(userKey, { name: '張三' }) // 類型約束:必須符合 { name: string }
// 子組件
import { inject } from 'vue'
import { themeKey, userKey } from './keys'
const theme = inject(themeKey, 'light') // 類型:string
const user = inject(userKey) // 類型:{ name: string } | undefined使用場景
- 多層級共享配置:如主題(深色/淺色)、語言切換、全局權(quán)限等(跨組件共享的靜態(tài)或低頻變化數(shù)據(jù))。
- 插件/庫內(nèi)部通信:插件向子組件傳遞配置或方法(如 UI 組件庫中,父組件向深層級子組件傳遞尺寸、樣式等)。
- 避免 props 鉆取:當(dāng)組件層級較深(如 5 層以上),用
provide/inject替代 props 逐級傳遞,減少代碼冗余。
不適合的場景:
- 簡單父子組件通信(直接用 props/emits 更清晰)。
- 高頻變化或需要嚴(yán)格狀態(tài)管理的數(shù)據(jù)(建議用 Pinia/Vuex,便于追蹤狀態(tài)變化)。
基本原理
provide 與 inject 基于 Vue 的組件實(shí)例樹實(shí)現(xiàn),核心邏輯如下:
- 數(shù)據(jù)存儲:每個組件實(shí)例(
vm)會維護(hù)一個provides對象,用于存儲當(dāng)前組件通過provide提供的數(shù)據(jù)。 - 查找鏈構(gòu)建:當(dāng)組件初始化時,會繼承父組件的
provides(形成一個原型鏈/查找鏈)。即:子組件的provides以父組件的provides為原型,以此類推。 - 注入查找:當(dāng)子組件通過
inject查找數(shù)據(jù)時,會沿著組件實(shí)例的provides鏈向上遍歷,直到找到匹配的 key 或到達(dá)根組件。
響應(yīng)式原理:
- 若提供的是響應(yīng)式數(shù)據(jù)(Vue2 中
data里的對象,Vue3 中ref/reactive),則依賴該數(shù)據(jù)的組件會被納入響應(yīng)式依賴追蹤。當(dāng)數(shù)據(jù)變化時,所有依賴組件會重新渲染。
總結(jié)
| 特性 | Vue2(Options API) | Vue3(Composition API) |
|---|---|---|
| 用法 | 組件選項 provide(對象/函數(shù))、inject(數(shù)組/對象) | 導(dǎo)入 provide/inject 函數(shù),在 setup 中調(diào)用 |
| 響應(yīng)式 | 需手動傳遞響應(yīng)式對象(如 data 中的屬性) | 原生支持 ref/reactive 響應(yīng)式傳遞 |
| 類型支持 | 較弱(需手動注釋) | 可通過 InjectionKey 實(shí)現(xiàn)強(qiáng)類型約束 |
| 靈活性 | 依賴組件選項,靈活性較低 | 可在 setup 中動態(tài)提供/注入,靈活性更高 |
核心作用一致:跨層級通信,減少 props 傳遞成本,適用于共享低頻變化的全局配置或插件內(nèi)部通信。
到此這篇關(guān)于Vue中的provide與inject的文章就介紹到這了,更多相關(guān)vue provide與inject內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
vue中el-table兩個表尾合計行聯(lián)動同步滾動條實(shí)例代碼
項目開發(fā)中遇到一個比較兩個form差異的需求,但當(dāng)item過多就需要滾動條,下面這篇文章主要給大家介紹了關(guān)于vue中el-table兩個表尾合計行聯(lián)動同步滾動條的相關(guān)資料,需要的朋友可以參考下2022-05-05
Vue.js計算機(jī)屬性computed和methods方法詳解
這篇文章主要為大家詳細(xì)介紹了Vue.js計算機(jī)屬性computed和methods方法,文中示例代碼介紹的非常詳細(xì),具有一定的參考價值,感興趣的小伙伴們可以參考一下2019-10-10
使用Vue-axios進(jìn)行數(shù)據(jù)交互的方法
這篇文章主要介紹了使用Vue-axios進(jìn)行數(shù)據(jù)交互詳情,文章圍繞Vue-axios進(jìn)行數(shù)據(jù)交互的相關(guān)資料展開詳細(xì)內(nèi)容,需要的小伙伴可以參考一下,希望對你的學(xué)習(xí)或工作有所幫助2022-03-03
Vue?+?Element?實(shí)現(xiàn)按鈕指定間隔時間點(diǎn)擊思路詳解
這篇文章主要介紹了Vue?+?Element?實(shí)現(xiàn)按鈕指定間隔時間點(diǎn)擊,實(shí)現(xiàn)思路大概是通過加一個本地緩存的時間戳,通過時間戳計算指定時間內(nèi)不能點(diǎn)擊按鈕,具體實(shí)現(xiàn)代碼跟隨小編一起看看吧2023-12-12
vue響應(yīng)式Object代理對象的修改和刪除屬性
這篇文章主要為大家介紹了vue響應(yīng)式Object代理對象的修改和刪除屬性示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進(jìn)步,早日升職加薪2022-08-08

