React-CheatSheet

React CheatSheet | React 设计理念,语法纵览与实践清单

这是一篇非常冗长的文章,是笔者 现代 Web 全栈开发与工程架构-React 篇 系列的提炼。

Principles | 设计理念

小而美的视图层

任何一个编程生态都会经历三个阶段,第一个是原始时期,由于需要在语言与基础的 API 上进行扩充,这个阶段会催生大量的 Tools。第二个阶段,随着做的东西的复杂化,需要更多的组织,会引入大量的设计模式啊,架构模式的概念,这个阶段会催生大量的 Frameworks。第三个阶段,随着需求的进一步复杂与团队的扩充,就进入了工程化的阶段,各类分层 MVC,MVP,MVVM 之类,可视化开发,自动化测试,团队协同系统。这个阶段会出现大量的小而美的 Library。React 与 VueJS 都是所谓小而美的视图层 Library,而不是 Angular 2 这样兼容并包的 Frameworks。

React 并没有提供很多复杂的概念与繁琐的 API,而是以最少化为目标,专注于提供清晰简洁而抽象的视图层解决方案,同时对于复杂的应用场景提供了灵活的扩展方案,典型的譬如根据不同的应用需求引入 MobX/Redux 这样的状态管理工具。React 在保证较好的扩展性、对于进阶研究学习所需要的基础知识完备度以及整个应用分层可测试性方面更胜一筹。

不过很多人对 React 的意见在于其陡峭的学习曲线与较高的上手门槛,特别是 JSX 以及大量的 ES6 语法的引入使得很多的传统的习惯了 jQuery 语法的前端开发者感觉学习成本可能会大于开发成本。与之相比 Vue 则是典型的所谓渐进式库,即可以按需渐进地引入各种依赖,学习相关地语法知识。不过这种自由也是有利有弊,所谓磨刀不误砍材工,React 相对较严格的规范对团队内部的代码样式风格的统一、代码质量保障等会有很好的加成。一言蔽之,笔者个人觉得 Vue 会更容易被纯粹的前端开发者的接受,毕竟从直接以 HTML 布局与 jQuery 进行数据操作切换到指令式的支持双向数据绑定的 Vue 代价会更小一点,特别是对现有代码库的改造需求更少,重构代价更低

React 及其相对严格的规范 可能会更容易被后端转来的开发者接受,可能在初学的时候会被一大堆概念弄混,但是熟练之后这种严谨的组件类与成员变量/方法的操作会更顺手一点。便如 Dan Abramov 所述,Facebook 推出 React 的初衷是为了能够在他们数以百计的跨平台子产品持续的迭代中保证组件的一致性与可复用性。

声明式组件

笔者在现代 Web 开发导论/数据流驱动的界面一节中,对于广义的数据流驱动的界面有很多的理解,其一是界面层的从以 DOM 操作为核心到逻辑分离,其二是数据交互层的前后端分离。在 jQuery 时代,我们往往将 DOM 操作与逻辑操作混杂在一起,再加上模块机制的缺乏使得代码的可读性、可测试性与可维护性极低;随着项目复杂度的增加、开发人员的增加与时间的推移,项目的维护成本会以几何级数增长。随着 ES6 Modules 的广泛应用,我们在前端开发中更易于去实践 SRP 单一职责原则,也更方便地去编写单元测试、集成测试等来保证代码质量。而像 React、Vue 这样现代的视图层库为我们提供了声明式组件,托管了从数据变化到 DOM 操作之间的映射,使得开发者能够专注于业务逻辑本身。并且 Redux, MobX 这样独立的状态管理库,又可以将产品中的视图层与逻辑层剥离,保证了逻辑代码的易于测试性与跨端迁移性,促进了前端的工程化步伐。

