事件處理
這些文檔很舊,不會更新。 前往 react.dev 獲取新的 React 文檔。
這些新的文件頁面教導 modern React 並包括即時範例:
使用 React element 處理事件跟使用 DOM element 處理事件是十分相似的。它們有一些語法上的差異:
- 事件的名稱在 React 中都是 camelCase,而在 HTML DOM 中則是小寫。
- 事件的值在 JSX 中是一個 function,而在 HTML DOM 中則是一個 string。
例如,在 HTML 中的語法:
<button onclick="activateLasers()">
Activate Lasers
</button>
和在 React 中的語法有些微的不同:
<button onClick={activateLasers}> Activate Lasers
</button>
另外一個差異是,在 React 中,你不能夠使用 return false
來避免瀏覽器預設行為。你必須明確地呼叫 preventDefault
。例如,在純 HTML 中,若要避免連結開啟新頁的預設功能,你可以這樣寫:
<form onsubmit="console.log('You clicked submit.'); return false">
<button type="submit">Submit</button>
</form>
在 React 中,你則可以這樣寫:
function Form() {
function handleSubmit(e) {
e.preventDefault(); console.log('You clicked submit.');
}
return (
<form onSubmit={handleSubmit}>
<button type="submit">Submit</button>
</form>
);
}
在這裡,e
是一個 synthetic 事件(synthetic event)。React 根據 W3C 規範來定義這些 synthetic 事件,React event 與 native event 工作的方式不盡然相同。若想了解更多這方面的資訊,請參考 SyntheticEvent
。
當使用 React 時,你不需要在建立一個 DOM element 後再使用 addEventListener
來加上 listener。你只需要在這個 element 剛開始被 render 時就提供一個 listener。
當你使用 ES6 class 來定義 Component 時,常見的慣例是把 event handler 當成那個 class 的方法。例如,這個 Toggle
Component 會 render 一個按鈕,讓使用者可以轉換 state 中的「開」與「關」:
class Toggle extends React.Component {
constructor(props) {
super(props);
this.state = {isToggleOn: true};
// 為了讓 `this` 能在 callback 中被使用,這裡的綁定是必要的: this.handleClick = this.handleClick.bind(this); }
handleClick() { this.setState(prevState => ({ isToggleOn: !prevState.isToggleOn })); }
render() {
return (
<button onClick={this.handleClick}> {this.state.isToggleOn ? 'ON' : 'OFF'}
</button>
);
}
}
請特別注意 this
在 JSX callback 中的意義。在 JavaScript 中,class 的方法在預設上是沒有被綁定(bound)的。如果你忘了綁定 this.handleClick
並把它傳遞給 onClick
的話,this
的值將會在該 function 被呼叫時變成 undefined
。
這並非是 React 才有的行為,而是 function 在 JavaScript 中的運作模式。總之,當你使用一個方法,卻沒有在後面加上 ()
之時(例如當你使用 onClick={this.handleClick}
時),你應該要綁定這個方法。
如果呼叫 bind
對你來說很麻煩的話,你可以用別的方式。你可以用 public class field 來正確的綁定 callback:
class LoggingButton extends React.Component {
// 這個語法確保 `this` 是在 handleClick 中被綁定。 handleClick = () => { console.log('this is:', this); }; render() {
return (
<button onClick={this.handleClick}>
Click me
</button>
);
}
}
這個語法在 Create React App 中是預設成可行的。
如果你並沒有使用 class field 的語法的話,你則可以在 callback 中使用 arrow function:
class LoggingButton extends React.Component {
handleClick() {
console.log('this is:', this);
}
render() {
// 這個語法確保 `this` 是在 handleClick 中被綁定: return ( <button onClick={() => this.handleClick()}> Click me
</button>
);
}
}
這個語法的問題是每一次 LoggingButton
render 的時候,就會建立一個不同的 callback。大多時候,這是無所謂的。然而,如果這個 callback 被當作一個 prop 傳給下層的 component 的話,其他的 component 也許會做些多餘的 re-render。原則上來說,我們建議在 constructor 內綁定,或使用 class field 語法,以避免這類的性能問題。
將參數傳給 Event Handler
在一個迴圈中,我們常常會需要傳遞一個額外的參數給 event handler。例如,如果 id
是每一行的 ID 的話,下面兩種語法都可行:
<button onClick={(e) => this.deleteRow(id, e)}>Delete Row</button>
<button onClick={this.deleteRow.bind(this, id)}>Delete Row</button>
以上這兩行程式是相同的。一個使用 arrow functions,另一個則使用了Function.prototype.bind
。
以這兩個例子來說,e
這個參數所代表的 React 事件將會被當作 ID 之後的第二個參數被傳遞下去。在使用 arrow function 時,我們必須明確地將它傳遞下去,但若使用 bind
語法,未來任何的參數都將會自動被傳遞下去。