UNPKG

9.25 kBMarkdownView Raw
1<p align="center">
2 <a href="https://ant.design">
3 <img width="200" src="https://gw.alipayobjects.com/zos/rmsportal/KDpgvguMpGfqaHPjicRK.svg">
4 </a>
5</p>
6
7<h1 align="center">Ant Design</h1>
8
9<div align="center">
10
11An enterprise-class UI design language and React UI library.
12
13[![CI status][github-action-image]][github-action-url] [![codecov][codecov-image]][codecov-url] [![NPM version][npm-image]][npm-url] [![NPM downloads][download-image]][download-url]
14
15[![david deps][david-image]][david-url] [![david devDeps][david-dev-image]][david-dev-url] [![Total alerts][lgtm-image]][lgtm-url] [![][bundlesize-js-image]][unpkg-js-url] [![][bundlesize-css-image]][unpkg-css-url]
16
17[![Follow Twitter][twitter-image]][twitter-url] [![FOSSA Status][fossa-image]][fossa-url] [![Discussions][discussions-image]][discussions-url] [![Issues need help][help-wanted-image]][help-wanted-url]
18
19[npm-image]: http://img.shields.io/npm/v/antd.svg?style=flat-square
20[npm-url]: http://npmjs.org/package/antd
21[github-action-image]: https://github.com/ant-design/ant-design/workflows/%E2%9C%85%20test/badge.svg
22[github-action-url]: https://github.com/ant-design/ant-design/actions?query=workflow%3A%22%E2%9C%85+test%22
23[codecov-image]: https://img.shields.io/codecov/c/github/ant-design/ant-design/master.svg?style=flat-square
24[codecov-url]: https://codecov.io/gh/ant-design/ant-design/branch/master
25[david-image]: https://img.shields.io/david/ant-design/ant-design?style=flat-square
26[david-dev-url]: https://david-dm.org/ant-design/ant-design?type=dev
27[david-dev-image]: https://img.shields.io/david/dev/ant-design/ant-design?style=flat-square
28[david-url]: https://david-dm.org/ant-design/ant-design
29[download-image]: https://img.shields.io/npm/dm/antd.svg?style=flat-square
30[download-url]: https://npmjs.org/package/antd
31[lgtm-image]: https://flat.badgen.net/lgtm/alerts/g/ant-design/ant-design
32[lgtm-url]: https://lgtm.com/projects/g/ant-design/ant-design/alerts/
33[fossa-image]: https://app.fossa.io/api/projects/git%2Bgithub.com%2Fant-design%2Fant-design.svg?type=shield
34[fossa-url]: https://app.fossa.io/projects/git%2Bgithub.com%2Fant-design%2Fant-design?ref=badge_shield
35[help-wanted-image]: https://flat.badgen.net/github/label-issues/ant-design/ant-design/help%20wanted/open
36[help-wanted-url]: https://github.com/ant-design/ant-design/issues?q=is%3Aopen+is%3Aissue+label%3A%22help+wanted%22
37[twitter-image]: https://img.shields.io/twitter/follow/AntDesignUI.svg?label=Ant%20Design&style=social
38[twitter-url]: https://twitter.com/AntDesignUI
39[discussions-image]: https://img.shields.io/badge/discussions-on%20github-blue?style=flat-square
40[discussions-url]: https://github.com/ant-design/ant-design/discussions
41[bundlesize-js-image]: https://img.badgesize.io/https:/unpkg.com/antd/dist/antd.min.js?label=antd.min.js&compression=gzip&style=flat-square
42[bundlesize-css-image]: https://img.badgesize.io/https:/unpkg.com/antd/dist/antd.min.css?label=antd.min.css&compression=gzip&style=flat-square
43[unpkg-js-url]: https://unpkg.com/browse/antd/dist/antd.min.js
44[unpkg-css-url]: https://unpkg.com/browse/antd/dist/antd.min.css
45
46</div>
47
48[![](https://gw.alipayobjects.com/mdn/rms_08e378/afts/img/A*Yl83RJhUE7kAAAAAAAAAAABkARQnAQ)](https://ant.design)
49
50English | [Português](./README-pt_BR.md) | [简体中文](./README-zh_CN.md) | [Українською](./README-uk_UA.md)
51
52## ✨ Features
53
54- 🌈 Enterprise-class UI designed for web applications.
55- 📦 A set of high-quality React components out of the box.
56- 🛡 Written in TypeScript with predictable static types.
57- ⚙️ Whole package of design resources and development tools.
58- 🌍 Internationalization support for dozens of languages.
59- 🎨 Powerful theme customization in every detail.
60
61## 🖥 Environment Support
62
63- Modern browsers and Internet Explorer 11 (with [polyfills](https://stackoverflow.com/questions/57020976/polyfills-in-2019-for-ie11))
64- Server-side Rendering
65- [Electron](https://www.electronjs.org/)
66
67| [<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/electron/electron_48x48.png" alt="Electron" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)<br>Electron |
68| --- | --- | --- | --- | --- |
69| IE11, Edge | last 2 versions | last 2 versions | last 2 versions | last 2 versions |
70
71## 📦 Install
72
73```bash
74npm install antd
75```
76
77```bash
78yarn add antd
79```
80
81## 🔨 Usage
82
83```jsx
84import { Button, DatePicker } from 'antd';
85
86const App = () => (
87 <>
88 <Button type="primary">PRESS ME</Button>
89 <DatePicker placeholder="select date" />
90 </>
91);
92```
93
94And import style manually:
95
96```jsx
97import 'antd/dist/antd.css'; // or 'antd/dist/antd.less'
98```
99
100### TypeScript
101
102`antd` is written in TypeScript with complete definitions, check [Use in TypeScript](https://ant.design/docs/react/use-in-typescript) to get started.
103
104## 🌍 Internationalization
105
106Dozens of languages supported in `antd`, see [i18n](https://ant.design/docs/react/i18n).
107
108## 🔗 Links
109
110- [Home page](https://ant.design/)
111- [Components Overview](https://ant.design/components/overview)
112- [Ant Design Pro](http://pro.ant.design/)
113- [Change Log](CHANGELOG.en-US.md)
114- [rc-components](http://react-component.github.io/)
115- [Mobile UI](http://mobile.ant.design)
116- [Ant Design Pro Components](https://procomponents.ant.design)
117- [Ant Design Charts](https://charts.ant.design)
118- [Ant Design Icons](https://github.com/ant-design/ant-design-icons)
119- [Ant Design Colors](https://github.com/ant-design/ant-design-colors)
120- [Landing Pages](https://landing.ant.design)
121- [Motion](https://motion.ant.design)
122- [Scaffold Market](http://scaffold.ant.design)
123- [Developer Instruction](https://github.com/ant-design/ant-design/wiki/Development)
124- [Versioning Release Note](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)
125- [FAQ](https://ant.design/docs/react/faq)
126- [CodeSandbox Template](https://u.ant.design/codesandbox-repro) for bug reports
127- [Customize Theme](https://ant.design/docs/react/customize-theme)
128- [How to Apply for Being A Collaborator](https://github.com/ant-design/ant-design/wiki/Collaborators#how-to-apply-for-being-a-collaborator)
129
130## ⌨️ Development
131
132Use Gitpod, a free online dev environment for GitHub.
133
134[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/ant-design/ant-design)
135
136Or clone locally:
137
138```bash
139$ git clone git@github.com:ant-design/ant-design.git
140$ cd ant-design
141$ npm install
142$ npm start
143```
144
145Open your browser and visit http://127.0.0.1:8001 , see more at [Development](https://github.com/ant-design/ant-design/wiki/Development).
146
147## 🤝 Contributing [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
148
149Read our [contributing guide](https://ant.design/docs/react/contributing) and let's build a better antd together.
150
151We welcome all contributions. Please read our [CONTRIBUTING.md](https://github.com/ant-design/ant-design/blob/master/.github/CONTRIBUTING.md) first. You can submit any ideas as [pull requests](https://github.com/ant-design/ant-design/pulls) or as [GitHub issues](https://github.com/ant-design/ant-design/issues). If you'd like to improve code, check out the [Development Instructions](https://github.com/ant-design/ant-design/wiki/Development) and have a good time! :)
152
153If you are a collaborator, please follow our [Pull Request principle](https://github.com/ant-design/ant-design/wiki/PR-principle) to create a Pull Request with [collaborator template](https://github.com/ant-design/ant-design/compare?expand=1&template=collaborator.md).
154
155[![Let's fund issues in this repository](https://issuehunt.io/static/embed/issuehunt-button-v1.svg)](https://issuehunt.io/repos/34526884)
156
157## ❤️ Sponsors and Backers [![](https://opencollective.com/ant-design/tiers/sponsors/badge.svg?label=Sponsors&color=brightgreen)](https://opencollective.com/ant-design#support) [![](https://opencollective.com/ant-design/tiers/backers/badge.svg?label=Backers&color=brightgreen)](https://opencollective.com/ant-design#support)
158
159[![](https://opencollective.com/ant-design/tiers/sponsors.svg?avatarHeight=36)](https://opencollective.com/ant-design#support)
160
161[![](https://opencollective.com/ant-design/tiers/backers.svg?avatarHeight=36)](https://opencollective.com/ant-design#support)