DevNotes - React 代码共享最佳实践方式 - 《react》

Mixin
- 在 React 中使用 Mixin
高阶组件
- 使用 HOC 的约定
- HOC 的优缺点
Render Props
Hook
- Hook 优缺点
总结

React
任何一个项目发展到一定复杂性的时候，必然会面临逻辑复用的问题。在React中实现逻辑复用通常有以下几种方式：Mixin、高阶组件(HOC)、修饰器(decorator)、Render Props、Hook。这里主要就以上几种方式的优缺点作分析，帮助开发者针对业务场景作出更适合的方式。

Mixin

这或许是刚从Vue转向React的开发者第一个能够想到的方法。Mixin一直被广泛用于各种面向对象的语言中，其作用是为单继承语言创造一种类似多重继承的效果。虽然现在React已将其放弃中，但Mixin的确曾是React实现代码共享的一种设计模式。
广义的 mixin 方法，就是用赋值的方式将 mixin 对象中的方法都挂载到原对象上，来实现对象的混入，类似 ES6 中的 Object.assign()的作用。原理如下：

const mixin = function (obj, mixins) {
  const newObj = obj
  newObj.prototype = Object.create(obj.prototype)
  for (let prop in mixins) {
    // 遍历mixins的属性
    if (mixins.hasOwnPrototype(prop)) {
      // 判断是否为mixin的自身属性
      newObj.prototype[prop] = mixins[prop]; // 赋值
    }
  }
  return newObj
};

在 React 中使用 Mixin

假设在项目中，多个组件都需要设置默认的name属性，使用mixin可以不必在不同的组件里写多个同样的getDefaultProps方法，可以定义一个mixin：

const DefaultNameMixin = {
  getDefaultProps: function () {
    return {
      name: "Joy"
    }
  }
}

为了使用mixin，需要在组件中加入mixins属性，然后把写好的mixin包裹成一个数组，将它作为mixins的属性值：

const ComponentOne = React.createClass({
  mixins: [DefaultNameMixin]
  render: function () {
    return <h2>Hello {this.props.name}</h2>
  }
})

写好的mixin可以在其他组件里重复使用。
由于mixins属性值是一个数组，意味着可以同一个组件里调用多个mixin。在上述例子中稍作更改得到：

const DefaultFriendMixin = {
  getDefaultProps: function () {
    return {
      friend: "Yummy"
    }
  }
}
const ComponentOne = React.createClass({
  mixins: [DefaultNameMixin, DefaultFriendMixin]
  render: function () {
    return (
      <div>
        <h2>Hello {this.props.name}</h2>
        <h2>This is my friend {this.props.friend}</h2>
      </div>
    )
  }
})

甚至可以在一个mixin里包含其他的mixin。
比如写一个新的mixin DefaultProps包含以上的DefaultNameMixin和DefaultFriendMixin：

const DefaultPropsMixin = {
  mixins: [DefaultNameMixin, DefaultFriendMixin]
}
const ComponentOne = React.createClass({
  mixins: [DefaultPropsMixin]
  render: function () {
    return (
      <div>
        <h2>Hello {this.props.name}</h2>
        <h2>This is my friend {this.props.friend}</h2>
      </div>
    )
  }
})

至此，可以总结出mixin至少拥有以下优势:

可以在多个组件里使用相同的mixin；
可以在同一个组件里使用多个mixin；
可以在同一个mixin里嵌套多个mixin；

但是在不同场景下，优势也可能变成劣势：

破坏原有组件的封装，可能需要去维护新的state和props等状态；
不同mixin里的命名不可知，非常容易发生冲突；
可能产生递归调用问题，增加了项目复杂性和维护难度；

除此之外，mixin在状态冲突、方法冲突、多个生命周期方法的调用顺序等问题拥有自己的处理逻辑。

高阶组件

