React系列十二 - AntDesign UI库

对于学习过程，不是特别建议从一开始就使用别人的第三方库UI库，更重要的是要学会组件化相关的知识（就想前面我们已经讲了非常相关知识），之后自己来封装、设计一套自己的可复用组件。

但是在公司开发为了开发效率，我们往往也会选择一些非常优秀的第三方UI库，而AntDesign就是这样的一套优秀的UI组件库。

一. 认识AntDesign

1.1. AntDesign的介绍

AntDesign ，简称 antd 是基于 Ant Design 设计体系的 React UI 组件库，主要用于研发企业级中后台产品。

AntDesign的特点：

• :rainbow: 提炼自企业级中后台产品的交互语言和视觉风格。

• :package: 开箱即用的高质量 React 组件。

• 使用 TypeScript 开发，提供完整的类型定义文件。

• ⚙️ 全链路开发和设计 工具 体系。

• :earth_africa: 数十个国际化语言支持。

• :art: 深入每个细节的主题定制能力。

全链路开发和设计指的是什么？

• 全链路这个词我记得是16年左右阿里提出的；

• 从 业务战略—用户场景—设计目标—交互体验—用户流程—预期效率 全方面进行分析和考虑；

• 这个主要是产品经理会考虑的一个点；

AntDesign的兼容性：

• 现代浏览器和 IE11（需要 polyfills）。

• 支持服务端渲染。

• Electron

antd@2.0 之后不再支持 IE8， antd@4.0 之后不再支持 IE9/10。

目前稳定的版本：v4.4.0

1.2. AntDesign的安装

使用 npm 或 yarn 安装

npm安装：

npm install antd --save

yarn安装：

yarn add antd

我们需要在index.js中引入全局的Antd样式：

import "antd/dist/antd.css";

在App.js中就可以使用一些组件了：

考虑一个问题：Antd是否会将一些没有用的代码（组件或者逻辑代码）引入，造成包很大呢？

antd 官网有提到： antd 的 JS 代码默认支持基于 ES modules 的 tree shaking，对于 js 部分，直接引入 import { Button } from 'antd' 就会有按需加载的效果。

1.3. 高级配置

1.3.1. 认识craco

上面的使用过程是无法对主题进行配置的，好像对主题等相关的高级特性进行配置，需要修改create-react-app 的默认配置。

如何修改create-react-app 的默认配置呢？

• 前面我们讲过，可以通过 yarn run eject 来暴露出来对应的配置信息进行修改；

• 但是对于webpack并不熟悉的人来说，直接修改 CRA 的配置是否会给你的项目带来负担，甚至会增加项目的隐患和不稳定性呢？

• 所以，在项目开发中是不建议大家直接去修改 CRA 的配置信息的；

那么如何来进行修改默认配置呢？社区目前有两个比较常见的方案：

• react-app-rewired + customize-cra；（这个是antd早期推荐的方案）

• craco；（目前antd推荐的方案）

第一步：安装craco：

yarn add @craco/craco

第二步：修改package.json文件

• 原本启动时，我们是通过react-scripts来管理的；

• 现在启动时，我们通过craco来管理；

"scripts": {
-   "start": "react-scripts start",
-   "build": "react-scripts build",
-   "test": "react-scripts test",
+   "start": "craco start",
+   "build": "craco build",
+   "test": "craco test",
}

第三步：在根目录下创建craco.config.js文件用于修改默认配置

module.exports = {
  // 配置文件
}

1.3.2. 配置主题

按照 配置主题 的要求，自定义主题需要用到类似 less-loader 提供的 less 变量覆盖功能：

• 我们可以引入 craco-less 来帮助加载 less 样式和修改变量；

安装 craco-less ：

yarn add craco-less

修改craco.config.js中的plugins：

• 使用 modifyVars 可以在运行时修改LESS变量；

const CracoLessPlugin = require('craco-less');

module.exports = {
  plugins: [
    {
      plugin: CracoLessPlugin,
      options: {
        lessLoaderOptions: {
          lessOptions: {
            modifyVars: { '@primary-color': '#1DA57A' },
            javascriptEnabled: true,
          },
        },
      },
    },
  ],
}

引入antd的样式时，引入antd.less文件：

// import "antd/dist/antd.css";
import 'antd/dist/antd.less';

修改后重启 yarn start ，如果看到一个绿色的按钮就说明配置成功了。

1.3.3. 配置别名

在项目开发中，某些组件或者文件的层级会较深，

