React Props Children 传值

背景是在使用 umijs 框架时，它提供一个根节点 layout。我想在根节点传值到 Route 组件中却不得其法，后来查阅 issues 得到解答。

props.children 属性

在 React 中 props.children 是一个特殊的存在，它表示该组件的所有节点。组件中 props.children 的值存在三种可能性：

• 如果当前组件没有子节点，值类型为 undefined
• 如果当前组件只有一个子节点，值类型为 object
• 如果当前组件有多个子节点，值类型为 array

在 umijs 中，layout 根节点也是通过 props.children 来引用 Route 页面组件，所以在给 Route 传值时遇到了盲点。

props.children 传值

在一般的 React 组件中，可以很方便的通过 props 传值，但是在 props.children 中如何实现传值呢，也就是怎么样在父组件中对不确定的子组件进行 props 传递呢？

React 提供一个工具方法 React.Children 来处理 props.children。它提供一些有用的方法来处理 props.children：

• React.Children.map：用来遍历子节点，而不用担心 props.children 的数据类型是 undefined 还是 object。
• React.Children.forEach：同 React.Children.map，用来遍历子节点，但不返回对象。
• React.Children.count：返回 children 当中的组件总数，和传递给 map 或者 forEach 的回调函数的调用次数一致。
• React.Children.only：返回 children 中仅有的子级，否则抛出异常。

同时 React 提供 React.cloneElement 方法用来克隆并返回一个新的 ReactElement（内部子元素也会跟着克隆），新返回的元素会保留有旧元素的 props、ref、key，也会集成新的 props。

我们将上面两者配合就能实现 props.children 传值：

const App = props => {
  const childrenWithProps = React.Children.map(props.children, child => {
    return React.cloneElement(child, { test: 'test' })
  })
  return <>{childrenWithProps}</>
}

多层传值

在 umijs 中，Layout 与 Route 组件之间隔了两层，所以在 Layout 里传值的话需要 clone 两级，因为第一级是 Switch，然后才是 Route。

React.Children.map(children, child => {
  return React.cloneElement(
    child,
    null,
    React.Children.map(child.props.children, child => {
      return React.cloneElement(child, { test: 'test' })
    })
  )
})

参考文章：
support pass props from layouts to child routes