ant.design初探

第一部分：前言

　推荐网站： https://ant.design/docs/spec/introduce-cn

　　ant.design是基于react开发的一个解放ui和前端的工具，它提供了一致的设计方便我们快速开发和减少不必要的设计与代码，很多实用react框架的开发者都已经在使用ant.design了，且其在github上的star数也早已上万，足见其火热程度。

　　ant.design的目的也在于提高用户、开发者等多方的体验与幸福感。

　　ant.design设计很精妙，vue的iview就是模仿ant.design来实现的。

　　既然要使用ant.design，我们不妨了解其设计原则是否是我们想要的，对于设计，我了解的最多的便是对比、对齐、亲密性、重复性，而ant.design也很好的实现了这些规则，并在此基础山践行了更多的想法。

直接了当　『需要在哪里输出，就要允许在哪里输入』。这就是直接操作的原理。eg：不要为了编辑内容而打开另一个页面，应该直接在上下文中实现编辑。
足不出户
简化交互 --- 如悬停时出现工具，qq在这里做的很好。
提供邀请
巧用过渡

　　https://ant.design/docs/spec/colors-cn

第二部分：使用(引入css不好的方法)

　　ant.design 使用起来非常简单。

　　第一步：

npm install antd --save

　　第二步（选择性的）：

将node_modules下面的dist下面的 antd.min.css 取出放在静态文件中，在head中link引入。

　　第三步，开始使用：

在某个组件的上方：

import {message} from 'antd'

然后在需要的时候使用： message.error('错误'); message.success('登录成功！'); 类似的使用即可。

　　如果我们仅仅是js，css完全自己写，那么上面的就足够了，但是，如果我们希望使用 ant.design 提供的css，那么我们就需要把css文件取出放在静态文件中，并在html的head中引用了。

　　注意：在使用的时候引入的css中还使用了css初始化，如下所示：

View Code

　　其实，有些时候，使用 ant.design 没有办法满足我们的样式要求，所以，我们就需要使用 !important 来先找到样式然后强制来覆盖，但这绝对不是最佳实践。

　　 下面我们介绍一种比较好用的方法。

第三部分：使用（引入CSS较好的做法）、解析

　　之前我们引入css的方式是直接把整个css文件引入，这时一种不好的做法，因为在一个项目中也许我们仅仅是使用其中的几个组件，所以引入所有的css是完全没有必要的。

　　那么解决办法是什么呢?

　　拿 message 举例，我们可以在node_modules下的antd下的message中看到如下结构：

　　即，这里不仅仅有 index.js 和 index.d.ts 两者构成的js组件，还有一个 style 文件夹，这个文件夹中描述了对组件的样式。我们是可以直接从这里引入的。

　　比如，我们需要引入 message 的组件和相关的css，可以像下面这样：

import { message } from 'antd';
require('antd/lib/message/style')

　　当然也可以不用require，用 import 也是可以的，如下所示：

import { message } from 'antd';
import 'antd/lib/message/style'

　　对于第一条语句，很容易理解，即引入了message的js组件。

　　对于第二条语句，由于 style 是一个文件夹，根据规则，是默认寻找其中的 index.js ，我们看看 index.js 中的内容是什么？

'use strict';

require('../../style/index.less');

require('./index.less');

　　其中的 ../../style/index.less 是ant.design的主题配置，比如，我们可以配置它的整体的颜色、文字大小等等。

　　另外，就是引入了这个style下面的 index.less，比如message下的less是这样的：

@import "../../style/themes/default";

@message-prefix-cls: ~"@{ant-prefix}-message";

.@{message-prefix-cls} {
  font-size: 16px;
  position: fixed;
  z-index: @zindex-message;
  width: 100%;
  top: 0px;
  left: 0;
  pointer-events: none;

  &-notice {
    padding: 16px;
    padding-top: 16px;
    text-align: center;
    &:first-child {
      margin-top: -8px;
    }
  }

  &-notice-content {
    padding: 16px 32px;
    border-radius: @border-radius-base;
    box-shadow: @shadow-2;
    background: @component-background;
    display: inline-block;
    pointer-events: all;
  }

  &-success .@{iconfont-css-prefix} {
    color: @success-color;
  }

  &-error .@{iconfont-css-prefix} {
    color: @error-color;
  }

  &-warning .@{iconfont-css-prefix} {
    color: @warning-color;
  }

  &-info .@{iconfont-css-prefix},
  &-loading .@{iconfont-css-prefix} {
    color: @info-color;
  }

  .@{iconfont-css-prefix} {
    margin-right: 8px;
    font-size: @font-size-lg;
    top: 1px;
    position: relative;
  }

  &-notice.move-up-leave.move-up-leave-active {
    animation-name: MessageMoveOut;
    overflow: hidden;
    animation-duration: 0.3s;
  }
}

