编写React组件项目实践分析

作者: a333661d6d6e | 来源:发表于2018-12-20 19:50 被阅读7次

通过实例给大家分享了编写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'
 //欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860
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'
 }
 // ...
}//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860

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 })
 } 
 // ... 
}//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860

在类组件里,当你把方法传递给子组件的时候,需要确保他们被调用的时候使用的是正确的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 }))

拆解组件

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 }
  //欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860
 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 }))
 }
  //欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860
 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
}//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860
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'
//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860 
// 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'
 }
 //欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860
 // 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>//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860
   </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
}//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860
// 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
}
//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860 
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'
 //欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860
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 (//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860
  <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'
 //欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860
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>//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860
 )
}
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'
 //欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860
// 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>
 }//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860
</div>

这么多层的条件判断可不是什么好现象。
有第三方库JSX-Control Statements可以解决这个问题。但是与其增加一个依赖,还不如这样来解决:

<div id="lb-footer">
 {//欢迎加入前端全栈开发交流圈一起吹水聊天学习交流:864305860
  (() => {
   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表达式都放进去。返回你要返回的组件。

结语

感谢您的观看,如有不足之处,欢迎批评指正。

本次给大家推荐一个免费的学习群,里面概括移动应用网站开发,css,html,webpack,vue node angular以及面试资源等。
对web开发技术感兴趣的同学,欢迎加入Q群:864305860,不管你是小白还是大牛我都欢迎,还有大牛整理的一套高效率学习路线和教程与您免费分享,同时每天更新视频资料。
最后,祝大家早日学有所成,拿到满意offer,快速升职加薪,走上人生巅峰。

相关文章

  • 编写React组件项目实践分析

    通过实例给大家分享了编写React组件项目实践的全过程,写的十分的全面细致,具有一定的参考价值,对此有需要的朋友可...

  • [FE] 使用 vite 构建 react lib

    背景 最近使用 vite 创建了 React + TypeScript 项目,其中编写了一些 React 组件。就...

  • react学习文档

    通过实例,学习编写 React 组件的“最佳实践”https://zhuanlan.zhihu.com/p/278...

  • React学习(5)-React中组件的数据-props

    前言 开发一个React应用,更多的是在编写组件,而React组件最小的单位就是React元素,编写组件的最大的好...

  • 面试题

    React组件的渲染流程是什么? 使用 React.createElement或 JSX编写 React组件,实际...

  • 编写React组件的最佳实践

    此文翻译自这里。 当我刚开始写React的时候,我看过很多写组件的方法。一百篇教程就有一百种写法。虽然React本...

  • 如何创建React组件并发布到npm?

    实现步骤: 创建React组件项目; 创建测试项目并引用组件; 发布React组件到npm上; 一、创建React...

  • React: 编写弹性组件

    原文:编写弹性组件 编写弹性组件 当人们开始学习React时,他们经常会想要一份风格指南。虽然在项目中应用一些一致...

  • react组件-编写组件

    组件声明 新建组件的命首页字母要为大写,否者在引用的时候会报错,react核心会认为是一个HTML标签,并无法解析...

  • react组件开发规范

    这是通过修改项目运行在Google上时的警告,总结的的部分react组件开发规范: (1)编写组件时,一定要写Pr...

网友评论

    本文标题:编写React组件项目实践分析

    本文链接:https://www.haomeiwen.com/subject/gfsskqtx.html