ant-design/README.md
2017-01-22 01:19:04 +08:00

5.3 KiB

Ant Design

Coveralls Dependency Status

npm package NPM downloads Average time to resolve an issue Join the chat at https://gitter.im/ant-design/ant-design

An enterprise-class UI design language and React-based implementation.

中文 README

Features

  • An enterprise-class UI design language for web applications.
  • A set of high-quality React components out of the box.
  • Written in TypeScript with complete define types.
  • A npm + webpack + dva front-end development workflow.

Let's build a better antd together PRs Welcome

antd is an open source project, improvements are welcomed. If you are interested in contributing to antd, you can watch this repository, join in discussion, or try to implement some features which have been accepted.

Install

npm install antd

Usage

Use prebuilt bundle

import { DatePicker } from 'antd';
ReactDOM.render(<DatePicker />, mountNode);

And import style manually:

import 'antd/dist/antd.css';  // or 'antd/dist/antd.less'

Use modularized antd

  • Use babel-plugin-import (Recommended)

    // .babelrc
    {
      "plugins": [["import", { libraryName: "antd", style: "css" }]]
    }
    

    Then you can import components from antd directly.

    // import js and css modularly, parsed by babel-plugin-import
    import { DatePicker } from 'antd';
    
  • Manual import

    import DatePicker from 'antd/lib/date-picker';  // just for js
    import 'antd/lib/date-picker/style/css';  // with style
    

Environment Support

  • Browser: Modern browsers and Internet Explorer 9+.

IE8 issues

TypeScript

tsconfig.json

{
  "compilerOptions": {
    "moduleResolution": "node",
    "jsx": "preserve",
    "allowSyntheticDefaultImports": true
  }
}

Note: set allowSyntheticDefaultImports to prevent error TS1192: Module 'react' has no default export.

Contributing

We welcome all contributions, please read our CONTRIBUTING.md first. You can submit any ideas as pull requests or as GitHub issues. If you'd like to improve code, check out the Development Instructions and have a good time! :)

Release Schedule

Follow Semantic Versioning 2.0.0.

  • Weekly release: patch version at the end of every week for routine bugfix.
  • Monthly release: minor version at the end of every month for new features.
  • Emergence release: emergence patch anytime if necessary for urgent bugfix.
  • Major version release is not included in this schedule for breadking change and new features.