本文透過實例給大家分享了編寫React元件專案實踐的整個過程,對此有興趣的朋友可以參考下。
當我剛開始寫React的時候,我看過很多寫元件的方法。一百篇教程就有一百種寫法。雖然React本身已經成熟了,但是如何使用它似乎還沒有一個「正確」的方法。所以我(作者)把我們團隊這些年來總結的使用React的經驗總結在這裡。希望這篇文字對你有用,不管你是初學者還是老手。
我們使用ES6、ES7語法如果你不是很清楚展示元件和容器元件的區別,建議您從閱讀這篇文章開始如果您有任何的建議、疑問都清在評論裡留言基於類別的元件
現在開發React元件一般都用的是基於類別的元件。下面我們就來一行一樣的寫我們的元件:
import React, { Component } from 'react'; import { observer } from 'mobx-react'; import ExpandableForm from './ExpandableForm'; import './styles/ProfileContainer.css';
我很喜歡css in javascript。但是,這個寫樣式的方法還是太新了。所以我們在每個元件裡引入css檔。而且本地引入的import和全域的import會用一個空白行來分割。
初始化State
import React, { Component } from 'react' import { observer } from 'mobx-react' import ExpandableForm from './ExpandableForm' import './styles/ProfileContainer.css' export default class ProfileContainer extends Component { state = { expanded: false }
您可以使用了舊方法在constructor
裡初始化state
。更多相關可以看這裡。但是我們選擇更清晰的方法。
同時,我們確保在類別前面加上了export default
。 (譯者註:雖然這個在使用了redux的時候不一定對)。
propTypes and defaultProps
import React, { Component } from 'react' import { observer } from 'mobx-react' import { string, object } from 'prop-types' import ExpandableForm from './ExpandableForm' import './styles/ProfileContainer.css' export default class ProfileContainer extends Component { state = { expanded: false } static propTypes = { model: object.isRequired, title: string } static defaultProps = { model: { id: 0 }, title: 'Your Name' } // ... }
propTypes
和defaultProps
是靜態屬性。盡可能在元件類別的的前面定義,讓其他的開發人員讀程式碼的時候可以立刻注意到。他們可以起到文檔的作用。
如果你使用了React 15.3.0或更高的版本,那麼需要另外引入prop-types
包,而不是使用React.PropTypes
。更多內容移步這裡。
你所有的元件都應該有prop types。
import React, { Component } from 'react' import { observer } from 'mobx-react' import { string, object } from 'prop-types' import ExpandableForm from './ExpandableForm' import './styles/ProfileContainer.css' export default class ProfileContainer extends Component { state = { expanded: false } static propTypes = { model: object.isRequired, title: string } static defaultProps = { model: { id: 0 }, title: 'Your Name' } handleSubmit = (e) => { e.preventDefault() this.props.model.save() } handleNameChange = (e) => { this.props.model.changeName(e.target.value) } handleExpand = (e) => { e.preventDefault() this.setState({ expanded: !this.state.expanded }) } // ... }
在類別元件裡,當你把方法傳遞給子元件的時候,需要確保他們被呼叫的時候使用的是正確的this。一般都會在傳給子元件的時候這麼做:this.handleSubmit.bind(this)
。
使用ES6的箭頭法就簡單多了。它會自動維護正確的上下文(this
)。
給setState傳入一個方法
在上面的範例裡面有這麼一行:
this.setState({ expanded: !this.state.expanded });
setState
其實是異步的! React為了提高效能,會把多次呼叫的setState
放在一起呼叫。所以,呼叫了setState
之後state不一定會立刻就改變。
所以,呼叫setState
的時候,你不能依賴目前的state值。因為i根本不知道它是值會是神馬。
解決方法:給setState
傳入一個方法,把呼叫前的state值當作參數傳入這個方法。看看範例:
this.setState(prevState => ({ expanded: !prevState.expanded }))
感謝Austin Wood的幫助。
拆解元件
import React, { Component } from 'react' import { observer } from 'mobx-react' import { string, object } from 'prop-types' import ExpandableForm from './ExpandableForm' import './styles/ProfileContainer.css' export default class ProfileContainer extends Component { state = { expanded: false } static propTypes = { model: object.isRequired, title: string } static defaultProps = { model: { id: 0 }, title: 'Your Name' } handleSubmit = (e) => { e.preventDefault() this.props.model.save() } handleNameChange = (e) => { this.props.model.changeName(e.target.value) } handleExpand = (e) => { e.preventDefault() this.setState(prevState => ({ expanded: !prevState.expanded })) } render() { const { model, title } = this.props return () } }
{title}
有多行的props
的,每一個prop都應該單獨佔據一行。就如上例一樣。要達到這個目標最好的方法是使用一套工具:Prettier
。
裝飾者(Decorator)
@observer export default class ProfileContainer extends Component {
如果你了解某些函式庫,例如mobx,你就可以用上例的方式來修飾類別組件。裝飾器就是把類別組件當作一個參數傳入了一個方法。
裝飾器可以編寫更靈活、更有可讀性的元件。如果你不想用裝飾器,你可以這樣:
class ProfileContainer extends Component { // Component code } export default observer(ProfileContainer)
閉包
盡量避免在子元件中傳入閉包,如:
<input type="text" value={model.name} // onChange={(e) => { model.name = e.target.value }} // ^ Not this. Use the below: onChange={this.handleChange} placeholder="Your Name"/>
注意:如果input
是一個React元件的話,這樣自動觸發它的重繪,不管其他的props是否發生了改變。
一致性檢定是React最消耗資源的部分。不要把額外的工作加到這裡。處理上例中的問題最好的方法是傳入一個類別方法,這樣還會更易讀,也更容易除錯。如:
import React, { Component } from 'react' import { observer } from 'mobx-react' import { string, object } from 'prop-types' // Separate local imports from dependencies import ExpandableForm from './ExpandableForm' import './styles/ProfileContainer.css' // Use decorators if needed @observer export default class ProfileContainer extends Component { state = { expanded: false } // Initialize state here (ES7) or in a constructor method (ES6) // Declare propTypes as static properties as early as possible static propTypes = { model: object.isRequired, title: string } // Default props below propTypes static defaultProps = { model: { id: 0 }, title: 'Your Name' } // Use fat arrow functions for methods to preserve context (this will thus be the component instance) handleSubmit = (e) => { e.preventDefault() this.props.model.save() } handleNameChange = (e) => { this.props.model.name = e.target.value } handleExpand = (e) => { e.preventDefault() this.setState(prevState => ({ expanded: !prevState.expanded })) } render() { // Destructure props for readability const { model, title } = this.props return (// Newline props if there are more than two ) } }
{title}
{ model.name = e.target.value }} // Avoid creating new closures in the render method- use methods like below onChange={this.handleNameChange} placeholder="Your Name"/>
方法元件
這類元件沒有state沒有props,也沒有方法。它們是純組件,包含了最少的引起變化的內容。經常使用它們。
propTypes
import React from 'react' import { observer } from 'mobx-react' import { func, bool } from 'prop-types' import './styles/Form.css' ExpandableForm.propTypes = { onSubmit: func.isRequired, expanded: bool } // Component declaration
我們在元件的宣告之前就定義了propTypes
。
分解Props和defaultProps
import React from 'react' import { observer } from 'mobx-react' import { func, bool } from 'prop-types' import './styles/Form.css' ExpandableForm.propTypes = { onSubmit: func.isRequired, expanded: bool, onExpand: func.isRequired } function ExpandableForm(props) { const formStyle = props.expanded ? {height: 'auto'} : {height: 0} return ( <form style={formStyle} onSubmit={props.onSubmit}> {props.children} <button onClick={props.onExpand}>Expand</button> </form> ) }
我們的元件是一個方法。它的參數就是props
。我們可以這樣擴充這個元件:
import React from 'react' import { observer } from 'mobx-react' import { func, bool } from 'prop-types' import './styles/Form.css' ExpandableForm.propTypes = { onSubmit: func.isRequired, expanded: bool, onExpand: func.isRequired } function ExpandableForm({ onExpand, expanded = false, children, onSubmit }) { const formStyle = expanded ? {height: 'auto'} : {height: 0} return ( <form style={formStyle} onSubmit={onSubmit}> {children} <button onClick={onExpand}>Expand</button> </form> ) }
現在我們也可以使用預設參數來扮演預設props的角色,這樣有很好的可讀性。如果expanded
沒有定義,那麼我們就把它設定為false
。
但是,盡量避免使用如下的例子:
const ExpandableForm = ({ onExpand, expanded, children }) => {
看起來很現代,但是這個方法是未命名的。
如果你的Babel配置正确,未命名的方法并不会是什么大问题。但是,如果Babel有问题的话,那么这个组件里的任何错误都显示为发生在 <>里的,这调试起来就非常麻烦了。
匿名方法也会引起Jest其他的问题。由于会引起各种难以理解的问题,而且也没有什么实际的好处。我们推荐使用function
,少使用const
。
装饰方法组件
由于方法组件没法使用装饰器,只能把它作为参数传入别的方法里。
import React from 'react' import { observer } from 'mobx-react' import { func, bool } from 'prop-types' import './styles/Form.css' ExpandableForm.propTypes = { onSubmit: func.isRequired, expanded: bool, onExpand: func.isRequired } function ExpandableForm({ onExpand, expanded = false, children, onSubmit }) { const formStyle = expanded ? {height: 'auto'} : {height: 0} return ( <form style={formStyle} onSubmit={onSubmit}> {children} <button onClick={onExpand}>Expand</button> </form> ) } export default observer(ExpandableForm)
只能这样处理:export default observer(ExpandableForm)
。
这就是组件的全部代码:
import React from 'react' import { observer } from 'mobx-react' import { func, bool } from 'prop-types' // Separate local imports from dependencies import './styles/Form.css' // Declare propTypes here, before the component (taking advantage of JS function hoisting) // You want these to be as visible as possible ExpandableForm.propTypes = { onSubmit: func.isRequired, expanded: bool, onExpand: func.isRequired } // Destructure props like so, and use default arguments as a way of setting defaultProps function ExpandableForm({ onExpand, expanded = false, children, onSubmit }) { const formStyle = expanded ? { height: 'auto' } : { height: 0 } return ( <form style={formStyle} onSubmit={onSubmit}> {children} <button onClick={onExpand}>Expand</button> </form> ) } // Wrap the component instead of decorating it export default observer(ExpandableForm)
条件判断
某些情况下,你会做很多的条件判断:
<p id="lb-footer"> {props.downloadMode && currentImage && !currentImage.video && currentImage.blogText ? !currentImage.submitted && !currentImage.posted ? <p>Please contact us for content usage</p> : currentImage && currentImage.selected ? <button onClick={props.onSelectImage} className="btn btn-selected">Deselect</button> : currentImage && currentImage.submitted ? <button className="btn btn-submitted" disabled>Submitted</button> : currentImage && currentImage.posted ? <button className="btn btn-posted" disabled>Posted</button> : <button onClick={props.onSelectImage} className="btn btn-unselected">Select post</button> } </p>
这么多层的条件判断可不是什么好现象。
有第三方库JSX-Control Statements可以解决这个问题。但是与其增加一个依赖,还不如这样来解决:
<p id="lb-footer"> { (() => { if(downloadMode && !videoSrc) { if(isApproved && isPosted) { return <p>Right click image and select "Save Image As.." to download</p> } else { return <p>Please contact us for content usage</p> } } // ... })() } </p>
使用大括号包起来的IIFE,然后把你的if
表达式都放进去。返回你要返回的组件。
上面是我整理给大家的,希望今后会对大家有帮助。
相关文章:
vue.js element-ui tree树形控件改iview的方法
以上是React元件專案(詳細教學)的詳細內容。更多資訊請關注PHP中文網其他相關文章!