前言:前一篇记录了【后台管理系统】目前进展开发中遇到的一些应用点,这一篇会梳理一些自己学习Ant Design Pro源码的功能点。附:Ant Design Pro 在线预览地址。 


Dashboard指示板

ant design pro 跳转后端配置 ant design pro教程_webpack

pages/Dashboard 目录下:Analysis.js分析页、Monitor.js指控页、WorkPlace.js工作台

用到的一些技术点:react v16.6 动态 import,React.lazy()、Suspense、Error boundaries (来源:Postbird博客

Ⅰ、动态 import

在 Code-Splitting

比如下面两种使用方式的对比:

之前:



import { add } from './math';

console.log(add(16, 26));



之后: 



import("./math").then(math => {
  console.log(math.add(16, 26));
});



可以发现动态 import 提供了 Promise 规范的 API,比如 .then(),关于 ES 动态 import,可以查看下面链接: 

同样,下面这篇文章上也可以参考:

目前动态 import 仍旧是 ECMAScript 的提案,并没有纳入规范,不过既然 react 能够大力的推进,应该下个标准会被写入。可以查看 TC39-https://github.com/tc39/proposal-dynamic-import

动态 import 主要用于延迟请求,对于组件我觉得没什么太大的用处,但是对于延迟加载方法或者bundle非常有用,比如下面的代码:

可以发现,当触发点击事件的时候,才会去引入需要的方法或者是对象,并且由于 Promise API 的特性,可以使用 Promise.all Promise.race 这种 API,进行并行加载,然后在 then() 回调中调用方法,非常方便



class App extends Component {
  clickHandle = (e) => {
    Promise.all([
      import('./mods/Lazy2')
    ]).then(([a]) => {
      console.log(a);
        a(e);
    });
  }
  render() {
    return (
      <div className="App">
        <header className="App-header">
          <button onClick={this.clickHandle}>click</button>
        </header>
      </div>
    );
  }
}



webpack 已经支持动态 import,在 create-react-app 和 next.js 中都已经可以使用。如果是自己的 webpack 脚手架,需要在 webpack 中进行配置,具体的可以参考下面的方式https://webpack.js.org/guides/code-splitting/,最终配置完的样式类似于:https://gist.github.com/gaearon/ca6e803f5c604d37468b0091d9959269(这个链接是react文档给出的额,但是我的网络无法访问)

同样的,如果使用 babel,需要使用babel-plugin-syntax-dynamic-import这个组件来保证Babel不对动态导入进行转换。

Ⅱ、React.lazy() 和 Suspense

1、React.lazy()

动态 import 主要应用场景是延迟加载方法,对于组件来说,并不是很适用,但是 React.lazy

  • 目前明确指出,React.lazy 和 suspense 并不适用于服务端渲染

先看一下前后的区别,

之前代码: 



import OtherComponent from './OtherComponent';

function MyComponent() {
  return (
    <div>
      <OtherComponent />
    </div>
  );
}



之后:



const OtherComponent = React.lazy(() => import('./OtherComponent'));

function MyComponent() {
  return (
    <div>
      <OtherComponent />
    </div>
  );
}



关键点是 const OtherComponent = React.lazy(() => import('./OtherComponent')); 这个语句,摒弃了之前的 import X from 'x' 的静态引入方式。 

同样的,这个变动会使得在组件渲染的时候,再去加载包含引入路径的组件。

React.lazy(()=>{})



const Lazy2 = React.lazy(() =>import('./mods/Lazy2').then((e) => {
  console.log(e);
}));



箭头句柄后面就是一个动态 import 的使用, 打印出来的 e,也就是引入的内容,而前面引入的是个组件,因此会打印出如下信息: 

ant design pro 跳转后端配置 ant design pro教程_webpack_02

2、Suspense

要使用 Suspense,需要从 react 中 import:



import React, { Component, Suspense } from 'react';



既然是延迟加载,就会有一个加载过程,之前在渲染的时候,我们基本都是自顶一个一个 <Loading> 组件,然后通过变量控制进行操作,如果加载完成,则取消掉 <Loading> 组件。

如果直接使用 React.lazy,会报错误:需要一个 placeholder ui 

ant design pro 跳转后端配置 ant design pro教程_webpack_03

既然是延迟加载,就一定会有一个loading的过程,而 Suspense 正是完成这个过程。

ant design pro 跳转后端配置 ant design pro教程_加载_04

如同上面的效果会有一个动态的过程,代码如下:



render() {
  return (
    <div className="App">
      <header className="App-header">
      <Suspense fallback={<div>Loading...</div>}>
        {this.renderList()}
      </Suspense>
      </header>
    </div>
  );
}



Suspense 使用的时候,fallback。  

针对网络请求的 loading,我并没觉的这种 fallback 有什么帮助,因为他是组件加载的 loading,如果组件加载完了,那么再去 fallback 就没意义,也没效果了。

 

Ⅲ、Error boundaries

上面 Suspense

这里只对错误边界进行一个简要的使用,具体的文档见下:

这里的错误边界用在这个位置是为了当组件懒加载失败的时候,进行错误的捕获和保护:

1、创建错误边界组件



class ErrorBoundary extends React.Component {
  constructor(props) {
    super(props);
    this.state = { hasError: false };
  }
  // 从error中接收错误并设置 state
  static getDerivedStateFromError(error) {
    // Update state so the next render will show the fallback UI.
    return { hasError: true };
  }

  componentDidCatch(error, info) {
    // You can also log the error to an error reporting service
    logErrorToMyService(error, info);
  }

  render() {
    if (this.state.hasError) {
      // You can render any custom fallback UI
      return <h1>Something went wrong.</h1>;
    }

    return this.props.children; 
  }
}



2、在组件中使用错误边界

将创建的错误边界挂到组件中,不适用 React.lazy,因为已经没有更上一层次的错误组件了,万一错误边界组件也懒加载出错,会导致无法捕获。

错误边界组件中,通过 componentDidCatch

错误边界的使用示例可以参考下面的示例:

按照上面的例子,在使用的时候,组件中报错,触发错误边界:

Lazy2.jsx:



render() {
    throw new Error('I crashed!');
    return (
      <div>
        <p>{this.state.title}</p>
      </div>
    );
}



App.jsx: 



<Error>
    {this.renderList()}
</Error>



Error.jsx:



import React, {Component} from 'react';

class Error extends Component {
  constructor(props) {
    super(props);
    this.state = { error: null, errorInfo: null };
  }
  
  componentDidCatch(error, errorInfo) {
    // Catch errors in any components below and re-render with error message
    this.setState({
      error: error,
      errorInfo: errorInfo
    })
    // You can also log error messages to an error reporting service here
  }
  
  render() {
    if (this.state.errorInfo) {
      // Error path
      return (
        <div>
          <h2>Something went wrong.</h2>
          <details style={{ whiteSpace: 'pre-wrap' }}>
            {this.state.error && this.state.error.toString()}
            <br />
            {this.state.errorInfo.componentStack}
          </details>
        </div>
      );
    }
    // Normally, just render children
    return this.props.children;
  }  
}

export default Error;



最终结果: 

ant design pro 跳转后端配置 ant design pro教程_加载_05

 

Dashboard模块除了上面的新技术点,在AntD组件和布局上也有一些常用的知识点:GridContent网格内容布局、Charts图表、Tabs标签页

Ⅰ、GridContent网格内容布局

ant design pro 跳转后端配置 ant design pro教程_ui_06

 

使用GridContent组件,需要从components/PageHeaderWrapper目录下引用,源码如下↓


import React, { PureComponent } from 'react';
import { connect } from 'dva';
import styles from './GridContent.less';

class GridContent extends PureComponent {
  render() {
    const { contentWidth, children } = this.props;
    let className = `${styles.main}`;
    if (contentWidth === 'Fixed') {
      className = `${styles.main} ${styles.wide}`;
    }
    return <div className={className}>{children}</div>;
  }
}

export default connect(({ setting }) => ({
  contentWidth: setting.contentWidth,
}))(GridContent);


1、组件继承自PureComponent

PureComponent 纯组件是React新加的一个类,是优化 React 应用程序最重要的方法之一,易于实施。

只要把继承类从 Component 换成 PureComponent 即可,可以减少不必要的 render 操作的次数,从而提高性能,而且可以少写 shouldComponentUpdate 函数,节省了点代码。

具体使用及原理可参看下面的链接:

2、设置多个PageHeader网格式分布样式


.main {
  width: 100%;
  height: 100%;
  min-height: 100%;
  transition: 0.3s;
  &.wide {
    max-width: 1200px;
    margin: 0 auto;
  }
}


 

Ⅱ、Charts图表

利用 Ant Design Pro 提供的图表套件,可以灵活组合符合设计规范的图表来满足复杂的业务需求。

ant design pro 跳转后端配置 ant design pro教程_webpack_07

ant design pro 跳转后端配置 ant design pro教程_ViewUI_08

迷你区域图MiniArea

迷你进度条MiniProgress

ant design pro 跳转后端配置 ant design pro教程_ui_09

ant design pro 跳转后端配置 ant design pro教程_加载_10


迷你柱状图MiniBar

柱状图Bar

ant design pro 跳转后端配置 ant design pro教程_ViewUI_11

ant design pro 跳转后端配置 ant design pro教程_加载_12


饼状图Pie, yuan

迷你饼状图Pie