我们编写 React 组件的最佳实践
|
刚接触 在过去的一年里，我们在不断的完善我们的做法，直到满意为止。 本文会列出我们自己在使用的最佳实践，不管你是刚入门的新手还是很有经验的开发者，我们都希望本文对你有所帮助。 开始之前，先列几条：
基于 Class 的组件基于 Class 的组件是有状态的，不管它包不包含函数，我们都会尽量少用。但是它也有它的用处。 现在来一行一行的编写我们的组件： 导入 CSSimport React,{ Component } from 'react'
import { observer } from 'mobx-react'
import ExpandableForm from './ExpandableForm'
import './styles/ProfileContainer.css'
我喜欢 初始化 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 }
当然你也可以选择在构造函数里面去初始化，但是我们觉得这种方式更加清晰。 当然也会保证 Class 是默认导出的。 propTypes 和 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'
}
propTypes 和 defaultProps 是静态属性，尽可能的把它们写在组件的最上方，以便其他开发者阅读。 如果使用 所有的组件都必须声明 propTypes 函数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 })
}
使用基于 Class 的组件时，当你传递函数给子组件的时候，要确保他们有正确的 但是如果你使用箭头函数，就不需要 为 setState 传递函数上面的例子中我们是这么做的： this.setState({ expanded: !this.state.expanded })
这里有个 setState 的小知识 —— 它是异步的，为了保证性能， 这意味着你不能依赖当前的状态，因为你不知道当前的状态是什么状态 这里有个解决方案 —— 传递函数给 setState， this.setState(prevState => ({ expanded: !prevState.expanded }))
解构 Propsimport 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(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>
)
}
}
像上面的例子一样，每个 prop 都独占一行 装饰器(Decorators)@observer
export default class ProfileContainer extends Component {
如果你使用了类似 mobx 的库，你可以这样去装饰你的 Class 组件 修改函数式组件使用 decorators 很灵活并且可读 如果你不想使用装饰器，可以这么做： 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"/>
这种方式的好处是每次render，不会重新创建一个函数，没有额外的性能损失。 这里是完整的组件： 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>
)
}
}
函数式组件这些组件没有状态和函数，他们很纯，非常容易阅读，尽量多的使用他们。 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
这里我们把 propTypes 写在最前面，他会被组件立即可见，这要归功于JavaScript的 解构 Props 和 defaultPropsimport React from 'react'
import { observer } from 'mobx-react'
import { func,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,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>
)
}
我们也可以使用默认参数值去设置 避免使用下面的 ES6 语法： const ExpandableForm = ({ onExpand,expanded,children }) => {
看起来很先（逼）进（格），但这个函数是匿名的。 如果你的Babel设置正确，这个匿名函数不会成为一个问题 —— 但是如果不是的话，任何错误都会显示在 Wrapping函数式组件中不能使用 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)
JSX 中的条件判断你可能会有很复杂的条件判断语句，但是你要避免下面的写法：
嵌套的三元表达式不是一个好的方法，太难阅读了 有一些库可以解决这个问题(jsx-control-statements)，但是我们没有引入其他的库，我们是这么解决的：
我们使用了 立即执行函数 把条件语句写在里面，虽然这样可能会导致性能下降，但是在大多数情况下，它带来的负面影响还是小于糟糕的可读性。 当然如果组件分的足够细，你可能不会用到这么复杂的条件判断。 此外，如果你只在一个表达式里面去渲染组件，避免这么做： {
isTrue
? <p>True!</p>
: <none/>
}
你可以使用短路语法： {
isTrue &&
<p>True!</p>
}
总结这篇文章对你有帮助吗？请在评论区给出你的意见和建议，感谢阅读！ 本文首发于我的 个人博客，另外推荐一个我前阵子写的一个脚手架 parcel-typescript-react-boilerplate，请给出意见和建议，相互学习。无耻的求个星，谢谢~~！ （编辑：李大同） 【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容! |