中文版：https://reactpatterns.cn/ 原版：https://reactpatterns.com
函数组件 (Function component)
函数组件 是最简单的一种声明可复用组件的方法
他们就是一些简单的函数。
function Greeting() {
return <div>Hi there!</div>;
}
从第一个形参中获取属性集 (props)
function Greeting(props) {
return <div>Hi {props.name}!</div>;
}
按自己的需要可以在函数组件中定义任意变量
最后一定要返回你的 React 组件。
function Greeting(props) {
let style = {
fontWeight: “bold”,
color: context.color
};
return <div style={style}>Hi {props.name}!</div>;
}
使用 defaultProps 为任意必有属性设置默认值
function Greeting(props) {
return <div>Hi {props.name}!</div>;
}
Greeting.defaultProps = {
name: “Guest”
};
属性解构 (Destructuring props)
解构赋值 是一种 JavaScript 特性。
出自 ES2015 版的 JavaScript 新规范。
所以看起来可能并不常见。
好比字面量赋值的反转形式。
let person = {name: “chantastic”};
let {name} = person;
同样适用于数组。
let things = [“one”, “two”];
let [first, second] = things;
解构赋值被用在很多 函数组件 中。
下面声明的这些组件是相同的。
function Greeting(props) {
return <div>Hi {props.name}!</div>;
}
function Greeting({name}) {
return <div>Hi {name}!</div>;
}
有一种语法可以在对象中收集剩余属性。
叫做 剩余参数，看起来就像这样。
function Greeting({name, …restProps}) {
return <div>Hi {name}!</div>;
}
那三个点 (…) 会把所有的剩余属性分配给 restProps 对象
然而，你能使用 restProps 做些什么呢？
继续往下看 …
JSX 中的属性展开 (JSX spread attributes)
属性展开是 JSX 中的一个的特性。
它是一种语法，专门用来把对象上的属性转换成 JSX 中的属性
参考上面的 属性解构 ), 我们可以 扩散 restProps 对象的所有属性到 div 元素上
function Greeting({name, …restProps}) {
return <div {…restProps}>Hi {name}!</div>;
}
这让 Gretting 组件变得非常灵活。
我们可以通过传给 Gretting 组件 DOM 属性并确定这些属性一定会被传到 div 上
<Greeting name=”Fancy pants” className=”fancy-greeting” id=”user-greeting” />
避免传递非 DOM 属性到组件上。解构赋值是如此的受欢迎，是因为它可以分离 组件特定的属性 和 DOM/ 平台特定属性
function Greeting({name, …platformProps}) {
return <div {…platformProps}>Hi {name}!</div>;
}
合并解构属性和其它值 (Merge destructured props with other values)
组件就是一种抽象。
好的抽象是可以扩展的。
比如说下面这个组件使用 class 属性来给按钮添加样式。
function MyButton(props) {
return <button className=”btn” {…props} />;
}
一般情况下这样做就够了，除非我们需要扩展其它的样式类
<MyButton className=”delete-btn”>Delete…</MyButton>
在这个例子中把 btn 替换成 delete-btn
JSX 中的属性展开 ) 对先后顺序是敏感的
扩散属性中的 className 会覆盖组件上的 className。
我们可以改变它两的顺序，但是目前来说 className 只有 btn。
function MyButton(props) {
return <button {…props} className=”btn” />;
}
我们需要使用解构赋值来合并入参 props 中的 className 和基础的（组件中的）className。可以通过把所有的值放在一个数组里面，然后使用一个空格连接它们。
function MyButton({className, …props}) {
let classNames = [“btn”, className].join(” “);
return <button className={classNames} {…props} />;
}
为了保证 undefined 不被显示在 className 上，可以使用 默认值。
function MyButton({className = “”, …props}) {
let classNames = [“btn”, className].join(” “);
return <button className={classNames} {…props} />;
}
条件渲染 (Conditional rendering)
不可以在一个组件声明中使用 if/else 语句 You can’t use if/else statements inside a component declarations. 所以可以使用 条件（三元）运算符 和 短路计算。
如果
{
condition && <span>Rendered when `truthy`</span>;
}
除非
{
condition || <span>Rendered when `falsy`</span>;
}
如果 - 否则
{
condition ? (
<span>Rendered when `truthy`</span>
) : (
<span>Rendered when `falsy`</span>
);
}
子元素类型 (Children types)
很多类型都可以做为 React 的子元素。
多数情况下会是 数组 或者 字符串。
字符串 String
<div>Hello World!</div>
数组 Array
<div>{[“Hello “, <span>World</span>, “!”]}</div>
数组做为子元素 (Array as children)
将数组做为子元素是很常见的。
列表是如何在 React 中被绘制的。
我们使用 map() 方法创建一个新的 React 元素数组
<ul>
{[“first”, “second”].map(item => (
<li>{item}</li>
))}
</ul>
这和使用字面量数组是一样的。
<ul>{[<li>first</li>, <li>second</li>]}</ul>
这个模式可以联合解构、JSX 属性扩散以及其它组件一起使用，看起来简洁无比
<ul>
{arrayOfMessageObjects.map(({ id, …message}) => (
<Message key={id} {…message} />
))}
</ul>
函数做为子元素 (Function as children)
React 组件不支持函数类型的子元素。
然而 渲染属性 是一种可以创建组件并以函数作为子元素的模式。
渲染属性 (Render prop)
这里有个组件，使用了一个渲染回调函数 children。
这样写并没有什么用，但是可以做为入门的简单例子。
const Width = ({children}) => children(500);
组件把 children 做为函数调用，同时还可以传一些参数。上面这个 500 就是实参。
为了使用这个组件，我们可以在调用组件的时候传入一个子元素，这个子元素就是一个函数。
<Width>{width => <div>window is {width}</div>}</Width>
我们可以得到下面的输出。
<div>window is 500</div>
有了这个组件，我们就可以用它来做渲染策略。
<Width>
{width => (width > 600 ? <div>min-width requirement met!</div> : null)}
</Width>
如果有更复杂的条件判断，我们可以使用这个组件来封装另外一个新组件来利用原来的逻辑。
const MinWidth = ({width: minWidth, children}) => (
<Width>{width => (width > minWidth ? children : null)}</Width>
);
显然，一个静态的 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);
}
}
许多开发人员都喜欢 高阶组件 来实现这种功能。但这只是个人喜好问题。
子组件的传递 (Children pass-through)
你可能会创建一个组件，这个组件会使用 context 并且渲染它的子元素。
class SomeContextProvider extends React.Component {
getChildContext() {
return {some: “context”};
}
render() {
// 如果能直接返回 `children` 就完美了
}
}
你将面临一个选择。把 children 包在一个 div 中并返回，或者直接返回 children。第一种情况需要要你添加额外的标记（这可能会影响到你的样式）。第二种将产生一个没什么用处的错误。
// option 1: extra div
return <div>{children}</div>;
// option 2: unhelpful errors
return children;
最好把 children 做为一种不透明的数据类型对待。React 提供了 React.Children 方法来处理 children。
return React.Children.only(this.props.children);
代理组件 (Proxy component)
(我并不确定这个名字的准确叫法 译：代理、中介、装饰?)
按钮在 web 应用中随处可见。并且所有的按钮都需要一个 type=”button” 的属性。
<button type=”button”>
重复的写这些属性很容易出错。我们可以写一个高层组件来代理 props 到底层组件。
const Button = props =>
<button type=”button” {…props}>
我们可以使用 Button 组件代替 button 元素，并确保 type 属性始终是 button。
<Button />
// <button type=”button”><button>
<Button className=”CTA”>Send Money</Button>
// <button type=”button” class=”CTA”>Send Money</button>
样式组件 (Style component)
这也是一种 代理组件，用来处理样式。
假如我们有一个按钮，它使用了「primary」做为样式类。
<button type=”button” className=”btn btn-primary”>
我们使用一些单一功能组件来生成上面的结构。
import classnames from “classnames”;
const PrimaryBtn = props => <Btn {…props} primary />;
const Btn = ({className, primary, …props}) => (
<button
type=”button”
className={classnames(“btn”, primary && “btn-primary”, className)}
{…props}
/>
);
可以可视化的展示成下面的样子。
PrimaryBtn()
↳ Btn({primary: true})
↳ Button({className: “btn btn-primary”}, type: “button”})
↳ ‘<button type=”button” class=”btn btn-primary”></button>’
使用这些组件，下面的这几种方式会得到一致的结果。
<PrimaryBtn />
<Btn primary />
<button type=”button” className=”btn btn-primary” />
这对于样式维护来说是非常好的。它将样式的所有关注点分离到单个组件上。
组织事件 (Event switch)
当我们在写事件处理函数的时候，通常会使用 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}”`)
}
}
另外，对于简单的组件，你可以在组件中使用箭头函数直接调用导入的动作或者函数
<div onClick={() => someImportedAction({ action: “DO_STUFF”})}
在遇到性能问题之前，不要担心性能优化。真的不要
布局组件 (Layout component)
布局组件表现为一些静态 DOM 元素的形式。它们一般并不需要经常更新。
就像下面的这个组件一样，两边各自渲染了一个 children。
<HorizontalSplit
leftSide={<SomeSmartComponent />}
rightSide={<AnotherSmartComponent />}
/>
我们可以优化这个组件。
HorizontalSplit 组件是两个子组件的父元素，我们可以告诉组件永远都不要更新
class HorizontalSplit extends React.Component {
shouldComponentUpdate() {
return false;
}
render() {
<FlexContainer>
<div>{this.props.leftSide}</div>
<div>{this.props.rightSide}</div>
</FlexContainer>
}
}
容器组件 (Container component)
「容器用来获取数据然后渲染到子组件上，仅仅如此。」—Jason Bonta
这有一个 CommentList 组件。
const CommentList = ({comments}) => (
<ul>
{comments.map(comment => (
<li>
{comment.body}-{comment.author}
</li>
))}
</ul>
);
我们可以创建一个新组件来负责获取数据渲染到上面的 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 <CommentList comments={this.state.comments} />
}
}
对于不同的应用上下文，我们可以写不同的容器组件。
高阶组件 (Higher-order component)
高阶函数 是至少满足下列一个条件的函数：
接受一个或多个函数作为输入
输出一个函数
所以高阶组件又是什么呢？
如果你已经用过 容器组件, 这仅仅是一些泛化的组件, 包裹在一个函数中。
让我们以 Greeting 组件开始
const Greeting = ({name}) => {
if (!name) {
return <div> 连接中 …</div>;
}
return <div>Hi {name}!</div>;
};
如果 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 <ComposedComponent {…this.props} name={this.state.name} />;
}
};
这是一个返回了入参为组件的普通函数
接着，我们需要把 Greeting 包裹到 Connect 中
const ConnectedMyComponent = Connect(Greeting);
这是一个强大的模式，它可以用来获取数据和给定数据到任意 函数组件 中。
状态提升 (State hoisting)
函数组件 没有状态 (就像名字暗示的一样)。
事件是状态的变化。
它们的数据需要传递给状态化的父 容器组件
这就是所谓的「状态提升」。
它是通过将回调从容器组件传递给子组件来完成的
class NameContainer extends React.Component {
render() {
return <Name onChange={newName => alert(newName)} />;
}
}
const Name = ({onChange}) => (
<input onChange={e => onChange(e.target.value)} />
);
Name 组件从 NameContainer 组件中接收 onChange 回调，并在 input 值变化的时候调用。
上面的 alert 调用只是一个简单的演示，但它并没有改变状态
让我们来改变 NameContainer 组件的内部状态。
class NameContainer extends React.Component {
constructor() {
super();
this.state = {name: “”};
}
render() {
return <Name onChange={newName => this.setState({ name: newName})} />;
}
}
这个状态 被提升 到了容器中，通过添加回调函数，回调中可以更新本地状态。这就设置了一个很清晰边界，并且使功能组件的可重用性最大化。
这个模式并不限于函数组件。因为函数组件没有生命周期事件，你也可以在类组件中使用这种模式。
受控输入 是一种与状态提升同时使用时很重要的模式
(最好是在一个状态化的组件上处理事件对象)
受控输入 (Controlled input)
讨论受控输入的抽象并不容易。让我们以一个不受控的（通常）输入开始。
<input type=”text” />
当你在浏览器中调整此输入时，你会看到你的更改。这个是正常的
受控的输入不允许 DOM 变更，这使得这个模式成为可能。通过在组件范围中设置值而不是直接在 DOM 范围中修改
<input type=”text” value=”This won’t change. Try it.” />
显示静态的输入框值对于用户来说并没有什么用处。所以，我们从状态中传递一个值到 input 上。
class ControlledNameInput extends React.Component {
constructor() {
super();
this.state = {name: “”};
}
render() {
return <input type=”text” value={this.state.name} />;
}
}
然后当你改变组件的状态的时候 input 的值就自动改变了。
return (
<input
value={this.state.name}
onChange={e => this.setState({ name: e.target.value})}
/>
);
这是一个受控的输入框。它只会在我们的组件状态发生变化的时候更新 DOM。这在创建一致 UI 界面的时候非常有用。
如果你使用 函数组件 做为表单元素，那就得阅读 状态提升 一节，把状态转移到上层的组件树上。