而随着从传统的前后端未分离的巨石型 Web 应用,到 SPA 这样的富客户端前后端分离应用,前后端各成体系,能够应用不同的技术选型与项目架构。原本由服务端负责的数据渲染工作交由前端进行,并且规定前端与服务端之间只能通过标准化协议进行通信,给与了双方更好地灵活性与适应性。前后端分离也促成了组织架构上的分离,由早期的服务端开发人员顺手去写个界面转变为完整的前端团队构建工程化的前端架构。近两年来随着无线技术的发展和各种智能设备的兴起,互联网应用演进到以 API 驱动的无线优先(Mobile First)和面向全渠道体验(omni-channel experience oriented)的时代,BFF 这样前端优先的 API 设计模式与 GraphQL 这样的查询语言也得到了大量的关注与应用。

声明式编程的核心理念在于描述做什么,通过声明式的方式我们能够以链式方法调用的形式对于输入的数据流进行一系列的变换处理。React 中,我们的任何组件都可以以声明式的语法表述,譬如我们要写包含多个选项的选择控件时:

<select value={this.state.value} onChange={this.handleChange}>
  {somearray.map((element) => (
    <option value={element.value}>{element.text}</option>
  ))}
</select>

React 广泛实践了函数式编程的思想,将状态到界面抽象为了如下的映射函数:$UI=f(state)$。在 React 中 $f$ 可以看做是那个 render 函数,可以将 state 渲染成 Virtual DOM,Virtual DOM 再被 React 渲染成真正的 DOM。

Virtual DOM

在组件中,我们不需要关心 DOM 是如何变更的,只需要在我们的业务逻辑中完成状态转变,React 会自动将这个变更显示在 UI 中。在浏览器渲染网页的过程中,加载到 HTML 文档后,会将文档解析并构建 DOM 树,然后将其与解析 CSS 生成的 CSSOM 树一起结合产生爱的结晶——RenderObject 树,然后将 RenderObject 树渲染成页面(当然中间可能会有一些优化,比如 RenderLayer 树)。这些过程都存在与渲染引擎之中,渲染引擎在浏览器中是于 JavaScript 引擎(JavaScriptCore 也好 V8 也好)分离开的,但为了方便 JS 操作 DOM 结构,渲染引擎会暴露一些接口供 JavaScript 调用。由于这两块相互分离,通信是需要付出代价的,因此 JavaScript 调用 DOM 提供的接口性能不咋地。各种性能优化的最佳实践也都在尽可能的减少 DOM 操作次数。而虚拟 DOM 干了什么?它直接用 JavaScript 实现了 DOM 树(大致上)。组件的 HTML 结构并不会直接生成 DOM,而是映射生成虚拟的 JavaScript DOM 结构,React 又通过在这个虚拟 DOM 上实现了一个 diff 算法找出最小变更,再把这些变更写入实际的 DOM 中。这个虚拟 DOM 以 JS 结构的形式存在,计算性能会比较好,而且由于减少了实际 DOM 操作次数,性能会有较大提升。React 渲染出来的 HTML 标记都包含了data-reactid属性,这有助于 React 中追踪 DOM 节点。很多人第一次学习 React 的时候都会觉得 JSX 语法看上去非常怪异,这种背离传统的 HTML 模板开发方式真的靠谱吗?(在 2.0 版本中 Vue 也引入了 JSX 语法支持)。我们并不能单纯地将 JSX 与传统的 HTML 模板相提并论,JSX 本质上是对于React.createElement函数的抽象,而该函数主要的作用是将朴素的 JavaScript 中的对象映射为某个 DOM 表示。其大概思想图示如下:

在现代浏览器中,对于 JavaScript 的计算速度远快于对 DOM 进行操作,特别是在涉及到重绘与重渲染的情况下。并且以 JavaScript 对象代替与平台强相关的 DOM,也保证了多平台的支持,譬如在 ReactNative 的协助下我们很方便地可以将一套代码运行于 iOS、Android 等多平台。总结而言,JSX 本质上还是 JavaScript,因此我们在保留了 JavaScript 函数本身在组合、语法检查、调试方面优势的同时又能得到类似于 HTML 这样声明式用法的便利与较好的可读性。

