编写React组件项目实践分析

2023-09-15 20:42:06 55

当我刚开始写React的时候，我看过很多写组件的方法。一百篇教程就有一百种写法。虽然React本身已经成熟了，但是如何使用它似乎还没有一个“正确”的方法。所以我（作者）把我们团队这些年来总结的使用React的经验总结在这里。希望这篇文字对你有用，不管你是初学者还是老手。

开始前：

我们使用ES6、ES7语法如果你不是很清楚展示组件和容器组件的区别，建议您从阅读这篇文章开始如果您有任何的建议、疑问都清在评论里留言基于类的组件

现在开发React组件一般都用的是基于类的组件。下面我们就来一行一样的编写我们的组件：

importReact,{Component}from'react';
import{observer}from'mobx-react';

importExpandableFormfrom'./ExpandableForm';
import'./styles/ProfileContainer.css';

我很喜欢cssinjavascript。但是，这个写样式的方法还是太新了。所以我们在每个组件里引入css文件。而且本地引入的import和全局的import会用一个空行来分割。

初始化State

importReact,{Component}from'react'
import{observer}from'mobx-react'

importExpandableFormfrom'./ExpandableForm'
import'./styles/ProfileContainer.css'

exportdefaultclassProfileContainerextendsComponent{
state={expanded:false}

您可以使用了老方法在constructor里初始化state。更多相关可以看这里。但是我们选择更加清晰的方法。
同时，我们确保在类前面加上了exportdefault。（译者注：虽然这个在使用了redux的时候不一定对）。

propTypesanddefaultProps

importReact,{Component}from'react'
import{observer}from'mobx-react'
import{string,object}from'prop-types'

importExpandableFormfrom'./ExpandableForm'
import'./styles/ProfileContainer.css'

exportdefaultclassProfileContainerextendsComponent{
state={expanded:false}

staticpropTypes={
model:object.isRequired,
title:string
}

staticdefaultProps={
model:{
id:0
},
title:'YourName'
}

//...
}

propTypes和defaultProps是静态属性。尽可能在组件类的的前面定义，让其他的开发人员读代码的时候可以立刻注意到。他们可以起到文档的作用。

如果你使用了React15.3.0或者更高的版本，那么需要另外引入prop-types包，而不是使用React.PropTypes。更多内容移步这里。

你所有的组件都应该有proptypes。

方法

importReact,{Component}from'react'
import{observer}from'mobx-react'
import{string,object}from'prop-types'

importExpandableFormfrom'./ExpandableForm'
import'./styles/ProfileContainer.css'

exportdefaultclassProfileContainerextendsComponent{
state={expanded:false}

staticpropTypes={
model:object.isRequired,
title:string
}

staticdefaultProps={
model:{
id:0
},
title:'YourName'
}
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}))

感谢AustinWood的帮助。

拆解组件

importReact,{Component}from'react'
import{observer}from'mobx-react'

import{string,object}from'prop-types'
importExpandableFormfrom'./ExpandableForm'
import'./styles/ProfileContainer.css'

exportdefaultclassProfileContainerextendsComponent{
state={expanded:false}

staticpropTypes={
model:object.isRequired,
title:string
}

staticdefaultProps={
model:{
id:0
},
title:'YourName'
}

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
exportdefaultclassProfileContainerextendsComponent{

如果你了解某些库，比如mobx，你就可以使用上例的方式来修饰类组件。装饰器就是把类组件作为一个参数传入了一个方法。

装饰器可以编写更灵活、更有可读性的组件。如果你不想用装饰器，你可以这样：

classProfileContainerextendsComponent{
//Componentcode
}
exportdefaultobserver(ProfileContainer)

闭包

尽量避免在子组件中传入闭包，如：

{model.name=e.target.value}}
//^Notthis.Usethebelow:
onChange={this.handleChange}
placeholder="YourName"/>

注意：如果input是一个React组件的话，这样自动触发它的重绘，不管其他的props是否发生了改变。

一致性检验是React最消耗资源的部分。不要把额外的工作加到这里。处理上例中的问题最好的方法是传入一个类方法，这样还会更加易读，更容易调试。如：

importReact,{Component}from'react'
import{observer}from'mobx-react'
import{string,object}from'prop-types'
//Separatelocalimportsfromdependencies
importExpandableFormfrom'./ExpandableForm'
import'./styles/ProfileContainer.css'

//Usedecoratorsifneeded
@observer
exportdefaultclassProfileContainerextendsComponent{
state={expanded:false}
//Initializestatehere(ES7)orinaconstructormethod(ES6)

//DeclarepropTypesasstaticpropertiesasearlyaspossible
staticpropTypes={
model:object.isRequired,
title:string
}

//DefaultpropsbelowpropTypes
staticdefaultProps={
model:{
id:0
},
title:'YourName'
}

//Usefatarrowfunctionsformethodstopreservecontext(thiswillthusbethecomponentinstance)
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(){
//Destructurepropsforreadability
const{
model,
title
}=this.props
return(

//Newlinepropsiftherearemorethantwo

{title}
{model.name=e.target.value}}
//Avoidcreatingnewclosuresintherendermethod-usemethodslikebelow
onChange={this.handleNameChange}
placeholder="YourName"/>


)
}
}

