React 是 Facebook 的工程師打造的前端框架,核心亮點是實作了一個虛擬 DOM——需要的元件加上去、不需要的移除,都由它高效處理。React 在 MVC 中扮演 V 的角色,若搭配 Flux 使用,還能讓 M 與 V 的同步變得輕鬆。
在 React 中,你可以建立具備特定功能的元件,這是純 HTML 做不到的——比如本文要做的下拉導覽。每個元件都有自己的作用域,因此定義一次便能反覆使用,彼此之間不需要互相干擾。
每個元件都有一個 render 方法,負責高效地回傳要渲染到瀏覽器上的 HTML。我們也可以在 render 中呼叫其他 React 元件,讓元件得以巢狀組合。
JSX 允許我們在 JavaScript 中直接寫 HTML 標記,而不是反過來用 HTML 包住 JavaScript。它能加快開發速度,因為不必再為字串拼接與換行操心。
技術上你可以在瀏覽器中直接執行 JSX,但這麼做會拖慢頁面速度,不建議在正式環境使用。gulp 與 grunt 這類建置工具都提供了 JSX 轉譯器,我建議把它放進預處理流程。
每個元件的 render 會產生一個「視圖模型」——在把 HTML 回傳給元件之前,你可以先在此放入資料,讓畫面依模型動態變化(例如動態列表)。
var ExampleComponent = React.createClass({
render: function () {
return (
<div className="navigation">
Hello World!
</div>
);
}
});
直接在瀏覽器執行這段程式碼只會得到語法錯誤,因為 JavaScript 中的 < 與 > 必須被視為運算子。經過 JSX 轉譯後,它會變成:
var ExampleComponent = React.createClass({
render: function () {
return (
React.createElement('div', {className: 'navigation'}, 'Hello World!')
);
}
});
JSX 會把每個標籤翻譯成 React.createElement 呼叫,產生節點型別、屬性與內容。你当然可以不用 JSX,但那就得親手寫出每一層 createElement。
你一定好奇為什麼這裡用 className 而不是 class。因為 class 是 JavaScript 的保留字。JSX 轉譯時會把標籤屬性收攏成一個物件,而物件裡不能放保留字當 key。
若想動態改變元件的樣式類(或任何屬性值),可以用變數,但要記得用一對大括號把它包起來,JSX 才知道那是外部變數:
var ExampleComponent = React.createClass({
render: function () {
var navigationClass = 'navigation';
return (
<div className={ navigationClass }>
Hello World!
</div>
);
}
});
要渲染一個 React 元件,需告訴 React 渲染哪個元件、掛在哪個既有的 DOM 節點上,這由 React.render 負責:
var ExampleComponent = React.createClass({
render: function () {
return (
<div className="navigation">
Hello World!
</div>
);
}
});
React.render(<ExampleContent />, document.body);
它會把元件渲染到 body 上。之後你就能像一般方式那樣呼叫其他元件;若想保留頁面其餘部分,也可以多次呼叫 render,只讓部分區域由 React 接管。
元件可以擁有自己的「狀態」,這讓我們能重複使用同一個元件,卻讓每個實例看起來完全不同,因為各自的狀態彼此獨立。
而從外部傳進元件的資料稱為「屬性」(props)。內容不限於 HTML 屬性——你想傳什麼都可以,並在元件內透過 this.props 存取。這讓我們能重用同一個元件,只是傳入不同的設定。
對下拉導覽來說,我們需要把導覽設定作為物件傳入:
var navigationConfig = [];
var Navigation = React.createClass({
render: function () {
return (
<div className="navigation"></div>
);
}
});
React.render(<Navigation config={ navigationConfig } />, document.body);
此時若存取 this.props.config,會得到一個空陣列。
狀態則是元件自己維護的資料。使用時要先定義初始狀態,之後透過 this.setState 更新。每當狀態更新,元件都會再次呼叫 render,用新值取代或修改先前渲染的結果。這正是虛擬 DOM 的精髓——差異計算在 React 內部完成,我們不必依賴緩慢的 DOM 更新。React 會算出最小差異並產生一批指令(例如為 navigation__link 加上 active 類,或移除某個節點),再作用到 DOM 上。
我們用狀態來記錄目前展開的是哪一個下拉選單。加上 getInitialState 並回傳初始狀態:
var Navigation = React.createClass({
getInitialState: function () {
return { openDropdown: -1 };
},
render: function () {
return (
<div className="navigation"></div>
);
}
});
這裡設為 -1 是因為我們稍後會用狀態裡的索引指向設定陣列中的某一項,而陣列索引從 0 開始,因此 -1 代表「目前沒有展開任何一項」。存取時用 this.state.openDropdown 即可。
每個元件都有「生命週期」——一系列你可以在元件設定中定義的函數,會在元件生命的不同階段被呼叫。前面看過的 getInitialState 就是其中之一,它只在元件掛載時被呼叫一次。
componentWillMount
在元件即將掛載時呼叫。由於 render 在元件生命週期中會被呼叫多次,我們通常把只需執行一次的程式放在這裡,例如 XHR 請求。
var ExampleComponent = React.createClass({
componentWillMount: function () {
// 在此發出 XHR 請求取得資料
},
render: function () {
// 這個方法在元件生命週期中會被呼叫很多次
return (
<div>Hello World!</div>
);
}
});
componentDidMount
當 render 執行完、元件已實際渲染進 DOM 之後呼叫。任何需要操作 DOM 的工作都放在這裡,例如繪製圖表。可透過 this.getDOMNode() 取得 DOM 節點。
var ExampleComponent = React.createClass({
componentDidMount: function () {
var node = this.getDOMNode();
// 在該節點上渲染圖表
},
render: function () {
return (
<div>Hello World!</div>
);
}
});
componentWillUnmount
在元件即將從 DOM 移除時呼叫。這讓我們能做善後清理,例如移除已綁定的事件監聽器。若沒清理,當某個事件被觸發而元件已不存在時,React 就會拋出錯誤。
var ExampleComponent = React.createClass({
componentWillUnmount: function () {
// 解除此元件專屬的事件監聽器
},
render: function () {
return (
<div>Hello World!</div>
);
}
});
getDefaultProps 讓我們為屬性定義預設值。如此一來,呼叫元件時即使沒給值,元件仍有一份合理的預設「設定」,不必在程式碼裡處處檢查屬性是否存在。
這些預設屬性會被快取,因此對每個元件實例都相同且不可變動。對導覽元件,我們把設定指定為空陣列,這樣即使沒傳入設定,render 內也不會出錯。
var Navigation = React.createClass({
getInitialState: function () {
return { openDropdown: -1 };
},
getDefaultProps: function () {
return { config: [] };
},
render: function () {
return (
<div className="navigation"></div>
);
}
});
propTypes 則可為每個屬性指定型別,這在檢查意外的賦值時很有用。以下指定只有陣列才能放進設定:
var Navigation = React.createClass({
getInitialState: function () {
return { openDropdown: -1 };
},
getDefaultProps: function () {
return { config: [] };
},
propTypes: {
config: React.PropTypes.array
},
render: function () {
return (
<div className="navigation"></div>
);
}
});
我們也能在元件中加入 mixins。它是一個獨立於 React 的設定物件,讓我們在多個元件間共享邏輯(例如初始狀態相同、或需要綁定同一批事件)。
var ExampleMixin = {
componentDidMount: function () {
// 在此綁定事件監聽器
},
componentWillUnmount: function () {
// 在此解除綁定
}
};
var ExampleComponent = React.createClass({
mixins: [ExampleMixin],
render: function () {
return (<div>Hello World!</div>);
}
});
var AnotherComponent = React.createClass({
mixins: [ExampleMixin],
render: function () {
return (<div>Hello World!</div>);
}
});
如此一來,兩個元件都具備相同的 componentDidMount 與 componentWillUnmount,省下重複撰寫。但要留意:mixin 中已設定的方法無法在元件內覆蓋。
當我們有一個物件陣列,該如何遍歷並把每一項渲染成列表項?由於 JSX 本質上就是 JavaScript,我們可以直接 map 這個陣列並回傳 JSX:
var navigationConfig = [
{ href: 'https://example.com', text: 'My Website' }
];
var Navigation = React.createClass({
getInitialState: function () {
return { openDropdown: -1 };
},
getDefaultProps: function () {
return { config: [] };
},
propTypes: {
config: React.PropTypes.array
},
render: function () {
var config = this.props.config;
var items = config.map(function (item) {
return (
<li className="navigation__item">
<a className="navigation__link" href={ item.href }>
{ item.text }
</a>
</li>
);
});
return (
<div className="navigation">
{ items }
</div>
);
}
});
React.render(<Navigation config={ navigationConfig } />, document.body);
設定由陣列與物件組成,每個物件有指向超連結的 href 與用於顯示的 text。map 時逐一取出物件並在 HTML 中使用其屬性;回傳的陣列交給 React 處理,它自然知道該如何渲染。
接著處理下拉項目。我們用 children 屬性來表示子項目,並在迴圈中把子元素渲染出來:
var navigationConfig = [
{
href: 'https://example.com',
text: 'My Website',
children: [
{ href: 'https://example.com/a', text: '子項目 A' },
{ href: 'https://example.com/b', text: 'React' }
]
}
];
var Navigation = React.createClass({
getInitialState: function () {
return { openDropdown: -1 };
},
getDefaultProps: function () {
return { config: [] };
},
propTypes: {
config: React.PropTypes.array
},
render: function () {
var config = this.props.config;
var items = config.map(function (item) {
var children, dropdown;
if (item.children) {
children = item.children.map(function (child) {
return (
<li className="navigation__dropdown__item">
<a className="navigation__dropdown__link" href={ child.href }>
{ child.text }
</a>
</li>
);
});
dropdown = (
<ul className="navigation__dropdown">
{ children }
</ul>
);
}
return (
<li className="navigation__item">
<a className="navigation__link" href={ item.href }>
{ item.text }
</a>
{ dropdown }
</li>
);
});
return (
<div className="navigation">
{ items }
</div>
);
}
});
此時子項目仍會全部顯示,因為 openDropdown 還是 -1,我們尚未把它與樣式連上。
透過 this.state 我們可以判斷哪一個下拉該展開,並動態加上對應的 CSS 類別:
var Navigation = React.createClass({
getInitialState: function () {
return { openDropdown: -1 };
},
getDefaultProps: function () {
return { config: [] };
},
propTypes: {
config: React.PropTypes.array
},
openDropdown: function (id) {
this.setState({ openDropdown: id });
},
closeDropdown: function () {
this.setState({ openDropdown: -1 });
},
render: function () {
var config = this.props.config;
var items = config.map(function (item, index) {
var children, dropdown;
if (item.children) {
children = item.children.map(function (child) {
return (
<li className="navigation__dropdown__item">
<a className="navigation__dropdown__link" href={ child.href }>
{ child.text }
</a>
</li>
);
});
var dropdownClass = 'navigation__dropdown';
if (this.state.openDropdown === index) {
dropdownClass += ' navigation__dropdown--open';
}
dropdown = (
<ul className={ dropdownClass }>
{ children }
</ul>
);
}
return (
<li className="navigation__item"
onMouseOut={ this.closeDropdown }
onMouseOver={ this.openDropdown.bind(this, index) }>
<a className="navigation__link" href={ item.href }>
{ item.text }
</a>
{ dropdown }
</li>
);
}, this);
return (
<div className="navigation">
{ items }
</div>
);
}
});
React.render(<Navigation config={ navigationConfig } />, document.body);
滑鼠移入「My Website」時,對應的下拉便會展開。
這裡有兩個細節值得說明。第一,map 的第二個參數傳入了 this,因為在 map 的回呼函數中我們需要存取 this.state,若未綁定 this,它就會指向錯誤的物件。第二,onMouseOver 使用了 bind(this, index):滑鼠移出時我們只需關閉下拉,不需要知道是哪一項,所以 closeDropdown 可以直接傳;但移入時必須知道是哪個索引被展開,因此需要透過 bind 預先帶入參數。若直接呼叫函數,它會在渲染時立即執行,而非等到事件發生。
完成後,我們就能自由地往 navigationConfig 增加項目,也能為下拉效果補上 transition 之類的樣式細節。
需要說明的是,範例中的 React.createClass、React.PropTypes、mixins 與 this.getDOMNode() 都屬於 React 早期寫法。以今日的標準而言:
useState、useEffect)撰寫,mixins 已改由自訂 Hook 取代。PropTypes 已獨立為 prop-types 套件,多數專案改用 TypeScript 在編譯期檢查型別。:hover 與 :focus-within 就能完成,不必動用狀態;狀態留給需要點擊、鍵盤操作或點擊外部關閉的情境。但這份範例想傳達的核心觀念依然適用:元件可組合、props 由外傳內、狀態由 setState 驅動重繪、生命週期函數負責不同階段的副作用。把這些想通,再用現代語法重寫一遍,你會發現整條學習路徑其實一以貫之。