基于组件的架构

React 的组件系统是其精华所在,其基于组件的架构不仅

软件工程导论中介绍过,模块更多是为了

When Facebook released React.js in 2013 it redefined the way in which Front End Developers could build user interfaces. React.js, a JavaScript library, introduced a concept called Component-Based-Architecture, a method for encapsulating individual pieces of a larger user interface (aka components) into self-sustaining, independent micro-systems.

Essentially, if you’re using a client-side MVC framework like Ember.js, and to a lesser extent, Angular, you have templates that present the UI, routes that determine which templates to render, and services that define helper functions. Even if a template has routes and associated methods, all of these exist at different levels of an application’s architecture.

In the case of CBA, responsibility is split on a component-by-component basis. This means that the design, logic, and helper methods exist all within the same level of the architecture (generally the view). As aforementioned, everything that pertains to a particular component is defined within that component’s class.

Component-Based Architecture

Component | 组件系统

类组件

典型的 React 组件是继承自 Component 或者 PureComponent 并且包含了 render 函数的类:

class Welcome extends React.Component {
  render() {
    return <h1>Hello, {this.props.name}</h1>;
  }
}

如果我们不省略构造函数,那么需要注意调用 super 并且传入 props:

constructor(props) {
  super();
  console.log(this.props); // undefined
  console.log(props); // defined
}

constructor(props) {
  super(props);
  console.log(this.props); // props will get logged.
}

React 还支持函数式组件定义,该函数仅会传入单个 Props 参数:

function Welcome(props) {
  return <h1>Hello, {props.name}</h1>;
}

React 16.6 为我们提供了 memo 函数,从而保证了函数式组件也能做到缓存:

const MyComponent = React.memo(function MyComponent(props) {
  /* only rerenders if props change */
});

不过函数式组件也并非处处适用,使用函数式组件时,我们无法使用 refs,无法使用 State 并且没有生命周期函数;还需要避免使用 input 这样的非受控元素,每次重新渲染都会创建新的 input 元素。

This is another popular way of classifying components. And the criteria for the classification is simple: the components that have state and the components that don’t.

Stateful components are always class components.

JSX

目前组件支持返回数组元素,我们也可以使用 React.Fragment 来返回多个子元素而不添加额外的 DOM 元素:

render() {
  return (
    <React.Fragment>
      <ChildA />
      <ChildB />
      <ChildC />
    </React.Fragment>
  );
}

函数式组件

生命周期

dz-97vzw4aabczj

componentDidUpdate(prevProps, prevState, snapshot);

在 React 16.3 中移除了 componentWillReceiveProps 之后,我们可以在类中定义 getDerivedStateFromProps 来完成状态的自动推断:

static getDerivedStateFromProps(nextProps, prevState){
    if (nextProps.currentRow === prevState.lastRow){
        return null;
    }
    return {
        lastRow: nextProps.currentRow,
        isScrollingDown: nextProps.currentRow > prevState.lastRow
    }
}

值得一提的是,Fiber 会自动开启 StrictMode,

组件与 DOM

Ref

class VideoPlayer extends React.Component {
  constructor() {
    super();
    this.state = {
      isPlaying: false,
    };
    this.handleVideoClick = this.handleVideoClick.bind(this);
  }

  handleVideoClick() {
    if (this.state.isPlaying) {
      this.video.pause();
    } else {
      this.video.play();
    }
    this.setState({ isPlaying: !this.state.isPlaying });
  }

  render() {
    return (
      <div>
        <video
          ref={(video) => (this.video = video)}
          onClick={this.handleVideoClick}
        >
          <source src="some.url" type="video/ogg" />
        </video>
      </div>
    );
  }
}

React 16.3 版本之后允许使用 createRef 来预创建元素引用,从而更方便进行命令式控制:

class MyComponent extends React.Component {
  constructor(props) {
    super(props);

    this.inputRef = React.createRef();
  }