方法组件

这类组件没有state没有props，也没有方法。它们是纯组件，包含了最少的引起变化的内容。经常使用它们。

propTypes

importReactfrom'react'
import{observer}from'mobx-react'
import{func,bool}from'prop-types'
import'./styles/Form.css'
ExpandableForm.propTypes={
onSubmit:func.isRequired,
expanded:bool
}
//Componentdeclaration

我们在组件的声明之前就定义了propTypes。

分解Props和defaultProps

importReactfrom'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
}

functionExpandableForm(props){
constformStyle=props.expanded?{height:'auto'}:{height:0}
return(

{props.children}
Expand

)
}

我们的组件是一个方法。它的参数就是props。我们可以这样扩展这个组件：

importReactfrom'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
}

functionExpandableForm({onExpand,expanded=false,children,onSubmit}){
constformStyle=expanded?{height:'auto'}:{height:0}
return(

{children}
Expand

)
}

现在我们也可以使用默认参数来扮演默认props的角色，这样有很好的可读性。如果expanded没有定义，那么我们就把它设置为false。

但是，尽量避免使用如下的例子：

constExpandableForm=({onExpand,expanded,children})=>{

看起来很现代，但是这个方法是未命名的。

如果你的Babel配置正确，未命名的方法并不会是什么大问题。但是，如果Babel有问题的话，那么这个组件里的任何错误都显示为发生在<>里的，这调试起来就非常麻烦了。

匿名方法也会引起Jest其他的问题。由于会引起各种难以理解的问题，而且也没有什么实际的好处。我们推荐使用function，少使用const。

装饰方法组件

由于方法组件没法使用装饰器，只能把它作为参数传入别的方法里。

importReactfrom'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
}

functionExpandableForm({onExpand,expanded=false,children,onSubmit}){
constformStyle=expanded?{height:'auto'}:{height:0}
return(

{children}
Expand

)
}
exportdefaultobserver(ExpandableForm)

只能这样处理：exportdefaultobserver(ExpandableForm)。

这就是组件的全部代码：

importReactfrom'react'
import{observer}from'mobx-react'
import{func,bool}from'prop-types'
//Separatelocalimportsfromdependencies
import'./styles/Form.css'

//DeclarepropTypeshere,beforethecomponent(takingadvantageofJSfunctionhoisting)
//Youwantthesetobeasvisibleaspossible
ExpandableForm.propTypes={
onSubmit:func.isRequired,
expanded:bool,
onExpand:func.isRequired
}

//Destructurepropslikeso,andusedefaultargumentsasawayofsettingdefaultProps
functionExpandableForm({onExpand,expanded=false,children,onSubmit}){
constformStyle=expanded?{height:'auto'}:{height:0}
return(

{children}
Expand

)
}

//Wrapthecomponentinsteadofdecoratingit
exportdefaultobserver(ExpandableForm)

条件判断

某些情况下，你会做很多的条件判断：


{props.downloadMode&¤tImage&&!currentImage.video&¤tImage.blogText
?!currentImage.submitted&&!currentImage.posted
?Pleasecontactusforcontentusage
:currentImage&¤tImage.selected
?Deselect
:currentImage&¤tImage.submitted
?Submitted
:currentImage&¤tImage.posted
?Posted
:Selectpost
}

这么多层的条件判断可不是什么好现象。

有第三方库JSX-ControlStatements可以解决这个问题。但是与其增加一个依赖，还不如这样来解决：


{
(()=>{
if(downloadMode&&!videoSrc){
if(isApproved&&isPosted){
returnRightclickimageandselect"SaveImageAs.."todownload
}else{
returnPleasecontactusforcontentusage
}
}

//...
})()
}

使用大括号包起来的IIFE，然后把你的if表达式都放进去。返回你要返回的组件。

最后

再次，希望本文对你有用。如果你有什么好的意见或者建议的话请写在下面的评论里。谢谢！

编写React组件项目实践分析

开始前：

方法

{title}

{title}

最后

热门推荐

随机推荐