React 模式（中文版）

摘要：渲染属性这里有个组件，使用了一个渲染回调函数。这个状态被提升到了容器中，通过添加回调函数，回调中可以更新本地状态。这个是正常的受控的输入不允许变更，这使得这个模式成为可能。

中文版：https://reactpatterns.cn/
原版：https://reactpatterns.com

函数组件 是最简单的一种声明可复用组件的方法

他们就是一些简单的函数。

function Greeting() {
  return 
Hi there!
;
}

从第一个形参中获取属性集 (props)

function Greeting(props) {
  return 
Hi {props.name}!
;
}

按自己的需要可以在函数组件中定义任意变量

最后一定要返回你的 React 组件。

function Greeting(props) {
  let style = {
    fontWeight: "bold",
    color: context.color
  };

  return 
Hi {props.name}!
;
}

使用 defaultProps 为任意必有属性设置默认值

function Greeting(props) {
  return 
Hi {props.name}!
;
}
Greeting.defaultProps = {
  name: "Guest"
};

解构赋值 是一种 JavaScript 特性。

出自 ES2015 版的 JavaScript 新规范。

所以看起来可能并不常见。

好比字面量赋值的反转形式。

let person = { name: "chantastic" };
let { name } = person;

同样适用于数组。

let things = ["one", "two"];
let [first, second] = things;

解构赋值被用在很多 函数组件 中。

下面声明的这些组件是相同的。

function Greeting(props) {
  return 
Hi {props.name}!
;
}

function Greeting({ name }) {
  return 
Hi {name}!
;
}

有一种语法可以在对象中收集剩余属性。

叫做 剩余参数，看起来就像这样。

function Greeting({ name, ...restProps }) {
  return 
Hi {name}!
;
}

那三个点 (...) 会把所有的剩余属性分配给 restProps 对象

然而，你能使用 restProps 做些什么呢？

继续往下看...

属性展开是 JSX 中的一个的特性。

它是一种语法，专门用来把对象上的属性转换成 JSX 中的属性

参考上面的 属性解构),
我们可以 扩散 restProps 对象的所有属性到 div 元素上

function Greeting({ name, ...restProps }) {
  return 
Hi {name}!
;
}

这让 Gretting 组件变得非常灵活。

我们可以通过传给 Gretting 组件 DOM 属性并确定这些属性一定会被传到 div 上

避免传递非 DOM 属性到组件上。
解构赋值是如此的受欢迎，是因为它可以分离 组件特定的属性 和 DOM/平台特定属性

function Greeting({ name, ...platformProps }) {
  return 
Hi {name}!
;
}

组件就是一种抽象。

好的抽象是可以扩展的。

比如说下面这个组件使用 class 属性来给按钮添加样式。

function MyButton(props) {
  return ;
}

一般情况下这样做就够了，除非我们需要扩展其它的样式类

Delete...

在这个例子中把 btn 替换成 delete-btn

JSX 中的属性展开) 对先后顺序是敏感的

扩散属性中的 className 会覆盖组件上的 className。

我们可以改变它两的顺序，但是目前来说 className 只有 btn。

function MyButton(props) {
  return ;
}

我们需要使用解构赋值来合并入参 props 中的 className 和基础的（组件中的） className。
可以通过把所有的值放在一个数组里面，然后使用一个空格连接它们。

function MyButton({ className, ...props }) {
  let classNames = ["btn", className].join(" ");

  return ;
}

为了保证 undefined 不被显示在 className 上，可以使用 默认值。

function MyButton({ className = "", ...props }) {
  let classNames = ["btn", className].join(" ");

  return ;
}

不可以在一个组件声明中使用 if/else 语句
You can"t use if/else statements inside a component declarations.
所以可以使用 条件（三元）运算符 和 短路计算。

{
  condition && Rendered when `truthy`;
}

{
  condition || Rendered when `falsy`;
}

{
  condition ? (
    Rendered when `truthy`
  ) : (
    Rendered when `falsy`
  );
}

很多类型都可以做为 React 的子元素。

多数情况下会是 数组 或者 字符串。

Hello World!

{["Hello ", World, "!"]}

将数组做为子元素是很常见的。

列表是如何在 React 中被绘制的。

我们使用 map() 方法创建一个新的 React 元素数组

  {["first", "second"].map(item => (
    
{item}
  ))}

这和使用字面量数组是一样的。

{[
first
, 
second
]}

