编写React组件的最佳实践
|
此文翻译自这里。 当我刚开始写React的时候，我看过很多写组件的方法。一百篇教程就有一百种写法。虽然React本身已经成熟了，但是如何使用它似乎还没有一个“正确”的方法。所以我（作者）把我们团队这些年来总结的使用React的经验总结在这里。希望这篇文字对你有用，不管你是初学者还是老手。 开始前：
基于类的组件现在开发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会用一个空行来分割。 初始化Stateimport 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 }
您可以使用了老方法在 propTypes and defaultPropsimport 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'
}
// ...
}
如果你使用了React 15.3.0或者更高的版本，那么需要另外引入 你所有的组件都应该有prop types。 方法import React,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。一般都会在传给子组件的时候这么做： 使用ES6的箭头方法就简单多了。它会自动维护正确的上下文（ 给setState传入一个方法在上面的例子里有这么一行： this.setState({ expanded: !this.state.expanded });
所以，调用 解决方法：给 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: '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>
)
}
}
有多行的 装饰器（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"/>
注意：如果 一致性检验是React最消耗资源的部分。不要把额外的工作加到这里。处理上例中的问题最好的方法是传入一个类方法，这样还会更加易读，更容易调试。如： import React,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，也没有方法。它们是纯组件，包含了最少的引起变化的内容。经常使用它们。 propTypesimport 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
我们在组件的声明之前就定义了 分解Props和defaultPropsimport 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>
)
}
我们的组件是一个方法。它的参数就是 import React from 'react'
import { observer } from 'mobx-react'
import { func,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的角色，这样有很好的可读性。如果 但是，尽量避免使用如下的例子： const ExpandableForm = ({ onExpand,expanded,children }) => {
看起来很现代，但是这个方法是未命名的。 如果你的Babel配置正确，未命名的方法并不会是什么大问题。但是，如果Babel有问题的话，那么这个组件里的任何错误都显示为发生在 <<anonymous>>里的，这调试起来就非常麻烦了。 匿名方法也会引起Jest其他的问题。由于会引起各种难以理解的问题，而且也没有什么实际的好处。我们推荐使用 装饰方法组件由于方法组件没法使用装饰器，只能把它作为参数传入别的方法里。 import React from 'react'
import { observer } from 'mobx-react'
import { func,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)
只能这样处理： 这就是组件的全部代码： 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,onExpand: func.isRequired
}
// Destructure props like so,and use default arguments as a way of setting defaultProps
function ExpandableForm({ onExpand,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，然后把你的 最后再次，希望本文对你有用。如果你有什么好的意见或者建议的话请写在下面的评论里。谢谢！ （编辑：李大同） 【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容! |