  render() {
    return <input type="text" ref={this.inputRef} />;
  }

  componentDidMount() {
    this.inputRef.current.focus();
  }
}

React 16 中为我们提供了 Portals,方便地将元素渲染到非当前组件树层级的节点:

render() {
// React 并不会创建新的 div,而是将其渲染到指定的 DOM 节点中
  return ReactDOM.createPortal(
    this.props.children,
    domNode
  );
}

事件监听与响应

为了避免过多地事件监听,React 引入了 SyntheticEvent 来集中式地监听事件与调用响应函数;我们自定义的事件处理器都会被传入 SyntheticEvent 对象,其支持 stopPropagation()preventDefault(),并且保证了跨浏览器的一致性。出于性能的考虑,SyntheticEvent 会复用传入的 Event 对象,因此我们避免直接异步读取 Event 对象的值,而是应该使用闭包将需要的值保存下来:

function onClick(event) {
  console.log(event); // => nullified object.
  console.log(event.type); // => "click"
  const eventType = event.type; // => "click"

  this.setState({ eventType: event.type });
}

对于 DOM 事件标准中定义的 Capturing phase 与 Bubbling phase,React 也提供了 onClick 与 onClickCapture:

<div onClickCapture={this.handleClickViaCapturing}>
  <button onClick={this.handleClick}>
    Click me, and my parent's `onClickCapture` will fire *first*!
  </button>
</div>

组件样式

样式类

import cx from "classnames";
import styles from "./capsule.css";

// 使用 classnames
let className = cx(styles.base, {
  [styles.clickable]: this.props.clickable,
  [styles.withIcon]: !!this.props.icon,
});
return <div className={className} />;

// 使用朴素的数组操作
return (
  <div
    classNames={[styles.base, styles.clickable, styles.withIcon].join(" ")}
  />
);

CSS-in-JS

组件动画与变换

React Transition Group 提供了 Transition, CSSTransition, TransitionGroup 三个辅助组件,来根据组件的状态添加合适的过渡动画。Transition 组件提供了简单的声明式接口,来向子组件传递当前的动画状态:

import Transition from "react-transition-group/Transition";

const duration = 300;

const defaultStyle = {
  transition: `opacity ${duration}ms ease-in-out`,
  opacity: 0,
};

const transitionStyles = {
  entering: { opacity: 0 },
  entered: { opacity: 1 },
};

const Fade = ({ in: inProp }) => (
  <Transition in={inProp} timeout={duration}>
    {(state) => (
      <div
        style={{
          ...defaultStyle,
          ...transitionStyles[state],
        }}
      >
        I'm a fade Transition!
      </div>
    )}
  </Transition>
);

CSSTransition 则是自动为不同的动画状态匹配不同的样式类:

📎 完整代码参阅 CodeSandbox

<CSSTransition
  in={showValidationMessage}
  timeout={300}
  classNames="message"
  unmountOnExit
  onExited={() => {
    this.setState({
      showValidationButton: true,
    });
  }}
>
  {(state) => (
    <HelpBlock>
      Your name rocks!
      <CSSTransition
        in={state === "entered"}
        timeout={300}
        classNames="star"
        unmountOnExit
      >
        <div className="star"></div>
      </CSSTransition>
    </HelpBlock>
  )}
</CSSTransition>

其中 classNames 属性会自动在不同阶段应用不同的样式类名,我们也可以自行定义:

classNames={{
 appear: 'my-appear',
 appearActive: 'my-active-appear',
 enter: 'my-enter',
 enterActive: 'my-active-enter',
 enterDone: 'my-done-enter,
 exit: 'my-exit',
 exitActive: 'my-active-exit',
 exitDone: 'my-done-exit,
}}

最后的 TransitionGroup 则是为我们提供了多个组件的管理,譬如 <Transition><TransitionGroup>,作为状态机来管理组件挂载或者卸载时候的状态。

Component Dataflow | 组件数据流

Props

