mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-01 06:49:32 +08:00
119 lines
6.7 KiB
Markdown
119 lines
6.7 KiB
Markdown
<p align="center">
|
|
<a href="http://ant.design">
|
|
<img width="200" src="https://gw.alipayobjects.com/zos/rmsportal/KDpgvguMpGfqaHPjicRK.svg">
|
|
</a>
|
|
</p>
|
|
|
|
<h1 align="center">Ant Design</h1>
|
|
|
|
<div align="center">
|
|
|
|
一套企业级的 UI 设计语言和 React 实现。
|
|
|
|
[![](https://img.shields.io/travis/ant-design/ant-design/master.svg?style=flat-square)](https://travis-ci.org/ant-design/ant-design)
|
|
[![CircleCI Status](https://circleci.com/gh/ant-design/ant-design.svg?style=svg)](https://circleci.com/gh/ant-design/ant-design/)
|
|
[![Codecov](https://img.shields.io/codecov/c/github/ant-design/ant-design/master.svg?style=flat-square)](https://codecov.io/gh/ant-design/ant-design/branch/master)
|
|
[![Dependencies](https://img.shields.io/david/ant-design/ant-design.svg)](https://david-dm.org/ant-design/ant-design)
|
|
[![DevDependencies](https://img.shields.io/david/dev/ant-design/ant-design.svg)](https://david-dm.org/ant-design/ant-design?type=dev)
|
|
|
|
[![npm package](https://img.shields.io/npm/v/antd.svg?style=flat-square)](https://www.npmjs.org/package/antd)
|
|
[![NPM downloads](http://img.shields.io/npm/dm/antd.svg?style=flat-square)](http://www.npmtrends.com/antd)
|
|
[![Percentage of issues still open](http://isitmaintained.com/badge/open/ant-design/ant-design.svg)](http://isitmaintained.com/project/ant-design/ant-design "Percentage of issues still open")
|
|
[![Gitter](https://badges.gitter.im/ant-design/ant-design-english.svg)](https://gitter.im/ant-design/ant-design-english?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge) (English)
|
|
[![Join the chat at https://gitter.im/ant-design/ant-design](https://img.shields.io/gitter/room/ant-design/ant-design.svg?style=flat-square)](https://gitter.im/ant-design/ant-design?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)(中文)
|
|
|
|
</div>
|
|
|
|
[English](./README.md) | 简体中文
|
|
|
|
## ✨ 特性
|
|
|
|
- 提炼自企业级中后台产品的交互语言和视觉风格。
|
|
- 开箱即用的高质量 React 组件。
|
|
- 使用 TypeScript 构建,提供完整的类型定义文件。
|
|
- 全链路开发和设计工具体系。
|
|
|
|
## 🖥 支持环境
|
|
|
|
* 现代浏览器和 IE9 及以上。
|
|
* 支持服务端渲染。
|
|
* [Electron](http://electron.atom.io/)
|
|
|
|
| [<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 |
|
|
| --------- | --------- | --------- | --------- | --------- | --------- |
|
|
| IE9, IE10, IE11, Edge| last 2 versions| last 2 versions| last 2 versions| last 2 versions| last 2 versions
|
|
|
|
## 📦 安装
|
|
|
|
```bash
|
|
npm install antd --save
|
|
```
|
|
|
|
## 🔨 示例
|
|
|
|
```jsx
|
|
import { DatePicker } from 'antd';
|
|
ReactDOM.render(<DatePicker />, mountNode);
|
|
```
|
|
|
|
引入样式:
|
|
|
|
```jsx
|
|
import 'antd/dist/antd.css'; // or 'antd/dist/antd.less'
|
|
```
|
|
|
|
你也可以[按需加载组件](https://ant.design/docs/react/getting-started-cn#按需加载)。
|
|
|
|
### TypeScript
|
|
|
|
参考 [在 TypeScript 中使用](https://ant.design/docs/react/use-in-typescript-cn)
|
|
|
|
## 🌍 国际化
|
|
|
|
参考 [国际化文档](http://ant.design/docs/react/i18n-cn)。
|
|
|
|
## 🔗 链接
|
|
|
|
- [首页](http://ant.design/)
|
|
- [组件库](http://ant.design/docs/react/introduce)
|
|
- [Ant Design Pro](http://pro.ant.design/)
|
|
- [更新日志](CHANGELOG.en-US.md)
|
|
- [脚手架市场](http://scaffold.ant.design)
|
|
- [React 底层基础组件](http://react-component.github.io/)
|
|
- [移动端组件](http://mobile.ant.design)
|
|
- [动效](https://motion.ant.design)
|
|
- [设计规范速查手册](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)
|
|
- [开发者说明](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)
|
|
- [常见问题](https://github.com/ant-design/ant-design/wiki/FAQ)
|
|
- [CodeSandbox 模板](https://u.ant.design/codesandbox-repro) for bug reports
|
|
- [Awesome Ant Design](https://github.com/websemantics/awesome-ant-design)
|
|
- [定制主题](http://ant.design/docs/react/customize-theme-cn)
|
|
|
|
## ⌨️ 本地开发
|
|
|
|
```bash
|
|
$ git clone git@github.com:ant-design/ant-design.git
|
|
$ cd ant-design
|
|
$ npm install
|
|
$ npm start
|
|
```
|
|
|
|
打开浏览器访问 http://127.0.0.1:8001 ,更多[本地开发文档](https://github.com/ant-design/ant-design/wiki/Development)。
|
|
|
|
## 🤝 参与共建 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square)](http://makeapullrequest.com)
|
|
|
|
请参考[贡献指南](https://ant.design/docs/react/contributing-cn).
|
|
|
|
> 强烈推荐阅读 [《提问的智慧》](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),更好的问题更容易获得帮助。
|
|
|
|
## 社区互助
|
|
|
|
如果您在使用的过程中碰到问题,可以通过下面几个途径寻求帮助,同时我们也鼓励资深用户通过下面的途径给新人提供帮助。
|
|
|
|
通过 Stack Overflow 或者 Segment Fault 提问时,建议加上 `antd` 标签。
|
|
|
|
1. [Stack Overflow](http://stackoverflow.com/questions/tagged/antd)(英文)
|
|
2. [Segment Fault](https://segmentfault.com/t/antd)(中文)
|
|
3. [![Join the chat at https://gitter.im/ant-design/ant-design](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/ant-design/ant-design?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
|