
vue
前言
這對選項需要一起使用,以允許一個祖先組件向其所有子孫后代注入一個依賴,不論組件層次有多深,并在起上下游關(guān)系成立的時間里始終生效。如果你熟悉 React,這與 React 的上下文特性很相似。
版本
vue 2.2.0 新增
類型
- provide:Object | () => Object
- inject:Array<string> | { [key: string]: string | Symbol | Object }
詳細(xì)
provide
選項應(yīng)該是一個對象或返回一個對象的函數(shù)。該對象包含可注入其子孫的屬性。在該對象中你可以使用 ES2015 Symbols 作為 key,但是只在原生支持 Symbol 和 Reflect.ownKeys 的環(huán)境下可工作。
inject
選項應(yīng)該是:
- 一個字符串?dāng)?shù)組,或
- 一個對象,對象的 key 是本地的綁定名,value 是:
- 在可用的注入內(nèi)容中搜索用的 key (字符串或 Symbol),或
- 一個對象,該對象的:
- from 屬性是在可用的注入內(nèi)容中搜索用的 key (字符串或 Symbol)
- default 屬性是降級情況下使用的 value
示例
// 父級組件提供 'foo'
var Provider = {
provide: {
foo: 'bar'
},
// ...
}
// 子組件注入 'foo'
var Child = {
inject: ['foo'],
created () {
console.log(this.foo) // => "bar"
}
// ...
}
利用 ES2015 Symbols、函數(shù) provide 和對象 inject:
const s = Symbol()
const Provider = {
provide () {
return {
[s]: 'foo'
}
}
}
const Child = {
inject: { s },
// ...
}
- 接下來 2 個例子只工作在 Vue 2.2.1 或更高版本。低于這個版本時,注入的值會在 props 和 data 初始化之后得到。
使用一個注入的值作為一個屬性的默認(rèn)值:
const Child = {
inject: ['foo'],
props: {
bar: {
default () {
return this.foo
}
}
}
}
使用一個注入的值作為數(shù)據(jù)入口:
const Child = {
inject: ['foo'],
data () {
return {
bar: this.foo
}
}
}
- 在 2.5.0+ 的注入可以通過設(shè)置默認(rèn)值使其變成可選項:
const Child = {
inject: {
foo: { default: 'foo' }
}
}
如果它需要從一個不同名字的屬性注入,則使用 from 來表示其源屬性:
const Child = {
inject: {
foo: {
from: 'bar',
default: 'foo'
}
}
}
與 prop 的默認(rèn)值類似,你需要對非原始值使用一個工廠方法:
const Child = {
inject: {
foo: {
from: 'bar',
default: () => [1, 2, 3]
}
}
}
提示
- provide 和 inject 主要為高階插件/組件庫提供用例。并不推薦直接用于應(yīng)用程序代碼中。
- provide 和 inject 綁定并不是可響應(yīng)的。這是刻意為之的。然而,如果你傳入了一個可監(jiān)聽的對象,那么其對象的屬性還是可響應(yīng)的。
- 摘抄自Vue官方文檔,更多內(nèi)容請訪問官方文檔。