• 如果我们通过上层目录去引入就会出现这样的情况： ../../../../components/button ；

• 如果我们可以配置别名，就可以直接从根目录下面开始查找文件： @/components/button ，甚至是： components/button ；

配置别名也需要修改webpack的配置，当然我们也可以借助于 craco 来完成：

...

const path = require("path");
const resolve = dir => path.resolve(__dirname, dir);

module.exports = {
  ...
  ,
  webpack: {
    alias: {
      '@': resolve("src"),
      'components': resolve("src/components"),
    }
  }
}

在导入时就可以按照下面的方式来使用了：

import HYCommentInput from '@/components/comment-input';
import HYCommentItem from 'components/comment-item';

二. AntDesign案例

我们通过AntDesign来编写一个案例：

1.1. 案例-评论框

我们选来完成评论框，评论框有两部分组成：

• TextArea的输入框：Input.TextArea；

• 提交评论的按钮：Button；

import React, { PureComponent } from 'react';

import moment from 'moment';
import {
  Form, Button, Input
} from 'antd';

export default class HYCommentInput extends PureComponent {
  constructor(props) {
    super(props);

    this.state = {
      value: ""
    }
  }

  render() {
    return (
      <div>
        <Input.TextArea rows={4} onChange={this.onChange.bind(this)} value={this.state.value} />
        <Button onClick={this.onSubmit.bind(this)} type="primary">
          添加评论
        </Button>
      </div>
    )
  }

  onChange(e) {
    this.setState({
      value: e.target.value
    })
  }

  onSubmit() {
    console.log(this.state.value, moment().fromNow());
    const commentInfo = {
      id: Date.now(),
      name: "coderwhy",
      avatar: "https://upload.jianshu.io/users/upload_avatars/1102036/c3628b478f06.jpeg?imageMogr2/auto-orient/strip|imageView2/1/w/240/h/240",
      content: <p>{this.state.value}</p>,
      datetime: moment()
    }

    this.props.submitComment(commentInfo);
    this.setState({
      value: ""
    });
  }
}

1.2. 案例-评论列表

评论列表主要是使用Comment组件，Comment组件有一些属性：

• author：展示作者的名称；

• avatar：展示作者的头像；

• 可以使用Avatar的组件进行展示；

• content：展示评论的内容；

• datetime：展示评论的时间：

• 这里我们可以使用Tooltip组件，当鼠标放在上面时，会显示对应的title内容；

• actions：评论下方的操作按钮；

• 这里我们可以使用DeleteOutlined，但是它来自 @ant-design/icons ，需要我们进行安装；

import React, { PureComponent } from 'react';

import {
  Comment,
  Avatar,
  Tooltip
} from "antd";
import { DeleteOutlined } from "@ant-design/icons";

export default class HYCommentItem extends PureComponent {
  render() {
    const { comment } = this.props;

    return (
      <Comment
        author={<a href="/#">{comment.name}</a>}
        avatar={
          <Avatar
            src={comment.avatar}
            alt={comment.name}
          />
        }
        content={comment.content}
        datetime={
          <Tooltip title={comment.datetime.format('YYYY-MM-DD HH:mm:ss')}>
            <span>{comment.datetime.fromNow()}</span>
          </Tooltip>
        }
        actions={ this.getActions() }
      />
    )
  }

  getActions() {
    return [
      <span onClick={this.props.removeItem}><DeleteOutlined/> 删除</span>
    ]
  }
}

1.3. 案例-App组件

我们在App组件中，使用封装的两个组件：

import React, { PureComponent } from 'react';

import HYCommentInput from './components/comment-input';
import HYCommentItem from './components/comment-item';

export default class App extends PureComponent {
  constructor(props) {
    super(props);

    this.state = {
      commentList: []
    }
  }

  render() {
    return (
      <div style={{width: "500px", padding: "20px"}}>
        {
          this.state.commentList.map((item, index) => {
            return <HYCommentItem key={item.id} 
                                  comment={item} 
                                  index={index} 
                                  removeItem={e => this.removeItem(index)}/>
          })
        }
        <HYCommentInput submitComment={this.submitComment.bind(this)}/>
      </div>
    )
  }

  submitComment(comment) {
    this.setState({
      commentList: [...this.state.commentList, comment]
    })
  }

  removeItem(index) {
    const newCommentList = [...this.state.commentList];
    newCommentList.splice(index, 1);
    this.setState({
      commentList: newCommentList
    })
  }
}