版本: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 (
{ width: 400, margin: '100px auto' }}>
{ marginTop: 20 }}>
);
}
}
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直接用拓展运算符展开。这个写法就很直观了,很方便查看
);
}
};
三、项目实战
我们基于 Redux 推出了自己的最佳实践 dva,以及可插拔的企业级应用框架 umi,推荐你在项目中使用
dva 是一个基于 Redux 的 轻量级数据流方案,这个有点像vuex,概念来自 elm,支持 side effects、热替换、动态加载、react-native、SSR 等,已在生产环境广泛应用
1、umiumi 则是一个可插拔的企业级 react 应用框架。umi 以路由为基础的,支持类 next.js 的约定式路由,以及各种进阶的路由功能,并以此进行功能扩展,比如支持路由级的按需加载。然后配以完善的插件体系,覆盖从源码到构建产物的每个生命周期,支持各种功能扩展和业务需求,同时提供 Umi UI 通过可视化辅助编程(VAP)提高开发体验和研发效率。
2、dva安装 Umi UI:
npm install umi -g
。还没看懂,后面再了解
dva 通过 model 的概念把一个领域的模型管理起来,包含同步更新 state 的 reducers,处理异步逻辑的 effects,订阅数据源的 subscriptions namespace 表示在全局 state 上的 keystate 是初始值,在这里是空数组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",
欢迎分享,转载请注明来源:内存溢出
评论列表(0条)