由于mixin存在上述缺陷，故React剥离了mixin，改用高阶组件来取代它。
高阶组件本质上是一个函数，它接受一个组件作为参数，返回一个新的组件。
React官方在实现一些公共组件时，也用到了高阶组件，比如react-router中的withRouter，以及Redux中的connect。在这以withRouter为例。
默认情况下，必须是经过Route路由匹配渲染的组件才存在this.props、才拥有路由参数、才能使用函数式导航的写法执行this.props.history.push('/next')跳转到对应路由的页面。高阶组件中的withRouter作用是将一个没有被Route路由包裹的组件，包裹到Route里面，从而将react-router的三个对象history、location、match放入到该组件的props属性里，因此能实现函数式导航跳转。
withRouter的实现原理：

const withRouter = (Component) => {
  const displayName = `withRouter(${Component.displayName || Component.name})`
  const C = props => {
    const { wrappedComponentRef, ...remainingProps } = props
    return (
      <RouterContext.Consumer>
        {context => {
          invariant(
            context,
            `You should not use <${displayName} /> outside a <Router>`
          );
          return (
            <Component
              {...remainingProps}
              {...context}
              ref={wrappedComponentRef}
            />
          )
        }}
      </RouterContext.Consumer>
    )
}

使用代码：

import React, { Component } from "react"
import { withRouter } from "react-router"
class TopHeader extends Component {
  render() {
    return (
      <div>
        导航栏
        {/* 点击跳转login */}
        <button onClick={this.exit}>退出</button>
      </div>
    )
  }
  exit = () => {
    // 经过withRouter高阶函数包裹，就可以使用this.props进行跳转操作
    this.props.history.push("/login")
  }
}
// 使用withRouter包裹组件，返回history,location等
export default withRouter(TopHeader)

由于高阶组件的本质是获取组件并且返回新组件的方法，所以理论上它也可以像mixin一样实现多重嵌套。
例如：
写一个赋能唱歌的高阶函数

import React, { Component } from 'react'
const widthSinging = WrappedComponent => {
  return class HOC extends Component {
    constructor () {
      super(...arguments)
      this.singing = this.singing.bind(this)
    }
    singing = () => {
      console.log('i am singing!')
    }
    render() {
      return <WrappedComponent />
    }
    }
}

写一个赋能跳舞的高阶函数

import React, { Component } from 'react'
const widthDancing = WrappedComponent => {
  return class HOC extends Component {
    constructor () {
      super(...arguments)
      this.dancing = this.dancing.bind(this)
    }
    dancing = () => {
      console.log('i am dancing!')
    }
    render() {
      return <WrappedComponent />
    }
    }
}

使用以上高阶组件

import React, { Component } from "react"
import { widthSing, widthDancing } from "hocs"
class Joy extends Component {
  render() {
    return <div>Joy</div>
  }
}
// 给Joy赋能唱歌和跳舞的特长
export default widthSinging(withDancing(Joy))

由上可见，只需使用高阶函数进行简单的包裹，就可以把原本单纯的 Joy 变成一个既能唱歌又能跳舞的夜店小王子了！

使用 HOC 的约定

在使用HOC的时候，有一些墨守成规的约定：

将不相关的 Props 传递给包装组件（传递与其具体内容无关的 props）；
分步组合（避免不同形式的 HOC 串联调用）；
包含显示的 displayName 方便调试（每个 HOC 都应该符合规则的显示名称）；
不要在render函数中使用高阶组件（每次 render，高阶都返回新组件，影响 diff 性能）；
静态方法必须被拷贝（经过高阶返回的新组件，并不会包含原始组件的静态方法）；
避免使用 ref（ref 不会被传递）;

HOC 的优缺点
至此可以总结一下高阶组件(HOC)的优点：
HOC是一个纯函数，便于使用和维护；
同样由于HOC是一个纯函数，支持传入多个参数，增强其适用范围；
HOC返回的是一个组件，可组合嵌套，灵活性强；

当然HOC也会存在一些问题：

当多个HOC嵌套使用时，无法直接判断子组件的props是从哪个HOC负责传递的；
当父子组件有同名props，会导致父组件覆盖子组件同名props的问题，且react不会报错，开发者感知性低；
每一个HOC都返回一个新组件，从而产生了很多无用组件，同时加深了组件层级，不便于排查问题；

修饰器和高阶组件属于同一模式，在此不展开讨论。

Render Props

Render Props是一种非常灵活复用性非常高的模式，它可以把特定行为或功能封装成一个组件，提供给其他组件使用让其他组件拥有这样的能力。

The term “render prop” refers to a technique for sharing code between React components using a prop whose value is a function.

这是React官方对于Render Props的定义，翻译成大白话即：“Render Props是实现React Components之间代码共享的一种技术，组件的props里边包含有一个function类型的属性，组件可以调用该props属性来实现组件内部渲染逻辑”。
官方示例：

<DataProvider render={(data) => <h1>Hello {data.target}</h1>} />

如上，DataProvider组件拥有一个叫做render（也可以叫做其他名字）的props属性，该属性是一个函数，并且这个函数返回了一个React Element，在组件内部通过调用该函数来完成渲染，那么这个组件就用到了render props技术。
读者或许会疑惑，“我们为什么需要调用props属性来实现组件内部渲染，而不直接在组件内完成渲染”？借用React官方的答复，render props并非每个React开发者需要去掌握的技能，甚至永远都不会用到这个方法，但它的存在的确为开发者在思考组件代码共享的问题时，提供了多一种选择。

Render Props使用场景

在项目开发中可能需要频繁的用到弹窗，弹窗 UI 可以千变万化，但是功能却是类似的，即打开和关闭。以antd为例：

import { Modal, Button } from "antd"
class App extends React.Component {
  state = { visible: false }
  // 控制弹窗显示隐藏
  toggleModal = (visible) => {
    this.setState({ visible })
  };
  handleOk = (e) => {
    // 做点什么
    this.setState({ visible: false })
  }
  render() {
    const { visible } = this.state
    return (
      <div>
        <Button onClick={this.toggleModal.bind(this, true)}>Open</Button>
        <Modal
          title="Basic Modal"
          visible={visible}
          onOk={this.handleOk}
          onCancel={this.toggleModal.bind(this, false)}
        >
          <p>Some contents...</p>
        </Modal>
      </div>
    )
  }
}

以上是最简单的Model使用实例，即便是简单的使用，仍需要关注它的显示状态，实现它的切换方法。但是开发者其实只想关注与业务逻辑相关的onOk，理想的使用方式应该是这样的：

<MyModal>
  <Button>Open</Button>
  <Modal title="Basic Modal" onOk={this.handleOk}>
    <p>Some contents...</p>
  </Modal>
</MyModal>

可以通过render props实现以上使用方式：

import { Modal, Button } from "antd"
class MyModal extends React.Component {
  state = { on: false }

  toggle = () => {
    this.setState({
      on: !this.state.on
    })
  }

  renderButton = (props) => <Button {...props} onClick={this.toggle} />

  renderModal = ({ onOK, ...rest }) => (
    <Modal
      {...rest}
      visible={this.state.on}
      onOk={() => {
        onOK && onOK()
        this.toggle()
      }}
      onCancel={this.toggle}
    />
  )

  render() {
    return this.props.children({
      Button: this.renderButton,
      Modal: this.renderModal
    })
  }
}

这样就完成了一个具备状态和基础功能的Modal，在其他页面使用该Modal时，只需要关注特定的业务逻辑即可。
以上可以看出，render props是一个真正的React组件，而不是像HOC一样只是一个可以返回组件的函数，这也意味着使用render props不会像HOC一样产生组件层级嵌套的问题，也不用担心props命名冲突产生的覆盖问题。

render props使用限制

在render props中应该避免使用箭头函数，因为这会造成性能影响。
比如：

// 不好的示例
class MouseTracker extends React.Component {
  render() {
    return (
      <Mouse render={mouse => (
        <Cat mouse={mouse} />
      )}/>
    )
  }
}

这样写是不好的，因为render方法是有可能多次渲染的，使用箭头函数，会导致每次渲染的时候，传入render的值都会不一样，而实际上并没有差别，这样会导致性能问题。
所以更好的写法应该是将传入render里的函数定义为实例方法，这样即便多次渲染，但是绑定的始终是同一个函数。

// 好的示例
class MouseTracker extends React.Component {
  renderCat(mouse) {
   return <Cat mouse={mouse} />
  }

  render() {
    return (
    <Mouse render={this.renderTheCat} />
    )
  }
}

render props的优缺点

优点
- props 命名可修改，不存在相互覆盖；
- 清楚 props 来源；
- 不会出现组件多层嵌套；
缺点
- 写法繁琐；
- 无法在return语句外访问数据；
- 容易产生函数回调嵌套；如下代码：
```
const MyComponent = () => {
return (
<Mouse>
 {({ x, y }) => (
   <Page>
     {({ x: pageX, y: pageY }) => (
       <Connection>
         {({ api }) => {
           // yikes
         }}
       </Connection>
     )}
   </Page>
 )}
</Mouse>
)
}
```
  Hook
  React的核心是组件，因此，React一直致力于优化和完善声明组件的方式。从最早的类组件，再到函数组件，各有优缺点。类组件可以提供一个完整的生命周期和状态（state）,但是在写法上却十分笨重，而函数组件虽然写法非常简洁轻便，但其限制是必须是纯函数，不能包含状态，也不支持生命周期，因此类组件并不能取代函数组件。
  而React团队觉得组件的最佳写法应该是函数，而不是类，由此产生了React Hooks。
  React Hooks 的设计目的，就是加强版函数组件，完全不使用”类”，就能写出一个全功能的组件。
  为什么说类组件“笨重”，借用React官方的例子说明： ```jsx import React, { Component } from “react”

export default class Button extends Component { constructor() { super() this.state = { buttonText: “Click me, please” } this.handleClick = this.handleClick.bind(this) } handleClick() { this.setState(() => { return { buttonText: “Thanks, been clicked!” } }) } render() { const { buttonText } = this.state return } }

以上是一个简单的按钮组件，包含最基础的状态和点击方法，点击按钮后状态发生改变。<br />本是很简单的功能组件，但是却需要大量的代码去实现。由于函数组件不包含状态，所以并不能用函数组件来声明一个具备如上功能的组件。但是可以用Hook来实现：
```jsx
import React, { useState } from "react"

export default function Button() {
  const [buttonText, setButtonText] = useState("Click me,   please")

  function handleClick() {
    return setButtonText("Thanks, been clicked!")
  }

  return <button onClick={handleClick}>{buttonText}</button>
}

相较而言，Hook显得更轻量，在贴近函数组件的同时，保留了自己的状态。
在上述例子中引入了第一个钩子useState()，除此之外，React官方还提供了useEffect()、useContext()、useReducer()等钩子。具体钩子及其用法详情请见官方。
Hook的灵活之处还在于，除了官方提供的基础钩子之外，还可以利用这些基础钩子来封装和自定义钩子，从而实现更容易的代码复用。

Hook 优缺点

优点
- 更容易复用代码；
- 清爽的代码风格；
- 代码量更少；
缺点
- 状态不同步（函数独立运行，每个函数都有一份独立的作用域）
- 需要更合理的使用useEffect
- 颗粒度小，对于复杂逻辑需要抽象出很多hook
  总结
  除了Mixin因为自身的明显缺陷而稍显落后之外，对于高阶组件、render props、react hook而言，并没有哪种方式可称为最佳方案，它们都是优势与劣势并存的。哪怕是最为最热门的react hook，虽然每一个hook看起来都是那么的简短和清爽，但是在实际业务中，通常都是一个业务功能对应多个hook，这就意味着当业务改变时，需要去维护多个hook的变更，相对于维护一个class而言，心智负担或许要增加许多。只有切合自身业务的方式，才是最佳方案。

React 代码共享最佳实践方式