这个模式可以联合解构、JSX 属性扩散以及其它组件一起使用，看起来简洁无比

  {arrayOfMessageObjects.map(({ id, ...message }) => (
    
  ))}

React 组件不支持函数类型的子元素。

然而 渲染属性 是一种可以创建组件并以函数作为子元素的模式。

这里有个组件，使用了一个渲染回调函数 children。

这样写并没有什么用，但是可以做为入门的简单例子。

const Width = ({ children }) => children(500);

组件把 children 做为函数调用，同时还可以传一些参数。上面这个 500 就是实参。

为了使用这个组件，我们可以在调用组件的时候传入一个子元素，这个子元素就是一个函数。

{width => 
window is {width}
}

我们可以得到下面的输出。

window is 500

有了这个组件，我们就可以用它来做渲染策略。

  {width => (width > 600 ? 
min-width requirement met!
 : null)}

如果有更复杂的条件判断，我们可以使用这个组件来封装另外一个新组件来利用原来的逻辑。

const MinWidth = ({ width: minWidth, children }) => (
  {width => (width > minWidth ? children : null)}
);

显然，一个静态的 Width 组件并没有什么用处，但是给它绑定一些浏览器事件就不一样了。下面有个实现的例子。

class WindowWidth extends React.Component {
  constructor() {
    super();
    this.state = { width: 0 };
  }

  componentDidMount() {
    this.setState(
      { width: window.innerWidth },
      window.addEventListener("resize", ({ target }) =>
        this.setState({ width: target.innerWidth })
      )
    );
  }

  render() {
    return this.props.children(this.state.width);
  }
}

许多开发人员都喜欢 高阶组件 来实现这种功能。但这只是个人喜好问题。

你可能会创建一个组件，这个组件会使用 context 并且渲染它的子元素。

class SomeContextProvider extends React.Component {
  getChildContext() {
    return { some: "context" };
  }

  render() {
    // 如果能直接返回 `children` 就完美了
  }
}

你将面临一个选择。把 children 包在一个 div 中并返回，或者直接返回 children。第一种情况需要要你添加额外的标记（这可能会影响到你的样式）。第二种将产生一个没什么用处的错误。

// option 1: extra div
return 
{children}
;

// option 2: unhelpful errors
return children;

最好把 children 做为一种不透明的数据类型对待。React 提供了 React.Children 方法来处理 children。

return React.Children.only(this.props.children);

(我并不确定这个名字的准确叫法 译：代理、中介、装饰?)

按钮在 web 应用中随处可见。并且所有的按钮都需要一个 type="button" 的属性。

重复的写这些属性很容易出错。我们可以写一个高层组件来代理 props 到底层组件。

const Button = props =>
  

我们可以使用 Button 组件代替 button 元素，并确保 type 属性始终是 button。

// 

Send Money
// Send Money

这也是一种 代理组件，用来处理样式。

假如我们有一个按钮，它使用了「primary」做为样式类。

我们使用一些单一功能组件来生成上面的结构。

import classnames from "classnames";

const PrimaryBtn = props => ;

const Btn = ({ className, primary, ...props }) => (
  
);

可以可视化的展示成下面的样子。

PrimaryBtn()
  ↳ Btn({primary: true})
    ↳ Button({className: "btn btn-primary"}, type: "button"})
      ↳ ""

使用这些组件，下面的这几种方式会得到一致的结果。

这对于样式维护来说是非常好的。它将样式的所有关注点分离到单个组件上。

当我们在写事件处理函数的时候，通常会使用 handle{事件名字} 的命名方式。

handleClick(e) { /* do something */ }

当需要添加很多事件处理函数的时候，这些函数名字会显得很重复。这些函数的名字并没有什么价值，因为它们只代理了一些动作或者函数。

handleClick() { require("./actions/doStuff")(/* action stuff */) }
handleMouseEnter() { this.setState({ hovered: true }) }
handleMouseLeave() { this.setState({ hovered: false }) }

可以考虑写一个事件处理函数来根据不同的 event.type 来组织事件。

handleEvent({type}) {
  switch(type) {
    case "click":
      return require("./actions/doStuff")(/* action dates */)
    case "mouseenter":
      return this.setState({ hovered: true })
    case "mouseleave":
      return this.setState({ hovered: false })
    default:
      return console.warn(`No case for event type "${type}"`)
  }
}

另外，对于简单的组件，你可以在组件中使用箭头函数直接调用导入的动作或者函数

 someImportedAction({ action: "DO_STUFF" })}

在遇到性能问题之前，不要担心性能优化。真的不要

