版本:v3.26.3

react系列有一大堆的组件,可以在ant design官网的,社区精选组件里面看到

一、简介

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

✅ Ant Design:用空格分隔的首字母大写单词,指代设计语言。

✅ antd:全小写,指代 React UI 组件库。

✅ ant.design:特指 ant.design 网站网址。

安装:npm install antd --save

  • 使用组件:使用组件的时候,需要在对应的react组件中,引入antd组件和antd样式文件。或者直接在入口文件main.js中全局引入(就需要每次使用都要引入了)
    • 引入相关组件:import { ConfigProvider, DatePicker, message } from 'antd';
    • 引入样式:import 'antd/dist/antd.css';
    • 插件:为了可以像上面那样按需加载组件,需要引入babel,使用 babel-plugin-import 来进行按需
    • 使用 Day.js 替换 momentjs 优化打包大小:可以使用 antd-dayjs-webpack-plugin 插件用 Day.js 替换 momentjs 来大幅减小打包大小。这需要更新 webpack 的配置文件如下:
// webpack-config.js
import AntdDayjsWebpackPlugin from 'antd-dayjs-webpack-plugin';
module.exports = {plugins: [new AntdDayjsWebpackPlugin()],};

二、快速上手

小例子:

import React from 'react';
import { ConfigProvider, DatePicker, message,Alert } from 'antd';
import zhCN from 'antd/es/locale/zh_CN'; // 由于 antd 组件的默认文案是英文,所以需要修改为中文
import moment from 'moment';
import 'moment/locale/zh-cn';
import 'antd/dist/antd.css';
moment.locale('zh-cn');
export default class Home extends React.Component {
    state = {date: null,};
      handleChange = date => {
        message.info(`您选择的日期是: ${date ? date.format('YYYY-MM-DD') : '未选择'}`);
        this.setState({ date });
      };
      render() {
        const { date } = this.state;
        return (
        <div>
          <ConfigProvider locale={zhCN}>
            <div style={{ width: 400, margin: '100px auto' }}>
              <DatePicker onChange={this.handleChange} />
              <div style={{ marginTop: 20 }}>
                <Alert message={`当前日期:${date ? date.format('YYYY-MM-DD') : '未选择'}`} type="success" />
              </div>
            </div>
          </ConfigProvider>
          </div>
        );
      }
}

antd,组件配置的写法,如下:组件有很多配置信息的时候,把组件的配置信息,全都写在上面的变量里面。并且在return的时候,最好不要直接return antd的组件出去,而需要在antd组件外面包一层div,然后再暴露出去

class demo extends PureComponent {
  render() {
  // 这个props就是配置信息了
    const props = {
      name: 'file',
      action: 'https://www',
      headers: {
        authorization: 'authorization-text',
      },
    };
    return (
    // 把props直接用拓展运算符展开。这个写法就很直观了,很方便查看
    <div>
      <Upload {...props}></Upload>
    </div>
    );
  }
};

三、项目实战

我们基于 Redux 推出了自己的最佳实践 dva,以及可插拔的企业级应用框架 umi,推荐你在项目中使用

dva 是一个基于 Redux 的 轻量级数据流方案,这个有点像vuex,概念来自 elm,支持 side effects、热替换、动态加载、react-native、SSR 等,已在生产环境广泛应用

umi 则是一个可插拔的企业级 react 应用框架。umi 以路由为基础的,支持类 next.js 的约定式路由,以及各种进阶的路由功能,并以此进行功能扩展,比如支持路由级的按需加载。然后配以完善的插件体系,覆盖从源码到构建产物的每个生命周期,支持各种功能扩展和业务需求,同时提供 Umi UI 通过可视化辅助编程(VAP)提高开发体验和研发效率。

1、umi

安装 Umi UI: npm install umi -g。还没看懂,后面再了解

2、dva

  • dva 通过 model 的概念把一个领域的模型管理起来,包含同步更新 state 的 reducers,处理异步逻辑的 effects,订阅数据源的 subscriptions
    • namespace 表示在全局 state 上的 key
    • state 是初始值,在这里是空数组
    • reducers 等同于 redux 里的 reducer,接收 action,同步更新 state
// 如下,新建model
// src/models/products.js
export default {
  namespace: 'products',
  state: [],
  reducers: {
    delete(state, { payload: id }) {
      return state.filter(item => item.id !== id);
    },
  },
};

四、定制主题

Ant Design 设计规范和技术上支持灵活的样式定制,以满足业务和品牌上多样化的视觉需求,包括但不限于全局样式(主色、圆角、边框)和指定组件的视觉定制

antd 的样式使用了 Less 作为开发语言,以下是一些最常用的通用变量。 所有样式的路径为 https://github.com/ant-design/ant-design/blob/master/components/style/themes/default.less

// 需要先引入这个
@import '~antd/lib/style/themes/default.less';

@primary-color: #1890ff; // 全局主色
@link-color: #1890ff; // 链接色
@success-color: #52c41a; // 成功色
@warning-color: #faad14; // 警告色
@error-color: #f5222d; // 错误色
@font-size-base: 14px; // 主字号
@heading-color: rgba(0, 0, 0, 0.85); // 标题色
@text-color: rgba(0, 0, 0, 0.65); // 主文本色
@text-color-secondary : rgba(0, 0, 0, .45); // 次文本色
@disabled-color : rgba(0, 0, 0, .25); // 失效色
@border-radius-base: 4px; // 组件/浮层圆角
@border-color-base: #d9d9d9; // 边框色
@box-shadow-base: 0 2px 8px rgba(0, 0, 0, 0.15); // 浮层阴影

在 Umi 里配置主题: 如果你在使用 Umi,那么可以很方便地在项目根目录的 config/config.js(Umi)文件中 theme 字段进行主题配置。theme 可以配置为一个对象或文件路径

"theme": {"primary-color": "#1DA57A",},
// 或者 一个 js 文件:
"theme": "./theme.js",
Logo

为开发者提供学习成长、分享交流、生态实践、资源工具等服务,帮助开发者快速成长。

更多推荐