PropTypes.array, PropTypes.bool, PropTypes.func, PropTypes.number, PropTypes.object, PropTypes.string, PropTypes.symbol, 对于 React 可渲染的类型还包括 PropTypes.node 与 PropTypes.element

import PropTypes from "prop-types";

MyComponent.propTypes = {
  // 指定类实例
  optionalMessage: PropTypes.instanceOf(Message), // 枚举类型

  optionalEnum: PropTypes.oneOf(["News", "Photos"]), // 可能为多种类型

  optionalUnion: PropTypes.oneOfType([
    PropTypes.string,
    PropTypes.number,
    PropTypes.instanceOf(Message),
  ]), // 包含指定类型的数组

  optionalArrayOf: PropTypes.arrayOf(PropTypes.number), // 包含指定值类型的对象

  optionalObjectOf: PropTypes.objectOf(PropTypes.number), // 某个具体形状的对象

  optionalObjectWithShape: PropTypes.shape({
    color: PropTypes.string,
    fontSize: PropTypes.number,
  }),

  // ...
};

Children

React 的核心为组件,而在嵌套使用中,我们可以通过 props.children 来引用当前组件的子组件;React 中的 Children 不一定是组件,它们可以是任何东西。鉴于这种不确定性,React 为我们提供了多个 API 进行元素的操控:

// 复制某个元素
React.cloneElement(element, [props], [...children]);

// 从某个组件类或者类型中创建元素
React.createElement(type, [props], [...children]);

// 转换子元素
React.Children.map(children, function[(thisArg)])

// 遍历子元素
React.Children.forEach(children, function[(thisArg)])

// 如果仅有单个子元素,则返回
React.Children.only(children)

React.Children.map 与 React.Children.forEach 能够用于遍历与转化,即使 children 传入的是函数对象也能够正常处理:

// 忽略首个元素
{
  React.Children.map(children, (child, i) => {
    // Ignore the first child
    if (i < 1) return;
    return child;
  });
}

// 即使传入的是函数,也能够正常执行
<IgnoreFirstChild>
  {() => <h1>First</h1>} // <- Ignored 💪
</IgnoreFirstChild>

React.Children.count 则是能够对子元素进行正确的统计:

// Renders "3"
<ChildrenCounter>
  {() => <h1>First!</h1>}
  Second!
  <p>Third!</p>
</ChildrenCounter>

能将 children 转换为数组通过 React.Children.toArray 方法。如果你需要对它们进行排序,这个方法是非常有用的。

class Sort extends React.Component {
  render() {
    const children = React.Children.toArray(this.props.children);
    // Sort and render the children
    return <p>{children.sort().join(" ")}</p>;
  }
}

<Sort>
  // We use expression containers to make sure our strings // are passed as
  three children, not as one string
  {"bananas"}
  {"oranges"}
  {"apples"}
</Sort>;

在已知仅有一个子元素的情况下,我们也可以使用 only 函数来获取该元素实例:

class Executioner extends React.Component {
  render() {
    return React.Children.only(this.props.children)();
  }
}

在需要对子元素进行修改的场景下,我们可以使用 cloneElement,将想要克隆的元素当作第一个参数,然后将想要设置的属性以对象的方式作为第二个参数。

renderChildren() {
  return React.Children.map(this.props.children, child => {
    return React.cloneElement(child, {
      name: this.props.name
    })
  })
}

State

// 先获取元素下标,然后执行删除
const array = [...this.state.people]; // make a separate copy of the array
const index = array.indexOf(e.target.value);
array.splice(index, 1);

// 使用 filter 进行过滤删除

不可变对象

removePeople(e) {
  var array = [...this.state.people]; // make a separate copy of the array
  var index = array.indexOf(e.target.value)
  array.splice(index, 1);
  this.setState({people: array});
},