布局组件表现为一些静态 DOM 元素的形式。它们一般并不需要经常更新。

就像下面的这个组件一样，两边各自渲染了一个 children。

}
  rightSide={}
/>

我们可以优化这个组件。

HorizontalSplit 组件是两个子组件的父元素，我们可以告诉组件永远都不要更新

class HorizontalSplit extends React.Component {
  shouldComponentUpdate() {
    return false;
  }

  render() {
    
      
{this.props.leftSide}
      
{this.props.rightSide}
    
  }
}

「容器用来获取数据然后渲染到子组件上，仅仅如此。」—Jason Bonta

这有一个 CommentList 组件。

const CommentList = ({ comments }) => (
  

    {comments.map(comment => (
      

        {comment.body}-{comment.author}
      
    ))}
  
);

我们可以创建一个新组件来负责获取数据渲染到上面的 CommentList 函数组件中。

class CommentListContainer extends React.Component {
  constructor() {
    super()
    this.state = { comments: [] }
  }

  componentDidMount() {
    $.ajax({
      url: "/my-comments.json",
      dataType: "json",
      success: comments =>
        this.setState({comments: comments});
    })
  }

  render() {
    return 
  }
}

对于不同的应用上下文，我们可以写不同的容器组件。

高阶函数 是至少满足下列一个条件的函数：

接受一个或多个函数作为输入

输出一个函数

所以高阶组件又是什么呢？

如果你已经用过 容器组件, 这仅仅是一些泛化的组件, 包裹在一个函数中。

让我们以 Greeting 组件开始

const Greeting = ({ name }) => {
  if (!name) {
    return 
连接中...
;
  }

  return 
Hi {name}!
;
};

如果 props.name 存在，组件会渲染这个值。否则将展示「连接中...」。现在来添加点高阶的感觉

const Connect = ComposedComponent =>
  class extends React.Component {
    constructor() {
      super();
      this.state = { name: "" };
    }

    componentDidMount() {
      // this would fetch or connect to a store
      this.setState({ name: "Michael" });
    }

    render() {
      return ;
    }
  };

这是一个返回了入参为组件的普通函数

接着，我们需要把 Greeting 包裹到 Connect 中

const ConnectedMyComponent = Connect(Greeting);

这是一个强大的模式，它可以用来获取数据和给定数据到任意 函数组件 中。

函数组件 没有状态 (就像名字暗示的一样)。

事件是状态的变化。

它们的数据需要传递给状态化的父 容器组件

这就是所谓的「状态提升」。

它是通过将回调从容器组件传递给子组件来完成的

class NameContainer extends React.Component {
  render() {
    return  alert(newName)} />;
  }
}

const Name = ({ onChange }) => (
   onChange(e.target.value)} />
);

Name 组件从 NameContainer 组件中接收 onChange 回调，并在 input 值变化的时候调用。

上面的 alert 调用只是一个简单的演示，但它并没有改变状态

让我们来改变 NameContainer 组件的内部状态。

class NameContainer extends React.Component {
  constructor() {
    super();
    this.state = { name: "" };
  }

  render() {
    return  this.setState({ name: newName })} />;
  }
}

这个状态 被提升 到了容器中，通过添加回调函数，回调中可以更新本地状态。这就设置了一个很清晰边界，并且使功能组件的可重用性最大化。

这个模式并不限于函数组件。因为函数组件没有生命周期事件，你也可以在类组件中使用这种模式。

受控输入 是一种与状态提升同时使用时很重要的模式

(最好是在一个状态化的组件上处理事件对象)

讨论受控输入的抽象并不容易。让我们以一个不受控的（通常）输入开始。

当你在浏览器中调整此输入时，你会看到你的更改。 这个是正常的

受控的输入不允许 DOM 变更，这使得这个模式成为可能。通过在组件范围中设置值而不是直接在 DOM 范围中修改

显示静态的输入框值对于用户来说并没有什么用处。所以，我们从状态中传递一个值到 input 上。

class ControlledNameInput extends React.Component {
  constructor() {
    super();
    this.state = { name: "" };
  }

  render() {
    return ;
  }
}

然后当你改变组件的状态的时候 input 的值就自动改变了。

return (
   this.setState({ name: e.target.value })}
  />
);

这是一个受控的输入框。它只会在我们的组件状态发生变化的时候更新 DOM。这在创建一致 UI 界面的时候非常有用。

如果你使用 函数组件 做为表单元素，那就得阅读 状态提升 一节，把状态转移到上层的组件树上。