React元件專案（詳細教學）

本文透過實例給大家分享了編寫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有问题的话，那么这个组件里的任何错误都显示为发生在 a8093152e673feb7aba1828c43532094里的，这调试起来就非常麻烦了。

匿名方法也会引起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 父组件调用子组件方法及事件

vue.js element-ui tree树形控件改iview的方法

javascript实现文件拖拽事件

以上是React元件專案（詳細教學）的詳細內容。更多資訊請關注PHP中文網其他相關文章！