removePeople(e) {
    this.setState({people: this.state.people.filter(function(person) {
        return person !== e.target.value
    })};
}

异步数据处理

async componentDidMount() {
  try {
    const response = await fetch(`https://api.coinmarketcap.com/v1/ticker/?limit=10`);
    if (!response.ok) {
      throw Error(response.statusText);
    }
    const json = await response.json();
    this.setState({ data: json });
  } catch (error) {
    console.log(error);
  }
}

受控组件

React 中的组件又可以分为受控组件与非受控组件,所谓的非受控组件即 render 函数直接返回 input 这样的标签,状态直接存放在 DOM 而非组件类中。

    render() {
        return (
            <input />
        )
    }

我们可以通过接管标签的改变事件与值,来将非受控组件转化为受控组件:

  handleChange: function (propertyName, event) {
    const contact = this.state.contact;
    contact[propertyName] = event.target.value;
    this.setState({ contact: contact });
  },
  render: function () {
    return (
      <div>
        <input type="text" onChange={this.handleChange.bind(this, 'firstName')} value={this.state.contact.firstName}/>
        <input type="text" onChange={this.handleChange.bind(this, 'lastName')} value={this.state.contact.lastName}/>
        <input type="text" onChange={this.handleChange.bind(this, 'phone')} value={this.state.contact.lastName}/>
      </div>
    );
  }

Context

React 16.3 之后引入了新的 Context API,允许我们以 renderProps 的方式使用上下文中的值:

const ThemeContext = React.createContext("light");

class ThemeProvider extends React.Component {
  state = { theme: "light" };

  render() {
    return (
      <ThemeContext.Provider value={this.state.theme}>
        {this.props.children}
      </ThemeContext.Provider>
    );
  }
}

class ThemedButton extends React.Component {
  render() {
    return (
      <ThemeContext.Consumer>
        {(theme) => <Button theme={theme} />}
      </ThemeContext.Consumer>
    );
  }
}

我们也可以更为灵活地通过声明类的 contextType 来使用上下文:

class MyClass extends React.Component {
  // 或者在类外声明
  static contextType = MyContext;

  componentDidMount() {
    let value = this.context;
    /* perform a side-effect at mount using the value of MyContext */
  }
  componentDidUpdate() {
    let value = this.context;
    /* ... */
  }
  componentWillUnmount() {
    let value = this.context;
    /* ... */
  }
  render() {
    let value = this.context;
    /* render something based on the value of MyContext */
  }
}

MyClass.contextType = MyContext;

Suspense

Suspense allows you to defer rendering part of your application tree until some condition is met (for example, data from an endpoint or a resource is loaded).

理论上,React 的工作分为两个阶段:

render(渲染)阶段,将决定是否需要更新 DOM。此时 React 调用 render 函数,然后将本次 render 函数的结果与上一次的结果进行比较。

commit(提交)阶段,当 React 做出更新 DOM 的操作(DOM 节点的增加,删除,修改等)时,此阶段还会调用 componentDidMount,componentDidUpdate 等与生命周期相关的函数。

React Router

const PrivateRoute = ({ component: Component, ...rest }) => (
  <Route {...rest} render={(props) => (
    fakeAuth.isAuthenticated === true
      ? <Component {...props} />
      : <Redirect to={{
          pathname: '/login',
          state: { from: props.location }
        }} />
  )} />
)

<PrivateRoute path='/protected' component={Protected} />

Design Pattern | 架构模式

HoC | 高阶组件

Presentational Components & Container Components

This is another pattern that is very useful while writing components. The benefit of this approach is that the behavior logic is separated from the presentational logic.

  • Presentational Components

Presentational components are coupled with the view or how things look. These components accept props from their container counterpart and render them. Everything that has to do with describing the UI should go here.

Presentational components are reusable and should stay decoupled from the behavioral layer. A presentational component receives the data and callbacks exclusively via props and when an event occurs, like a button being pressed, it performs a callback to the container component via props to invoke an event handling method.

Functional components should be your first choice for writing presentational components unless a state is required. If a presentational component requires a state, it should be concerned with the UI state and not actual data. The presentational component doesn’t interact with the Redux store or make API calls.

  • Container Components

Container components will deal with the behavioral part. A container component tells the presentational component what should be rendered using props. It shouldn’t contain limited DOM markups and styles. If you’re using Redux, a container component contains the code that dispatches an action to a store. Alternatively, this is the place where you should place your API calls and store the result into the component’s state.

The usual structure is that there is a container component at the top that passes down the data to its child presentational components as props. This works for smaller projects; however, when the project gets bigger and you have a lot of intermediate components that just accept props and pass them on to child components, this will get nasty and hard to maintain. When this happens, it’s better to create a container component unique to the leaf component, and this will ease the burden on the intermediate components.

renderProps

Hooks

工程实践

16.3 版本中,React 为我们提供了 StrictMode 组件,来强制保证代码的最佳实践。

<StrictMode>
  <App />
</StrictMode>

异常处理

性能优化

组件分割

SystemJS 或者 ES 中的 Dynamic Import 允许我们动态地导入 ES Modules,也就方便了我们在应用中应用组件分割,以实现按需加载,优化首屏体验:

image

一般来说,我们可以根据路由或者组件来执行懒加载,不过在 React Router 4 遵循路由即组件的理念之后,二者也无太大差异:

class MyComponent extends React.Component {
  state = {
    Bar: null,
  };

  componentWillMount() {
    import("./components/Bar").then((Bar) => {
      this.setState({ Bar });
    });
  }

  render() {
    let { Bar } = this.state;
    if (!Bar) {
      return <div>Loading...</div>;
    } else {
      return <Bar />;
    }
  }
}

react-loadable 是非常不错的异步组件加载库,同时能够支持服务端渲染等多种场景:

import Loadable from "react-loadable";

const LoadableBar = Loadable({
  loader: () => import("./components/Bar"),
  loading() {
    return <div>Loading...</div>;
  },
});

class MyComponent extends React.Component {
  render() {
    return <LoadableBar />;
  }
}

Async Rendering | 异步渲染

image

image

Ecosystem | React 生态圈

在跨平台开发领域,React Native 是当之无愧的跨平台开发首选。而 ElectronProton Native 也都能为我们提供

Same syntax as React Native Works with existing React libraries such as Redux Cross platform Native components. No more Electron Compatible with all normal Node.js packages

Proton Native does the same to desktop that React Native did to mobile. Build cross-platform apps for the desktop, all while never leaving the React eco-system. Popular React packages such as Redux still work.

TypeScript

React 的 TypeScript 类型声明可以参考 types/reactantd 也是非常不错的使用 TypeScript 开发的大型 React 项目。

import * as React from "react";
import formatPrice from "../utils/formatPrice";

export interface IPriceProps {
  num: number;
  symbol: "$" | "€" | "£";
}

const Price: React.SFC<IPriceProps> = ({ num, symbol }: IPriceProps) => (
  <div>
    <h3>{formatPrice(num, symbol)}</h3>
  </div>
);
export function positionStyle<T>(
  Component: React.ComponentType
): React.StatelessComponent<T & { left: number; top: number }> {
  return (props: any) => {
    const { top, left, ...rest } = props;
    return (
      <div style={{ position: "absolute", top, left }}>
        <Component {...rest} />
      </div>
    );
  };
}

高阶组件

譬如在 types/react-redux 中,connect 函数的类型声明可以 interface 来声明多个重载:

export interface Connect {
  ...
    <TStateProps = {}, TDispatchProps = {}, TOwnProps = {}, State = {}>(
      mapStateToProps: MapStateToPropsParam<TStateProps, TOwnProps, State>,
      mapDispatchToProps: MapDispatchToPropsParam<TDispatchProps, TOwnProps>
  ): InferableComponentEnhancerWithProps<TStateProps & TDispatchProps, TOwnProps>;
  ...
}

export declare const connect: Connect;

延伸阅读

上一页
下一页