掌握这个有用的模式,停止在 React Components 中重复逻辑! 😎

原文:React Higher Order Components in 3 minutes 作者:Jhey Tompkins 译者:博轩

PS:今天是母亲节,先祝所有母亲大人们节日快乐啦 👏👏👏

什么是高阶组件?

高阶组件(HOC)是 React 中用于复用组件逻辑的一种高级技巧。HOC 自身不是 React API 的一部分,它是一种基于 React 的组合特性而形成的设计模式。

译注:对,我又一次借鉴了官网 😂

它做了什么?

他们接收一个组件并返回一个新的组件!

什么时候去使用?

当你的组件之间出现重复的模式 / 逻辑的时候。

栗子:

  • 挂载,订阅数据
  • UI 增加交互(也可以使用容器组件,或者 Render Props
  • 排序,过滤输入的数据

译注:第三个说法,我个人可能更加倾向于在传入组件之前做处理,而不是使用高阶组件

一个愚蠢的例子

我们有一个 Mouse 组件。

  1. const Mouse = () => (
  2. <span className="mouse" role="img">🐭</span>
  3. )

接下来,让我们使用 GreenSock’s Draggable 模块,来让组件变的可以拖拽。

  1. class Mouse extends Component {
  2. componentDidMount = () => new Draggable(this.ELEMENT)
  3. render = () => (
  4. <span className="mouse" ref={e => (this.ELEMENT = e)} role="img">🐭</span>
  5. )
  6. }

1_BsU7epyRljwuwMpbibf9aQ.gif

我们加一只 🐱

  1. const Cat = () => (
  2. <span className="cat" role="img">🐱</span>
  3. )

这个组件同样需要变得可拖拽✋,接下来,让我们使用高阶组件(HOC)来试一下:

  1. const withDrag = Wrapped => {
  2. class WithDrag extends Component {
  3. componentDidMount = () => new Draggable(this.ELEMENT)
  4. render = () => {
  5. return (
  6. <span className="draggable_wrapper" ref={e => (this.ELEMENT = e)}>
  7. <Wrapped {...this.props} />
  8. </span>
  9. )
  10. }
  11. }
  12. WithDrag.displayName = `WithDrag(${Wrapped.displayName || Wrapped.name})`
  13. return WithDrag;
  14. }

我们的高阶组件(HOC)可以通过 props 接受一组件,并返回一个新的组件。

许多高阶组件会在传递组件的过程中,注入新的 props 。这通常是决定我们是否应该使用高阶组件的因素之一。如果,我们不注入 props ,我们可以使用一个容器组件,或者 Render Props

对于我们的高阶组件(HOC),我们也可以使用 Render Props 来达到相同的效果。你可能会觉得使用 HOC 来实现并不合适。但是,这个 “愚蠢的例子” 会让你更加熟悉 HOC 。 这比注入数据的示例更加有趣!😉

让我们将这个 HOC 应用到 CatMouse 组件上吧 👍

  1. const Mouse = () => (
  2. <span className="mouse" role="img">🐭</span>
  3. )
  4. const Cat = () => (
  5. <span className="cat" role="img">🐱</span>
  6. )
  7. const DraggableMouse = withDrag(Mouse)
  8. const DraggableCat = withDrag(Cat)
  9. class App extends Component {
  10. render = () => (
  11. <Fragment>
  12. <DraggableMouse />
  13. <DraggableCat />
  14. </Fragment>
  15. )
  16. }

1_tqnzqosc1Ikv_-HlwnNEVA.gif

接下来,让我们在高阶组件中增加 onDrag 回调函数,并在 props 中注入 xy 的位置属性。

  1. const withDrag = Wrapped => {
  2. class WithDrag extends Component {
  3. state = {
  4. x: undefined,
  5. y: undefined,
  6. }
  7. componentDidMount = () => new Draggable(this.ELEMENT, { onDrag: this.onDrag })
  8. onDrag = e => {
  9. const { x, y } = e.target.getBoundingClientRect();
  10. this.setState({ x: Math.floor(x), y: Math.floor(y) })
  11. }
  12. render = () => (
  13. <span className="draggable_wrapper" ref={e => (this.ELEMENT = e)}>
  14. <Wrapped {...this.props} x={this.state.x} y={this.state.y} />
  15. </span>
  16. )
  17. }
  18. WithDrag.displayName = `WithDrag(${Wrapped.displayName || Wrapped.name})`
  19. return WithDrag;
  20. }
  1. const Mouse = () => (
  2. <span className="mouse" role="img">
  3. 🐭
  4. {x !== undefined &&
  5. y !== undefined && (
  6. <span className="mouse__position"> {`(${x}, ${y})`} </span>
  7. )}
  8. </span>
  9. )

现在 Mouse 组件会向用户展示他的 XY 位置属性 🤓

1_7Cw2Ce7zsg_-CJU-m6EYng.gif

我们也可以给 HOC 传递 props。然后在传递的过程中过滤掉这些无用的属性。举个例子,传递一个 onDrag 回调函数。

  1. const withDrag = Wrapped => {
  2. class WithDrag extends Component {
  3. componentDidMount = () => new Draggable(this.ELEMENT, { onDrag: this.props.onDrag })
  4. render = () => {
  5. const { onDrag, ...passed } = this.props;
  6. return (
  7. <span className="draggable__wrapper" ref={e => (this.ELEMENT = e)}>
  8. <Wrapped {...passed} />
  9. </span>
  10. )
  11. }
  12. }
  13. WithDrag.displayName = `WithDrag(${Wrapped.displayName || Wrapped.name})`
  14. return WithDrag;
  15. }
  16. class App extends Component {
  17. render = () => (
  18. <Fragment>
  19. <DraggableMouse
  20. onDrag={e => console.info(e.target.getBoundingClientRect())}
  21. />
  22. </Fragment>
  23. )
  24. }

通过使用 HOC ,我们的组件仍然很简单,复杂的逻辑都交给 HOC 来处理了。 我们的组件只关心传递给他们的内容。 我们可以在其他地方重复使用它们而且不会有可以被拖拽的属性。这使得我们的应用更容易维护。

优秀的实践 👍

  • 当出现重复的模式的时候,使用它们
  • 为了方便调试,需要更新处理之后组件的 displayName
  • 传递与当前 HOC 无关的所有 props

糟糕的实践 👎

  • 过度使用,其他模式可能会更加适合
  • 改变原始组件
  • render 方法中使用高阶组件

译注:永远不要在 React render() 方法中定义 React 组件(甚至是无状态组件)。React 在每次更新状态的时候,都会废弃旧的 html DOM 元素并将其替换为全新的元素。比如在 render() 函数中定义一个输入组件,元素被替换之后就会失去焦点,每次只能输入一个字符。

注意 🙏

  • Refs 不会被传递
  • 务必复制静态方法
  • 大部分 HOC 都可以和 render props 相互替换使用

这就是一篇关于高阶组件的简短介绍 ~

官方文档:高阶组件

本文已经联系原文作者,并授权翻译,转载请保留原文链接