2016-03-31 14:17:09 +08:00
|
|
|
|
---
|
|
|
|
|
order: 0
|
2016-08-08 10:32:22 +08:00
|
|
|
|
title: Ant Design of React
|
2016-03-31 14:17:09 +08:00
|
|
|
|
---
|
2015-06-04 17:56:09 +08:00
|
|
|
|
|
2019-03-22 12:35:23 +08:00
|
|
|
|
`antd` 是基于 Ant Design 设计体系的 React UI 组件库,主要用于研发企业级中后台产品。
|
2015-07-23 21:18:36 +08:00
|
|
|
|
|
2015-08-22 20:51:10 +08:00
|
|
|
|
<div class="pic-plus">
|
2019-12-23 16:02:09 +08:00
|
|
|
|
<img width="150" src="https://gw.alipayobjects.com/zos/rmsportal/KDpgvguMpGfqaHPjicRK.svg"/>
|
2015-08-22 20:51:10 +08:00
|
|
|
|
<span>+</span>
|
2019-12-23 16:02:09 +08:00
|
|
|
|
<img width="160" src="https://gw.alipayobjects.com/zos/antfincdn/aPkFc8Sj7n/method-draw-image.svg"/>
|
2015-08-22 20:51:10 +08:00
|
|
|
|
</div>
|
2016-03-21 10:44:31 +08:00
|
|
|
|
|
2015-08-22 20:51:10 +08:00
|
|
|
|
<style>
|
|
|
|
|
.pic-plus > * {
|
2017-08-04 17:58:32 +08:00
|
|
|
|
display: inline-block !important;
|
2015-08-22 20:51:10 +08:00
|
|
|
|
vertical-align: middle;
|
|
|
|
|
}
|
|
|
|
|
.pic-plus span {
|
|
|
|
|
margin: 0 20px;
|
2020-10-25 16:51:09 +08:00
|
|
|
|
color: #aaa;
|
|
|
|
|
font-size: 30px;
|
2015-08-22 20:51:10 +08:00
|
|
|
|
}
|
|
|
|
|
</style>
|
|
|
|
|
|
2016-03-14 16:18:06 +08:00
|
|
|
|
---
|
2015-06-04 17:56:09 +08:00
|
|
|
|
|
2019-12-16 22:42:08 +08:00
|
|
|
|
## ✨ 特性
|
|
|
|
|
|
|
|
|
|
- 🌈 提炼自企业级中后台产品的交互语言和视觉风格。
|
|
|
|
|
- 📦 开箱即用的高质量 React 组件。
|
|
|
|
|
- 🛡 使用 TypeScript 开发,提供完整的类型定义文件。
|
|
|
|
|
- ⚙️ 全链路开发和设计工具体系。
|
|
|
|
|
- 🌍 数十个国际化语言支持。
|
|
|
|
|
- 🎨 深入每个细节的主题定制能力。
|
2015-07-08 20:08:19 +08:00
|
|
|
|
|
2020-05-15 17:18:55 +08:00
|
|
|
|
## 兼容环境
|
2017-01-12 17:57:04 +08:00
|
|
|
|
|
2022-11-16 15:02:18 +08:00
|
|
|
|
- 现代浏览器
|
2019-05-07 14:57:32 +08:00
|
|
|
|
- 支持服务端渲染。
|
2020-05-15 17:18:55 +08:00
|
|
|
|
- [Electron](https://www.electronjs.org/)
|
|
|
|
|
|
|
|
|
|
| [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt="IE / Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>IE / Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/opera/opera_48x48.png" alt="Opera" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Opera | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/electron/electron_48x48.png" alt="Electron" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Electron |
|
|
|
|
|
| --- | --- | --- | --- | --- | --- |
|
2022-11-16 15:02:18 +08:00
|
|
|
|
| Edge | last 2 versions | last 2 versions | last 2 versions | last 2 versions | last 2 versions |
|
2020-05-15 17:18:55 +08:00
|
|
|
|
|
|
|
|
|
对于 IE 系列浏览器,需要提供相应的 Polyfill 支持,建议使用 [@babel/preset-env](https://babeljs.io/docs/en/babel-preset-env) 来解决浏览器兼容问题。如果你在使用 [umi](http://umijs.org/),可以直接使用 [targets](https://umijs.org/zh/config/#targets) 配置。
|
|
|
|
|
|
2022-11-16 16:13:38 +08:00
|
|
|
|
> `antd@2.0` 之后不再支持 IE8。 `antd@4.0` 之后不再支持 React 15 和 IE9/10。 `antd@5.0` 之后不再支持 IE。
|
2017-01-12 17:57:04 +08:00
|
|
|
|
|
|
|
|
|
## 版本
|
|
|
|
|
|
|
|
|
|
- 稳定版:[![npm package](https://img.shields.io/npm/v/antd.svg?style=flat-square)](https://www.npmjs.org/package/antd)
|
|
|
|
|
|
2020-05-14 14:38:57 +08:00
|
|
|
|
你可以订阅:https://github.com/ant-design/ant-design/releases.atom 或 https://app.releasly.co/sites/ant-design/ant-design 来获得版本发布的通知。
|
2017-01-12 17:57:04 +08:00
|
|
|
|
|
2016-02-02 18:24:49 +08:00
|
|
|
|
## 安装
|
|
|
|
|
|
2017-03-02 11:24:44 +08:00
|
|
|
|
### 使用 npm 或 yarn 安装
|
2017-01-12 17:57:04 +08:00
|
|
|
|
|
2017-03-02 11:24:44 +08:00
|
|
|
|
**我们推荐使用 npm 或 yarn 的方式进行开发**,不仅可在开发环境轻松调试,也可放心地在生产环境打包部署使用,享受整个生态圈和工具链带来的诸多好处。
|
2017-01-12 17:57:04 +08:00
|
|
|
|
|
2016-02-23 01:03:50 +08:00
|
|
|
|
```bash
|
2016-12-11 18:28:46 +08:00
|
|
|
|
$ npm install antd --save
|
2016-02-02 18:24:49 +08:00
|
|
|
|
```
|
2015-07-03 18:06:47 +08:00
|
|
|
|
|
2017-01-12 17:57:04 +08:00
|
|
|
|
```bash
|
2017-03-02 11:24:44 +08:00
|
|
|
|
$ yarn add antd
|
2017-01-12 17:57:04 +08:00
|
|
|
|
```
|
|
|
|
|
|
2017-03-02 11:24:44 +08:00
|
|
|
|
如果你的网络环境不佳,推荐使用 [cnpm](https://github.com/cnpm/cnpm)。
|
|
|
|
|
|
2017-01-12 17:57:04 +08:00
|
|
|
|
### 浏览器引入
|
|
|
|
|
|
2017-03-03 13:48:22 +08:00
|
|
|
|
在浏览器中使用 `script` 和 `link` 标签直接引入文件,并使用全局变量 `antd`。
|
2017-01-12 17:57:04 +08:00
|
|
|
|
|
2018-09-11 14:15:48 +08:00
|
|
|
|
我们在 npm 发布包内的 `antd/dist` 目录下提供了 `antd.js` `antd.css` 以及 `antd.min.js` `antd.min.css`。你也可以通过 [![CDNJS](https://img.shields.io/cdnjs/v/antd.svg?style=flat-square)](https://cdnjs.com/libraries/antd),[![](https://data.jsdelivr.com/v1/package/npm/antd/badge)](https://www.jsdelivr.com/package/npm/antd) 或 [UNPKG](https://unpkg.com/antd/dist/) 进行下载。
|
2017-01-12 17:57:04 +08:00
|
|
|
|
|
2017-03-03 13:48:22 +08:00
|
|
|
|
> **强烈不推荐使用已构建文件**,这样无法按需加载,而且难以获得底层依赖模块的 bug 快速修复支持。
|
2017-01-12 17:57:04 +08:00
|
|
|
|
|
2022-06-13 14:03:43 +08:00
|
|
|
|
> 注意:`antd.js` 和 `antd.min.js` 依赖 `react/react-dom/dayjs`,请确保提前引入这些文件。
|
2017-12-26 11:53:03 +08:00
|
|
|
|
|
2015-11-17 16:33:47 +08:00
|
|
|
|
## 示例
|
2015-11-08 19:09:28 +08:00
|
|
|
|
|
2015-07-03 18:06:47 +08:00
|
|
|
|
```jsx
|
2015-12-10 16:12:10 +08:00
|
|
|
|
import { DatePicker } from 'antd';
|
2020-04-24 10:40:23 +08:00
|
|
|
|
|
2015-12-10 16:12:10 +08:00
|
|
|
|
ReactDOM.render(<DatePicker />, mountNode);
|
2015-07-03 18:06:47 +08:00
|
|
|
|
```
|
2015-06-15 18:16:21 +08:00
|
|
|
|
|
2015-12-08 18:05:01 +08:00
|
|
|
|
引入样式:
|
|
|
|
|
|
2015-11-14 21:38:31 +08:00
|
|
|
|
```jsx
|
2019-05-07 14:57:32 +08:00
|
|
|
|
import 'antd/dist/antd.css'; // or 'antd/dist/antd.less'
|
2015-11-14 21:38:31 +08:00
|
|
|
|
```
|
|
|
|
|
|
2017-03-02 00:34:18 +08:00
|
|
|
|
### 按需加载
|
2015-12-08 18:05:01 +08:00
|
|
|
|
|
2020-05-15 17:18:55 +08:00
|
|
|
|
`antd` 的 JS 代码默认支持基于 ES modules 的 tree shaking。
|
2017-03-02 00:34:18 +08:00
|
|
|
|
|
2020-05-15 17:18:55 +08:00
|
|
|
|
### TypeScript
|
2017-03-02 00:34:18 +08:00
|
|
|
|
|
2020-05-15 17:18:55 +08:00
|
|
|
|
`antd` 使用 TypeScript 进行书写并提供了完整的定义文件。(不要引用 `@types/antd`)。
|
2015-12-08 18:05:01 +08:00
|
|
|
|
|
2015-06-15 18:16:21 +08:00
|
|
|
|
## 链接
|
2015-06-04 17:56:09 +08:00
|
|
|
|
|
2022-08-25 16:14:43 +08:00
|
|
|
|
- [首页](/index)
|
2020-05-31 19:10:12 +08:00
|
|
|
|
- [组件库](/components/overview)
|
2019-07-01 11:05:17 +08:00
|
|
|
|
- [Ant Design Pro](https://pro.ant.design/)
|
2020-05-30 14:55:41 +08:00
|
|
|
|
- [Ant Design Charts](https://charts.ant.design)
|
2016-12-12 20:44:40 +08:00
|
|
|
|
- [更新日志](/changelog)
|
2017-03-12 15:20:25 +08:00
|
|
|
|
- [React 底层基础组件](http://react-component.github.io/)
|
2016-07-29 13:52:05 +08:00
|
|
|
|
- [移动端组件](http://mobile.ant.design)
|
2019-07-01 11:05:17 +08:00
|
|
|
|
- [Ant Design 图标](https://github.com/ant-design/ant-design-icons)
|
|
|
|
|
- [Ant Design 色彩](https://github.com/ant-design/ant-design-colors)
|
|
|
|
|
- [Ant Design Pro 布局组件](https://github.com/ant-design/ant-design-pro-layout)
|
|
|
|
|
- [Ant Design Pro 区块集](https://github.com/ant-design/pro-blocks)
|
|
|
|
|
- [Dark Theme](https://github.com/ant-design/ant-design-dark-theme)
|
|
|
|
|
- [首页模板集](https://landing.ant.design)
|
2016-11-14 11:08:26 +08:00
|
|
|
|
- [动效](https://motion.ant.design)
|
2019-07-01 11:05:17 +08:00
|
|
|
|
- [脚手架市场](http://scaffold.ant.design)
|
2017-02-15 13:50:03 +08:00
|
|
|
|
- [设计规范速查手册](https://github.com/ant-design/ant-design/wiki/Ant-Design-%E8%AE%BE%E8%AE%A1%E5%9F%BA%E7%A1%80%E7%AE%80%E7%89%88)
|
2016-11-14 11:08:26 +08:00
|
|
|
|
- [开发者说明](https://github.com/ant-design/ant-design/wiki/Development)
|
|
|
|
|
- [版本发布规则](https://github.com/ant-design/ant-design/wiki/%E8%BD%AE%E5%80%BC%E8%A7%84%E5%88%99%E5%92%8C%E7%89%88%E6%9C%AC%E5%8F%91%E5%B8%83%E6%B5%81%E7%A8%8B)
|
2018-09-16 15:34:58 +08:00
|
|
|
|
- [常见问题](/docs/react/faq)
|
2017-11-29 20:27:52 +08:00
|
|
|
|
- [CodeSandbox 模板](https://u.ant.design/codesandbox-repro) for bug reports
|
2016-08-11 16:45:15 +08:00
|
|
|
|
- [Awesome Ant Design](https://github.com/websemantics/awesome-ant-design)
|
2017-02-09 17:53:34 +08:00
|
|
|
|
- [定制主题](/docs/react/customize-theme)
|
2020-03-25 18:01:24 +08:00
|
|
|
|
- [成为社区协作成员](https://github.com/ant-design/ant-design/wiki/Collaborators#how-to-apply-for-being-a-collaborator)
|
2015-06-15 18:18:42 +08:00
|
|
|
|
|
2015-07-03 18:06:47 +08:00
|
|
|
|
## 谁在使用
|
|
|
|
|
|
2017-11-29 20:27:52 +08:00
|
|
|
|
- [蚂蚁金服](http://www.antfin.com/)
|
2016-10-07 21:10:05 +08:00
|
|
|
|
- [阿里巴巴](http://www.alibaba.com/)
|
2017-10-12 14:09:17 +08:00
|
|
|
|
- [腾讯](http://www.tencent.com)
|
|
|
|
|
- [百度](http://www.baidu.com)
|
2016-10-07 21:10:05 +08:00
|
|
|
|
- [口碑](http://www.koubei.com/)
|
|
|
|
|
- [美团](http://www.meituan.com)
|
|
|
|
|
- [滴滴](http://www.xiaojukeji.com/)
|
2017-10-12 14:09:17 +08:00
|
|
|
|
- [饿了么](https://www.ele.me/)
|
2015-06-15 18:18:42 +08:00
|
|
|
|
|
2015-11-04 20:30:50 +08:00
|
|
|
|
> 如果你的公司和产品使用了 Ant Design,欢迎到 [这里](https://github.com/ant-design/ant-design/issues/477) 留言。
|
|
|
|
|
|
2015-06-15 18:18:42 +08:00
|
|
|
|
## 如何贡献
|
|
|
|
|
|
2017-04-02 14:03:42 +08:00
|
|
|
|
在任何形式的参与前,请先阅读 [贡献者文档](https://github.com/ant-design/ant-design/blob/master/.github/CONTRIBUTING.md)。如果你希望参与贡献,欢迎 [Pull Request](https://github.com/ant-design/ant-design/pulls),或给我们 [报告 Bug](http://new-issue.ant.design/)。
|
2016-06-18 16:05:14 +08:00
|
|
|
|
|
2017-06-01 14:12:26 +08:00
|
|
|
|
> 强烈推荐阅读 [《提问的智慧》](https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way)、[《如何向开源社区提问题》](https://github.com/seajs/seajs/issues/545) 和 [《如何有效地报告 Bug》](http://www.chiark.greenend.org.uk/%7Esgtatham/bugs-cn.html)、[《如何向开源项目提交无法解答的问题》](https://zhuanlan.zhihu.com/p/25795393),更好的问题更容易获得帮助。
|
2016-10-19 12:19:30 +08:00
|
|
|
|
|
|
|
|
|
## 社区互助
|
|
|
|
|
|
|
|
|
|
如果您在使用的过程中碰到问题,可以通过下面几个途径寻求帮助,同时我们也鼓励资深用户通过下面的途径给新人提供帮助。
|
|
|
|
|
|
2020-12-09 16:07:23 +08:00
|
|
|
|
通过 GitHub Discussions 提问时,建议使用 `Q&A` 标签。
|
|
|
|
|
|
2016-10-20 14:49:51 +08:00
|
|
|
|
通过 Stack Overflow 或者 Segment Fault 提问时,建议加上 `antd` 标签。
|
2016-10-19 14:04:46 +08:00
|
|
|
|
|
2020-12-09 16:07:23 +08:00
|
|
|
|
1. [GitHub Discussions](https://github.com/ant-design/ant-design/discussions)
|
|
|
|
|
2. [<img alt="Stack Overflow" src="https://cdn.sstatic.net/Sites/stackoverflow/company/img/logos/so/so-logo.svg?v=2bb144720a66" width="140" />](http://stackoverflow.com/questions/tagged/antd)(English)
|
|
|
|
|
3. [<img alt="Segment Fault" src="https://gw.alipayobjects.com/zos/rmsportal/hfYFfCvHTQTUKntlJbMF.svg" width="100" />](https://segmentfault.com/t/antd)(中文)
|