@keyframes MessageMoveOut {
  0% {
    opacity: 1;
    max-height: 150px;
    padding: 8px;
  }
  100% {
    opacity: 0;
    max-height: 0;
    padding: 0;
  }
}

　　我们如果觉得样式不合适，只需要在这个less文件中直接修改就可以了。这样就会经过编译在页面上显示出效果。

　　那么其中的js文件又代表什么呢？即一个是 index.js，另外一个是 index.d.ts，这两个文件就描述了这个 message 组件。我们首先来看看 index.js 内容吧，直接在代码中注释解释：'use strict';// 这句声明表示这个文件是一个可以被引入的模块。

Object.defineProperty(exports, "__esModule", {
    value: true
});
 
// 引入react
var _react = require('react');

var _react2 = _interopRequireDefault(_react);

// 引入 rcNotification
var _rcNotification = require('rc-notification');

var _rcNotification2 = _interopRequireDefault(_rcNotification);

// 引入 icon 组件，即通知正确、错误时的图标icon
var _icon = require('../icon');

var _icon2 = _interopRequireDefault(_icon);

function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { 'default': obj }; }

// 通知的toast默认时间设置为3s
var defaultDuration = 3;

// 这里的void后面可以是一个表达式，但是这个表达式的返回结果永远是undefined。 
var defaultTop = void 0;
var messageInstance = void 0;
var key = 1;

// 这里应该是组件的前缀
var prefixCls = 'ant-message';
var getContainer = void 0;

// 获取一个 message 实例
function getMessageInstance() {
    messageInstance = messageInstance || _rcNotification2['default'].newInstance({
        prefixCls: prefixCls,
        transitionName: 'move-up',
        style: { top: defaultTop },
        getContainer: getContainer
    });
    return messageInstance;
}


function notice(content) {
    var duration = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : defaultDuration;
    var type = arguments[2];
    var onClose = arguments[3];

　　// 定义icon的样式
    var iconType = {
        info: 'info-circle',
        success: 'check-circle',
        error: 'cross-circle',
        warning: 'exclamation-circle',
        loading: 'loading'
    }[type];
　　
　　//  在notice(通知)的时候创建一个实例
var instance = getMessageInstance();
    instance.notice({
        key: key,
        duration: duration,
        style: {},
        content: _react2['default'].createElement(
            'div',
            { className: prefixCls + '-custom-content ' + prefixCls + '-' + type },
            _react2['default'].createElement(_icon2['default'], { type: iconType }),
            _react2['default'].createElement(
                'span',
                null,
                content
            )
        ),
        onClose: onClose
    });
    return function () {
        var target = key++;
        return function () {
            instance.removeNotice(target);
        };
    }();
}

// 关键： 暴露出去的方法，就是我们在组件中引入message时可以直接调用的方法。 
exports['default'] = {
    info: function info(content, duration, onClose) {
        return notice(content, duration, 'info', onClose);
    },
    success: function success(content, duration, onClose) {
        return notice(content, duration, 'success', onClose);
    },
    error: function error(content, duration, onClose) {
        return notice(content, duration, 'error', onClose);
    },

    // Departed usage, please use warning()
    warn: function warn(content, duration, onClose) {
        return notice(content, duration, 'warning', onClose);
    },
    warning: function warning(content, duration, onClose) {
        return notice(content, duration, 'warning', onClose);
    },
    loading: function loading(content, duration, onClose) {
        return notice(content, duration, 'loading', onClose);
    },
    config: function config(options) {
        if (options.top !== undefined) {
            defaultTop = options.top;
            messageInstance = null; // delete messageInstance for new defaultTop
        }
        if (options.duration !== undefined) {
            　　= options.duration;
        }
        if (options.prefixCls !== undefined) {
            prefixCls = options.prefixCls;
        }
        if (options.getContainer !== undefined) {
            getContainer = options.getContainer;
        }
    },
    destroy: function destroy() {
        if (messageInstance) {
            messageInstance.destroy();
            messageInstance = null;
        }
    }
};
module.exports = exports['default'];

　　可以看到，这些方法，如 message.info() 、message.warning()都可以接收三个参数

