編寫React組件項目實踐分析

2024-05-06 16:42:49

字體：大中小

來源：轉載

供稿：網友

當我剛開始寫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 (
   <ExpandableForm
    onSubmit={this.handleSubmit}
    expanded={this.state.expanded}
    onExpand={this.handleExpand}>
    <div>
     <h1>{title}</h1>
     <input
      type="text"
      value={model.name}
      onChange={this.handleNameChange}
      placeholder="Your Name"/>
    </div>
   </ExpandableForm>
)
}
}
有多行的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 (
   <ExpandableForm
    onSubmit={this.handleSubmit}
    expanded={this.state.expanded}
    onExpand={this.handleExpand}>
    // Newline props if there are more than two
    <div>
     <h1>{title}</h1>
     <input
      type="text"
      value={model.name}
      // onChange={(e) => { model.name = e.target.value }}
      // Avoid creating new closures in the render method- use methods like below
      onChange={this.handleNameChange}
      placeholder="Your Name"/>
    </div>
   </ExpandableForm>
)
}
}
方法組件

這類組件沒有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)
條件判斷

某些情況下，你會做很多的條件判斷：

<div 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>
}
</div>
這么多層的條件判斷可不是什么好現象。

有第三方庫JSX-Control Statements可以解決這個問題。但是與其增加一個依賴，還不如這樣來解決：

<div 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>
    }
   }

   // ...
})()
}
</div>
使用大括號包起來的IIFE，然后把你的if表達式都放進去。返回你要返回的組件。

最后

再次，希望本文對你有用。如果你有什么好的意見或者建議的話請寫在下面的評論里。謝謝！