前言
Context
被翻譯為上下文,在程式設計領域,這是一個經常會接觸到的概念,React中也有。
在React的官方文件中,Context
被歸類為高階部分(Advanced),屬於React的高階API,但官方並不建議在穩定版的App中使用Context。
The vast majority of applications do not need to use content.
If you want your application to be stable, don’t use context. It is an experimental API and it is likely to break in future releases of React.
不過,這並非意味著我們不需要關注Context
。事實上,很多優秀的React元件都通過Context來完成自己的功能,比如react-redux的<
,就是通過
Provider />Context
提供一個全域性態的store
,拖拽元件react-dnd,通過Context
在元件中分發DOM的Drag和Drop事件,路由元件react-router通過Context
管理路由狀態等等。在React元件開發中,如果用好Context
,可以讓你的元件變得強大,而且靈活。
今天就想跟大家聊一聊,我在開發當中,所認識到的這個Context
,以及我是如何使用它來進行元件開發的。
注:本文中所有提到的App皆指Web端App。
初識React Context
官方對於Context的定義
React文件官網並未對Context
給出“是什麼”的定義,更多是描述使用的Context
的場景,以及如何使用Context
。
官網對於使用Context
的場景是這樣描述的:
In Some Cases, you want to pass data through the component tree without having to pass the props down manuallys at every level. you can do this directly in React with the powerful “context” API.
簡單說就是,當你不想在元件樹中通過逐層傳遞props
或者state
的方式來傳遞資料時,可以使用Context
來實現跨層級的元件資料傳遞。
使用props或者state傳遞資料,資料自頂下流。
使用Context
,可以跨越元件進行資料傳遞。
如何使用Context
如果要Context
發揮作用,需要用到兩種元件,一個是Context
生產者(Provider),通常是一個父節點,另外是一個Context
的消費者(Consumer),通常是一個或者多個子節點。所以Context
的使用基於生產者消費者模式。
對於父元件,也就是Context
生產者,需要通過一個靜態屬性childContextTypes
宣告提供給子元件的Context
物件的屬性,並實現一個例項getChildContext
方法,返回一個代表Context
的純物件 (plain object) 。
import React from 'react'import PropTypes from 'prop-types'class MiddleComponent extends React.Component {
render () {
return <
ChildComponent />
}
}class ParentComponent extends React.Component {
// 宣告Context物件屬性 static childContextTypes = {
propA: PropTypes.string, methodA: PropTypes.func
} // 返回Context物件,方法名是約定好的 getChildContext () {
return {
propA: 'propA', methodA: () =>
'methodA'
}
} render () {
return <
MiddleComponent />
}
}複製程式碼
而對於Context
的消費者,通過如下方式訪問父元件提供的Context
。
import React from 'react'import PropTypes from 'prop-types'class ChildComponent extends React.Component {
// 宣告需要使用的Context屬性 static contextTypes = {
propA: PropTypes.string
} render () {
const {
propA, methodA
} = this.context console.log(`context.propA = ${propA
}`) // context.propA = propA console.log(`context.methodA = ${methodA
}`) // context.methodA = undefined return ...
}
}複製程式碼
子元件需要通過一個靜態屬性contextTypes
宣告後,才能訪問父元件Context
物件的屬性,否則,即使屬性名沒寫錯,拿到的物件也是undefined
。
對於無狀態子元件(Stateless Component),可以通過如下方式訪問父元件的Context
import React from 'react'import PropTypes from 'prop-types'const ChildComponent = (props, context) =>
{
const {
propA
} = context console.log(`context.propA = ${propA
}`) // context.propA = propA return ...
} ChildComponent.contextProps = {
propA: PropTypes.string
}複製程式碼
而在接下來的發行版本中,React對Context
的API做了調整,更加明確了生產者消費者模式的使用方式。
import React from 'react';
import ReactDOM from 'react-dom';
const ThemeContext = React.createContext({
background: 'red', color: 'white'
});
複製程式碼
通過靜態方法React.createContext()
建立一個Context
物件,這個Context
物件包含兩個元件,<
和
Provider /><
。
Consumer />
class App extends React.Component {
render () {
return ( <
ThemeContext.Provider value={{background: 'green', color: 'white'
}
}>
<
Header />
<
/ThemeContext.Provider>
);
}
}複製程式碼
<
的
Provider />value
相當於現在的getChildContext()
。
class Header extends React.Component {
render () {
return ( <
Title>
Hello React Context API<
/Title>
);
}
} class Title extends React.Component {
render () {
return ( <
ThemeContext.Consumer>
{context =>
( <
h1 style={{background: context.background, color: context.color
}
}>
{this.props.children
} <
/h1>
)
} <
/ThemeContext.Consumer>
);
}
}複製程式碼
<
的
Consumer />children
必須是一個函式,通過函式的引數獲取<
提供的
Provider />Context
。
可見,Context
的新API更加貼近React的風格。
幾個可以直接獲取Context的地方
實際上,除了例項的context
屬性(this.context
),React元件還有很多個地方可以直接訪問父元件提供的Context
。比如構造方法:
constructor(props, context)
比如生命週期:
componentWillReceiveProps(nextProps, nextContext)
shouldComponentUpdate(nextProps, nextState, nextContext)
componetWillUpdate(nextProps, nextState, nextContext)
對於面向函式的無狀態元件,可以通過函式的引數直接訪問元件的Context
。
const StatelessComponent = (props, context) =>
( ......)複製程式碼
以上是Context
的基礎,更具體的指南內容可參見這裡
我對Context的理解
OK,說完基礎的東西,現在聊一聊我對React的Context
的理解。
把Context當做元件作用域
使用React的開發者都知道,一個React App本質就是一棵React元件樹,每個React元件相當於這棵樹上的一個節點,除了App的根節點,其他每個節點都存在一條父元件鏈。
例如上圖,<
的父元件鏈是
Child /><
—
SubNode /><
—
Node /><
,
App /><
的父元件鏈是
SubNode /><
—
Node /><
,
App /><
的父元件鏈只有一個元件節點,就是
Node /><
。
App />
這些以樹狀連線的元件節點,實際上也組成了一棵Context
樹,每個節點的Context
,來自父元件鏈上所有元件節點通過getChildContext()
所提供的Context
物件組合而成的物件。
有了解JS作用域鏈概念的開發者應該都知道,JS的程式碼塊在執行期間,會建立一個相應的作用域鏈,這個作用域鏈記錄著執行時JS程式碼塊執行期間所能訪問的活動物件,包括變數和函式,JS程式通過作用域鏈訪問到程式碼塊內部或者外部的變數和函式。
假如以JS的作用域鏈作為類比,React元件提供的Context
物件其實就好比一個提供給子元件訪問的作用域,而Context
物件的屬性可以看成作用域上的活動物件。由於元件的Context
由其父節點鏈上所有元件通過getChildContext()
返回的Context
物件組合而成,所以,元件通過Context
是可以訪問到其父元件鏈上所有節點元件提供的Context
的屬性。
所以,我借鑑了JS作用域鏈的思路,把Context
當成是元件的作用域來使用。
關注Context的可控性和影響範圍
不過,作為元件作用域來看待的Context
與常見的作用域的概念 (就我個人目前接觸到的程式語言而言) 是有所區別的。我們需要關注Context
的可控性和影響範圍。
在我們平時的開發中,用到作用域或者上下文的場景是很常見,很自然,甚至是無感知的,然而,在React中使用Context
並不是那麼容易。父元件提供Context
需要通過childContextTypes
進行“宣告”,子元件使用父元件的Context
屬性需要通過contextTypes
進行“申請”,所以,我認為React的Context
是一種**“帶許可權”的元件作用域**。
這種“帶許可權”的方式有何好處?就我個人的理解,首先是保持框架API的一致性,和propTypes
一樣,使用宣告式編碼風格。另外就是,可以在一定程度上確保元件所提供的Context
的可控性和影響範圍。
React App的元件是樹狀結構,一層一層延伸,父子元件是一對多的線性依賴。隨意的使用Context
其實會破壞這種依賴關係,導致元件之間一些不必要的額外依賴,降低元件的複用性,進而可能會影響到App的可維護性。
通過上圖可以看到,原本線性依賴的元件樹,由於子元件使用了父元件的Context
,導致<
元件對
Child /><
和
Node /><
都產生了依賴關係。一旦脫離了這兩個元件,
App /><
的可用性就無法保障了,減低了
Child /><
的複用性。
Child />
在我看來,通過Context
暴露資料或者API不是一種優雅的實踐方案,儘管react-redux是這麼幹的。因此需要一種機制,或者說約束,去降低不必要的影響。
通過childContextTypes
和contextTypes
這兩個靜態屬性的約束,可以在一定程度保障,只有元件自身,或者是與元件相關的其他子元件才可以隨心所欲的訪問Context
的屬性,無論是資料還是函式。因為只有元件自身或者相關的子元件可以清楚它能訪問Context
哪些屬性,而相對於那些與元件無關的其他元件,無論是內部或者外部的 ,由於不清楚父元件鏈上各父元件的childContextTypes
“宣告”了哪些Context
屬性,所以沒法通過contextTypes
“申請”相關的屬性。所以我理解為,給元件的作用域Context
“帶許可權”,可以在一定程度上確保Context
的可控性和影響範圍。
在開發元件過程中,我們應該時刻關注這一點,不要隨意的使用Context
。
不需要優先使用Context
作為React的高階API,React並不推薦我們優先考慮使用Context
。我的理解是:
Context
目前還處於實驗階段,可能會在後面的發行版本中有大的變化,事實上這種情況已經發生了,所以為了避免給今後升級帶來較大影響和麻煩,不建議在App中使用Context
。- 儘管不建議在App中使用
Context
,但對於元件而言,由於影響範圍小於App,如果可以做到高內聚,不破壞元件樹的依賴關係,那麼還是可以考慮使用Context
的。 - 對於元件之間的資料通訊或者狀態管理,優先考慮用
props
或者state
解決,然後再考慮用其他第三方成熟庫解決的,以上方法都不是最佳選擇的時候,那麼再考慮使用Context
。 Context
的更新需要通過setState()
觸發,但是這並不是可靠的。Context
支援跨元件訪問,但是,如果中間的子元件通過一些方法不響應更新,比如shouldComponentUpdate()
返回false
,那麼不能保證Context
的更新一定可達使用Context
的子元件。因此,Context
的可靠性需要關注。不過更新的問題,在新版的API中得以解決。
簡而言之,只要你能確保Context
是可控的,使用Context
並無大礙,甚至如果能夠合理的應用,Context
其實可以給React元件開發帶來很強大的體驗。
用Context作為共享資料的媒介
官方所提到Context
可以用來進行跨元件的資料通訊。而我,把它理解為,好比一座橋,作為一種作為媒介進行資料共享。資料共享可以分兩類:App級與元件級。
- App級的資料共享
App根節點元件提供的Context
物件可以看成是App級的全域性作用域,所以,我們利用App根節點元件提供的Context
物件建立一些App級的全域性資料。現成的例子可以參考react-redux,以下是<
元件原始碼的核心實現:
Provider />
export function createProvider(storeKey = 'store', subKey) {
const subscriptionKey = subKey || `${storeKey
}Subscription` class Provider extends Component {
getChildContext() {
return {
[storeKey]: this[storeKey], [subscriptionKey]: null
}
} constructor(props, context) {
super(props, context) this[storeKey] = props.store;
} render() {
return Children.only(this.props.children)
}
} // ...... Provider.propTypes = {
store: storeShape.isRequired, children: PropTypes.element.isRequired,
} Provider.childContextTypes = {
[storeKey]: storeShape.isRequired, [subscriptionKey]: subscriptionShape,
} return Provider
}export default createProvider()複製程式碼
App的根元件用<
元件包裹後,本質上就為App提供了一個全域性的屬性
Provider />store
,相當於在整個App範圍內,共享store
屬性。當然,<
元件也可以包裹在其他元件中,在元件級的全域性範圍內共享
Provider />store
。
- 元件級的資料共享
如果元件的功能不能單靠元件自身來完成,還需要依賴額外的子元件,那麼可以利用Context
構建一個由多個子元件組合的元件。例如,react-router。
react-router的<
自身並不能獨立完成路由的操作和管理,因為導航連結和跳轉的內容通常是分離的,因此還需要依賴
Router /><
和
Link /><
等子元件來一同完成路由的相關工作。為了讓相關的子元件一同發揮作用,react-router的實現方案是利用
Route />Context
在<
、
Router /><
以及
Link /><
這些相關的元件之間共享一個
Route />router
,進而完成路由的統一操作和管理。
下面擷取<
、
Router /><
以及
Link /><
這些相關的元件部分原始碼,以便更好的理解上述所說的。
Route />
// Router.js/** * The public API for putting history on context. */class Router extends React.Component {
static propTypes = {
history: PropTypes.object.isRequired, children: PropTypes.node
};
static contextTypes = {
router: PropTypes.object
};
static childContextTypes = {
router: PropTypes.object.isRequired
};
getChildContext() {
return {
router: {
...this.context.router, history: this.props.history, route: {
location: this.props.history.location, match: this.state.match
}
}
};
} // ...... componentWillMount() {
const {
children, history
} = this.props;
// ...... this.unlisten = history.listen(() =>
{
this.setState({
match: this.computeMatch(history.location.pathname)
});
});
} // ......
}複製程式碼
儘管原始碼還有其他的邏輯,但<
的核心就是為子元件提供一個帶有
Router />router
屬性的Context
,同時監聽history
,一旦history
發生變化,便通過setState()
觸發元件重新渲染。
// Link.js/** * The public API for rendering a history-aware <
a>
. */class Link extends React.Component {
// ...... static contextTypes = {
router: PropTypes.shape({
history: PropTypes.shape({
push: PropTypes.func.isRequired, replace: PropTypes.func.isRequired, createHref: PropTypes.func.isRequired
}).isRequired
}).isRequired
};
handleClick = event =>
{
if (this.props.onClick) this.props.onClick(event);
if ( !event.defaultPrevented &
&
event.button === 0 &
&
!this.props.target &
&
!isModifiedEvent(event) ) {
event.preventDefault();
// 使用<
Router />
元件提供的router例項 const {
history
} = this.context.router;
const {
replace, to
} = this.props;
if (replace) {
history.replace(to);
} else {
history.push(to);
}
}
};
render() {
const {
replace, to, innerRef, ...props
} = this.props;
// ... const {
history
} = this.context.router;
const location = typeof to === "string" ? createLocation(to, null, null, history.location) : to;
const href = history.createHref(location);
return ( <
a {...props
} onClick={this.handleClick
} href={href
} ref={innerRef
} />
);
}
}複製程式碼
<
的核心就是渲染
Link /><
標籤,攔截
a><
標籤的點選事件,然後通過
a><
共享的
Router />router
對history
進行路由操作,進而通知<
重新渲染。
Router />
// Route.js/** * The public API for matching a single path and rendering. */class Route extends React.Component {
// ...... state = {
match: this.computeMatch(this.props, this.context.router)
};
// 計算匹配的路徑,匹配的話,會返回一個匹配物件,否則返回null computeMatch( {
computedMatch, location, path, strict, exact, sensitive
}, router ) {
if (computedMatch) return computedMatch;
// ...... const {
route
} = router;
const pathname = (location || route.location).pathname;
return matchPath(pathname, {
path, strict, exact, sensitive
}, route.match);
} // ...... render() {
const {
match
} = this.state;
const {
children, component, render
} = this.props;
const {
history, route, staticContext
} = this.context.router;
const location = this.props.location || route.location;
const props = {
match, location, history, staticContext
};
if (component) return match ? React.createElement(component, props) : null;
if (render) return match ? render(props) : null;
if (typeof children === "function") return children(props);
if (children &
&
!isEmptyChildren(children)) return React.Children.only(children);
return null;
}
}複製程式碼
<
有一部分原始碼與
Route /><
相似,可以實現路由的巢狀,但其核心是通過
Router />Context
共享的router
,判斷是否匹配當前路由的路徑,然後渲染元件。
通過上述的分析,可以看出,整個react-router其實就是圍繞著<
的
Router />Context
來構建的。
使用Context開發元件
之前,通過Context
開發過一個簡單的元件,插槽分發元件。本章就藉著這個插槽分發元件的開發經歷,聊聊如何使用Context
進行元件的開發。
插槽分發元件
首先說說什麼是插槽分發元件,這個概念最初是在Vuejs中認識的。插槽分發是一種通過元件的組合,將父元件的內容插入到子元件模板的技術,在Vuejs中叫做Slot
。
為了讓大家更加直觀的理解這個概念,我從Vuejs搬運了一段關於插槽分發的Demo。
對於提供的插槽的元件<
,模板如下:
my-component />
<
div>
<
h2>
我是子元件的標題<
/h2>
<
slot>
只有在沒有要分發的內容時顯示 <
/slot>
<
/div>
複製程式碼
對於父元件,模板如下:
<
div>
<
h1>
我是父元件的標題<
/h1>
<
my-component>
<
p>
這是一些初始內容<
/p>
<
p>
這是更多的初始內容<
/p>
<
/my-component>
<
/div>
複製程式碼
最終渲染的結果:
<
div>
<
h1>
我是父元件的標題<
/h1>
<
div>
<
h2>
我是子元件的標題<
/h2>
<
p>
這是一些初始內容<
/p>
<
p>
這是更多的初始內容<
/p>
<
/div>
<
/div>
複製程式碼
可以看到元件<
的
my-component /><
節點最終被父元件中
slot /><
節點下的內容所替換。
my-component />
Vuejs還支援具名插槽。
例如,一個佈局元件<
:
app-layout />
<
div class="container">
<
header>
<
slot name="header">
<
/slot>
<
/header>
<
main>
<
slot>
<
/slot>
<
/main>
<
footer>
<
slot name="footer">
<
/slot>
<
/footer>
<
/div>
複製程式碼
而在父元件模板中:
<
app-layout>
<
h1 slot="header">
這裡可能是一個頁面標題<
/h1>
<
p>
主要內容的一個段落。<
/p>
<
p>
另一個段落。<
/p>
<
p slot="footer">
這裡有一些聯絡資訊<
/p>
<
/app-layout>
複製程式碼
最終渲染的結果:
<
div class="container">
<
header>
<
h1>
這裡可能是一個頁面標題<
/h1>
<
/header>
<
main>
<
p>
主要內容的一個段落。<
/p>
<
p>
另一個段落。<
/p>
<
/main>
<
footer>
<
p>
這裡有一些聯絡資訊<
/p>
<
/footer>
<
/div>
複製程式碼
插槽分發的好處體現在,它可以讓元件具有可抽象成模板的能力。元件自身只關心模板結構,具體的內容交給父元件去處理,同時,不打破HTML描述DOM結構的語法表達方式。我覺得這是一項很有意義的技術,可惜,React對於這項技術的支援不是那麼友好。於是我便參考Vuejs的插槽分發元件,開發了一套基於React的插槽分發元件,可以讓React元件也具模板化的能力。
對於<
元件,我希望可以寫成下面這樣:
AppLayout />
class AppLayout extends React.Component {
static displayName = 'AppLayout' render () {
return ( <
div class="container">
<
header>
<
Slot name="header">
<
/Slot>
<
/header>
<
main>
<
Slot>
<
/Slot>
<
/main>
<
footer>
<
Slot name="footer">
<
/Slot>
<
/footer>
<
/div>
)
}
}複製程式碼
在外層使用時,可以寫成這樣:
<
AppLayout>
<
AddOn slot="header">
<
h1>
這裡可能是一個頁面標題<
/h1>
<
/AddOn>
<
AddOn>
<
p>
主要內容的一個段落。<
/p>
<
p>
另一個段落。<
/p>
<
/AddOn>
<
AddOn slot="footer">
<
p>
這裡有一些聯絡資訊<
/p>
<
/AddOn>
<
/AppLayout>
複製程式碼
元件的實現思路
根據前面所想的,先整理一下實現思路。
不難看出,插槽分發元件需要依靠兩個子元件——插槽元件<
和分發元件
Slot /><
。插槽元件,負責打樁,提供分發內容的坑位。分發元件,負責收集分發內容,並提供給插槽元件去渲染分發內容,相當於插槽的消費者。
AddOn />
顯然,這裡遇到了一個問題,<
元件與
Slot /><
元件是獨立的,如何將
AddOn /><
的內容填充到
AddOn /><
中呢?解決這個問題不難,兩個獨立的模組需要建立聯絡,就給他們建立一個橋樑。那麼這個橋樑要如何搭建呢?回過頭來看看之前的設想的程式碼。
Slot />
對於<
元件,希望寫成下面這樣:
AppLayout />
class AppLayout extends React.Component {
static displayName = 'AppLayout' render () {
return ( <
div class="container">
<
header>
<
Slot name="header">
<
/Slot>
<
/header>
<
main>
<
Slot>
<
/Slot>
<
/main>
<
footer>
<
Slot name="footer">
<
/Slot>
<
/footer>
<
/div>
)
}
}複製程式碼
在外層使用時,寫成這樣:
<
AppLayout>
<
AddOn slot="header">
<
h1>
這裡可能是一個頁面標題<
/h1>
<
/AddOn>
<
AddOn>
<
p>
主要內容的一個段落。<
/p>
<
p>
另一個段落。<
/p>
<
/AddOn>
<
AddOn slot="footer">
<
p>
這裡有一些聯絡資訊<
/p>
<
/AddOn>
<
/AppLayout>
複製程式碼
無論是<
還是
Slot /><
,其實都在
AddOn /><
的作用域內。
AppLayout /><
是
Slot /><
元件
AppLayout />render()
方法返回的元件節點,而<
則是
AddOn /><
的
AppLayout />children
節點,所以,可以將<
視為
AppLayout /><
與
Slot /><
的橋樑的角色。那麼,
AddOn /><
通過什麼給
AppLayout /><
和
Slot /><
建立聯絡呢?這裡就用到本文的主角——
AddOn />Context
。接下來的問題就是,如何使用Context
給<
和
Slot /><
建立聯絡?
AddOn />
前面提到了<
這座橋樑。在外層元件,
AppLayout /><
負責通過
AppLayout /><
收集為插槽填充的內容。
AddOn /><
自身藉助
AppLayout />Context
定義一個獲取填充內容的介面。在渲染的時候,因為<
是
Slot /><
渲染的節點,所以,
AppLayout /><
可以通過
Slot />Context
獲取到<
定義的獲取填充內容的介面,然後通過這個介面,獲取到填充內容進行渲染。
AppLayout />
按照思路實現插槽分發元件
由於<
是
AddOn /><
的
AppLayout />children
節點,並且<
是特定的元件,我們可以通過
AddOn />name
或者displayName
識別出來,所以,<
在渲染之前,也就是
AppLayout />render()
的return
之前,對children
進行遍歷,以slot
的值作為key
,將每一個<
的
AddOn />children
快取下來。如果<
沒有設定
AddOn />slot
,那麼將其視為給非具名的<
填充內容,我們可以給這些非具名的插槽定一個
Slot />key
,比如叫$$default
。
對於<
,程式碼大致如下:
AppLayout />
class AppLayout extends React.Component {
static childContextTypes = {
requestAddOnRenderer: PropTypes.func
} // 用於快取每個<
AddOn />
的內容 addOnRenderers = {
} // 通過Context為子節點提供介面 getChildContext () {
const requestAddOnRenderer = (name) =>
{
if (!this.addOnRenderers[name]) {
return undefined
} return () =>
( this.addOnRenderers[name] )
} return {
requestAddOnRenderer
}
} render () {
const {
children, ...restProps
} = this.props if (children) {
// 以k-v的方式快取<
AddOn />
的內容 const arr = React.Children.toArray(children) const nameChecked = [] this.addOnRenderers = {
} arr.forEach(item =>
{
const itemType = item.type if (item.type.displayName === 'AddOn') {
const slotName = item.props.slot || '$$default' // 確保內容唯一性 if (nameChecked.findIndex(item =>
item === stubName) !== -1) {
throw new Error(`Slot(${slotName
}) has been occupied`)
} this.addOnRenderers[stubName] = item.props.children nameChecked.push(stubName)
}
})
} return ( <
div class="container">
<
header>
<
Slot name="header">
<
/Slot>
<
/header>
<
main>
<
Slot>
<
/Slot>
<
/main>
<
footer>
<
Slot name="footer">
<
/Slot>
<
/footer>
<
/div>
)
}
}複製程式碼
<
定義了一個
AppLayout />Context
介面requestAddOnRenderer()
,requestAddOnRenderer()
介面根據name
返回一個函式,這個返回的函式會根據name
訪問addOnRenderers
的屬性,addOnRenderers
就是<
的內容快取物件。
AddOn />
<
的實現很簡單,程式碼如下:
Slot />
// props, contextconst Slot = ({
name, children
}, {
requestAddOnRenderer
}) =>
{
const addOnRenderer = requestAddOnRenderer(name) return (addOnRenderer &
&
addOnRenderer()) || children || null
}Slot.displayName = 'Slot'Slot.contextTypes = {
requestAddOnRenderer: PropTypes.func
}Slot.propTypes = {
name: PropTypes.string
}Slot.defaultProps = {
name: '$$default'
}複製程式碼
可以看到<
通過
Slot />context
獲取到<
提供的介面
AppLayout />requestAddOnRenderer()
,最終渲染的主要物件就是快取在<
中的
AppLayout /><
的內容。如果沒有獲取到指定的
AddOn /><
的內容,則渲染
AddOn /><
自身的
Slot />children
。
<
更簡單:
AddOn />
const AddOn = () =>
nullAddOn.propTypes = {
slot: PropTypes.string
}AddOn.defaultTypes = {
slot: '$$default'
}AddOn.displayName = 'AddOn'複製程式碼
<
不做任何事情,僅僅返回
AddOn />null
,它的作用就是讓<
快取分發給插槽的內容。
AppLayout />
可以讓<
AppLayout />
更具通用性
AppLayout />
通過上文的程式碼,基本將<
改造成了一個具備插槽分發能力的元件,但是很明顯的,
AppLayout /><
並不具備通用性,我們可以將它提升成一個獨立通用的元件。
AppLayout />
我給這個元件命名為SlotProvider
function getDisplayName (component) {
return component.displayName || component.name || 'component'
}const slotProviderHoC = (WrappedComponent) =>
{
return class extends React.Component {
static displayName = `SlotProvider(${getDisplayName(WrappedComponent)
})` static childContextTypes = {
requestAddOnRenderer: PropTypes.func
} // 用於快取每個<
AddOn />
的內容 addOnRenderers = {
} // 通過Context為子節點提供介面 getChildContext () {
const requestAddOnRenderer = (name) =>
{
if (!this.addOnRenderers[name]) {
return undefined
} return () =>
( this.addOnRenderers[name] )
} return {
requestAddOnRenderer
}
} render () {
const {
children, ...restProps
} = this.props if (children) {
// 以k-v的方式快取<
AddOn />
的內容 const arr = React.Children.toArray(children) const nameChecked = [] this.addOnRenderers = {
} arr.forEach(item =>
{
const itemType = item.type if (item.type.displayName === 'AddOn') {
const slotName = item.props.slot || '$$default' // 確保內容唯一性 if (nameChecked.findIndex(item =>
item === stubName) !== -1) {
throw new Error(`Slot(${slotName
}) has been occupied`)
} this.addOnRenderers[stubName] = item.props.children nameChecked.push(stubName)
}
})
} return (<
WrappedComponent {...restProps
} />
)
}
}
}export const SlotProvider = slotProviderHoC複製程式碼
使用React的高階元件對原來的<
進行改造,將其轉變為一個獨立通用的元件。對於原來的
AppLayout /><
,可以使用這個
AppLayout />SlotProvider
高階元件,轉換成一個具備插槽分發能力的元件。
import {
SlotProvider
} from './SlotProvider.js'class AppLayout extends React.Component {
static displayName = 'AppLayout' render () {
return ( <
div class="container">
<
header>
<
Slot name="header">
<
/Slot>
<
/header>
<
main>
<
Slot>
<
/Slot>
<
/main>
<
footer>
<
Slot name="footer">
<
/Slot>
<
/footer>
<
/div>
)
}
}export default SlotProvider(AppLayout)複製程式碼
通過以上的經歷,可以看到,當設計開發一個元件時,
- 元件可能需要由一個根元件和多個子元件一起合作來完成元件功能。比如插槽分發元件實際上需要
SlotProvider
與<
和
Slot /><
一起配合使用,
AddOn />SlotProvider
作為根元件,而<
和
Slot /><
都算是子元件。
AddOn /> - 子元件相對於根元件的位置或者子元件之間的位置是不確定。對於
SlotProvider
而言,<
的位置是不確定的,它會處在被
Slot />SlotProvider
這個高階元件所包裹的元件的模板的任何位置,而對於<
和
Slot /><
,他們直接的位置也不確定,一個在
AddOn />SlotProvider
包裝的元件的內部,另一個是SlotProvider
的children
。 - 子元件之間需要依賴一些全域性態的API或者資料,比如
<
實際渲染的內容來自於
Slot />SlotProvider
收集到的<
的內容。
AddOn />
這時我們就需要藉助一箇中間者作為媒介來共享資料,相比額外引入redux這些第三方模組,直接使用Context
可以更優雅。
嘗試一下新版本的Context API
使用新版的Context API對之前的插槽分發元件進行改造。
// SlotProvider.jsfunction getDisplayName (component) {
return component.displayName || component.name || 'component'
}export const SlotContext = React.createContext({
requestAddOnRenderer: () =>
{
}
})const slotProviderHoC = (WrappedComponent) =>
{
return class extends React.Component {
static displayName = `SlotProvider(${getDisplayName(WrappedComponent)
})` // 用於快取每個<
AddOn />
的內容 addOnRenderers = {
} requestAddOnRenderer = (name) =>
{
if (!this.addOnRenderers[name]) {
return undefined
} return () =>
( this.addOnRenderers[name] )
} render () {
const {
children, ...restProps
} = this.props if (children) {
// 以k-v的方式快取<
AddOn />
的內容 const arr = React.Children.toArray(children) const nameChecked = [] this.addOnRenderers = {
} arr.forEach(item =>
{
const itemType = item.type if (item.type.displayName === 'AddOn') {
const slotName = item.props.slot || '$$default' // 確保內容唯一性 if (nameChecked.findIndex(item =>
item === stubName) !== -1) {
throw new Error(`Slot(${slotName
}) has been occupied`)
} this.addOnRenderers[stubName] = item.props.children nameChecked.push(stubName)
}
})
} return ( <
SlotContext.Provider value={
requestAddOnRenderer: this.requestAddOnRenderer
}>
<
WrappedComponent {...restProps
} />
<
/SlotContext.Provider>
)
}
}
}export const SlotProvider = slotProviderHoC複製程式碼
移除了之前的childContextTypes
和getChildContext()
,除了區域性的調整,整體核心的東西沒有大變化。
// Slot.jsimport {
SlotContext
} from './SlotProvider.js'const Slot = ({
name, children
}) =>
{
return ( <
SlotContext.Consumer>
{(context) =>
{
const addOnRenderer = requestAddOnRenderer(name) return (addOnRenderer &
&
addOnRenderer()) || children || null
}
} <
/SlotContext.Consumer>
)
}Slot.displayName = 'Slot'Slot.propTypes = {
name: PropTypes.string
}Slot.defaultProps = {
name: '$$default'
}複製程式碼
由於之前就按照生產者消費者的模式來使用Context
,加上元件自身也比較簡單,因此使用新的API進行改造後,差別不大。
總結
- 相比
props
和state
,React的Context
可以實現跨層級的元件通訊。 - Context API的使用基於生產者消費者模式。生產者一方,通過元件靜態屬性
childContextTypes
宣告,然後通過例項方法getChildContext()
建立Context
物件。消費者一方,通過元件靜態屬性contextTypes
申請要用到的Context
屬性,然後通過例項的context
訪問Context
的屬性。 - 使用
Context
需要多一些思考,不建議在App中使用Context
,但如果開發元件過程中可以確保元件的內聚性,可控可維護,不破壞元件樹的依賴關係,影響範圍小,可以考慮使用Context
解決一些問題。 - 通過
Context
暴露API或許在一定程度上給解決一些問題帶來便利,但個人認為不是一個很好的實踐,需要慎重。 - 舊版本的
Context
的更新需要依賴setState()
,是不可靠的,不過這個問題在新版的API中得以解決。 - 可以把
Context
當做元件的作用域來看待,但是需要關注Context
的可控性和影響範圍,使用之前,先分析是否真的有必要使用,避免過度使用所帶來的一些副作用。 - 可以把
Context
當做媒介,進行App級或者元件級的資料共享。 - 設計開發一個元件,如果這個元件需要多個元件關聯組合的,使用
Context
或許可以更加優雅。
以上是我的分享內容,如有不足或者錯誤的地方,歡迎批評指正。
引用
- Context – https://reactjs.org/docs/context.html
- React 16.3來了:帶著全新的Context API – http://cnodejs.org/topic/5a7bd5c4497a08f571384f03
- Content Distribution with Slots – https://vuejs.org/v2/guide/components.html#Content-Distribution-with-Slots
- 題圖 – http://www.mafengwo.cn/poi/36580.html