希望通知的信息
这个通知信息所持续的时间
当通知结束之后的回调函数

　 ok！下面我们来看看 index.d.ts 文件：

/// <reference types="react" />
import React from 'react';
export declare type ConfigOnClose = () => void;
export interface ConfigOptions {
    top?: number;
    duration?: number;
    prefixCls?: string;
    getContainer?: () => HTMLElement;
}
declare const _default: {
    info(content: React.ReactNode, duration?: number | undefined, onClose?: ConfigOnClose | undefined): () => void;
    success(content: React.ReactNode, duration?: number | undefined, onClose?: ConfigOnClose | undefined): () => void;
    error(content: React.ReactNode, duration?: number | undefined, onClose?: ConfigOnClose | undefined): () => void;
    warn(content: React.ReactNode, duration?: number | undefined, onClose?: ConfigOnClose | undefined): () => void;
    warning(content: React.ReactNode, duration?: number | undefined, onClose?: ConfigOnClose | undefined): () => void;
    loading(content: React.ReactNode, duration?: number | undefined, onClose?: ConfigOnClose | undefined): () => void;
    config(options: ConfigOptions): void;
    destroy(): void;
};
export default _default;

　　哈哈，看不懂，等看完了ts回来讲解。

第四部分: ant.design的栅格系统

　　在 ant.design 中，对于栅格系统的设计和bootstrap中的设计是极其类似的，核心概念为： Row一定是最外层的， Col一定是分布在Row中的，内容一定是在Col里的，当然，在Col中我们还可以嵌套Row，在antd中， Col被分成了24分（与bootstrap的12份是类似的）。

　　在Col中，我们可以使用span={number}来制定一个Col的宽度，具体的做法是使用百分比来划分，如 span={4} 的占满，那么每一份就是 16.6667% , 如果 span={12} 占满，那么每一份就是 50%。。。。依次类推。

　　另外，在Col中我们还可以使用offset来进行便宜，正值为向右偏移，使用的原理是 margin-left 或者是 margin-right。

　　我们还可以在Row中设置 gutter={number } 这个值就是栅格的间距，具体实现原理就是对div根据百分比来划分，然后在div内容使用padding，这时content肯定是减小的。

　除此之外，还可以在 Col 中设置 push={number} 以及 pull={number}，实现原理也非常简单，就是使用元素的 position: relative；值，通过 left=百分比;以及right=百分比；这样就可以实现pull 和 push 就可以了。

　　当然，我们还可以使用 Row 的flex进行布局，这种布局方式只需要在 Row 上设置 type="flex"，就可以设置竖直和水平对齐方式了。

　　竖直对齐方式：

align="top" 向上对齐
align="middle" 中间对齐
alegn="bottom" 向下对齐

　　水平对其方式：

justify="start" 左对齐
justify='end' 右对齐
justify="center" 中间对齐
justify='space-between' 中间
jusify="space-around" 中间

　　这些flex布局的原理也很简单，就是直接使用css3的flex，如align-items以及 justify-content。

　　另外， ant.design也是支持响应式布局的。和bootstrap一样。

　　注意点：

一般在我们制作表格的时候，可以使用 ant.design 的栅格系统，比如，左边是说明性文字，右边是选择项或者是input框。整体使用flex布局即可。左边的给一个固定的宽度，如span={4}，右边的就是span={24}了，并且在右边，如果是input框就比较好解决，如果是几个框，我们需要分开排列，就需要使用一个 <Row>，然后设置flex，其中justify应该是space-between，而能是start、end、center或者是 space-around。因为对于 start、end、center，会使得几个框都会贴的很紧（除非是我们在其中再添加一个div，然后添加一个padding，这样才能做到分割)，那么space-between和space-around的区别是什么？前者是两边贴近然后中间有空位置，而后者是两边的距离为中间padding的一般。
另外，我们也是可以用gutter的，但是最好不用，因为，gutter在两边也会有间距，这样对于对齐的控制非常麻烦。

转载自:https://www.cnblogs.com/zhuzhenwei918/p/7233560.html

第一部分： 前言

第二部分： 使用(引入css不好的方法)

第三部分： 使用（引入CSS较好的做法）、解析

第四部分: ant.design的栅格系统

水平对其方式：

注意点：

猜你喜欢

第一部分：前言

第二部分：使用(引入css不好的方法)

第三部分：使用（引入CSS较好的做法）、解析

　　水平对其方式：

　　注意点：