antd
是基于 Ant Design 设计体系的 React UI 组件库,主要用于研发企业级中后台产品。
# 特性
- 提炼自企业级中后台产品的交互语言和视觉风格。
- 开箱即用的高质量 React 组件。
- 使用 TypeScript 构建,提供完整的类型定义文件。
- 全链路开发和设计工具体系。
# 支持环境
# 版本
你可以订阅:https://github.com/ant-design/ant-design/releases.atom 来获得稳定版发布的通知。
# 安装
# 使用 npm 或 yarn 安装
我们推荐使用 npm 或 yarn 的方式进行开发,不仅可在开发环境轻松调试,也可放心地在生产环境打包部署使用,享受整个生态圈和工具链带来的诸多好处。
$ npm install antd --save
$ yarn add antd
如果你的网络环境不佳,推荐使用 cnpm。
# 浏览器引入
在浏览器中使用 script
和 link
标签直接引入文件,并使用全局变量 antd
。
我们在 npm 发布包内的 antd/dist
目录下提供了 antd.js
antd.css
以及 antd.min.js
antd.min.css
。你也可以通过 , 或 UNPKG 进行下载。
强烈不推荐使用已构建文件,这样无法按需加载,而且难以获得底层依赖模块的 bug 快速修复支持。
注意:3.0 之后引入 antd.js 前你需要自行引入 moment。
# 示例
import { DatePicker } from 'antd';
ReactDOM.render(<DatePicker />, mountNode);
引入样式:
import 'antd/dist/antd.css'; // or 'antd/dist/antd.less'
# 按需加载
注意:antd 默认支持基于 ES module 的 tree shaking,不使用以下插件也会有按需加载的效果。
下面两种方式都可以只加载用到的组件。
使用 babel-plugin-import(推荐)。
// .babelrc or babel-loader option { "plugins": [ ["import", { "libraryName": "antd", "libraryDirectory": "es", "style": "css" // `style: true` 会加载 less 文件 }] ] }
然后只需从 antd 引入模块即可,无需单独引入样式。等同于下面手动引入的方式。
// babel-plugin-import 会帮助你加载 JS 和 CSS import { DatePicker } from 'antd';
手动引入
import DatePicker from 'antd/es/date-picker'; // 加载 JS import 'antd/es/date-picker/style/css'; // 加载 CSS // import 'antd/es/date-picker/style'; // 加载 LESS
# 链接
- 首页
- 组件库
- Ant Design Pro
- 更新日志
- React 底层基础组件
- 移动端组件
- Ant Design 图标
- Ant Design 色彩
- Ant Design Pro 布局组件
- Ant Design Pro 区块集
- Dark Theme
- 首页模板集
- 动效
- 脚手架市场
- 设计规范速查手册
- 开发者说明
- 版本发布规则
- 常见问题
- CodeSandbox 模板 for bug reports
- Awesome Ant Design
- 定制主题
# 谁在使用
如果你的公司和产品使用了 Ant Design,欢迎到 这里 留言。
# 如何贡献
在任何形式的参与前,请先阅读 贡献者文档。如果你希望参与贡献,欢迎 Pull Request,或给我们 报告 Bug。
强烈推荐阅读 《提问的智慧》、《如何向开源社区提问题》 和 《如何有效地报告 Bug》、《如何向开源项目提交无法解答的问题》,更好的问题更容易获得帮助。
# 社区互助
如果您在使用的过程中碰到问题,可以通过下面几个途径寻求帮助,同时我们也鼓励资深用户通过下面的途径给新人提供帮助。
通过 Stack Overflow 或者 Segment Fault 提问时,建议加上 antd
标签。
快速上手 →