2016-12-13 20:52:52 +08:00
< p align = "center" >
2016-12-13 22:14:11 +08:00
< img src = "https://cdn.rawgit.com/ElemeFE/element/dev/element_logo.svg" >
2016-12-13 20:52:52 +08:00
< / p >
2017-03-20 14:47:23 +08:00
2016-09-09 21:40:35 +08:00
# Element
2017-03-20 14:47:23 +08:00
2016-09-09 21:40:35 +08:00
[![Build Status ](https://travis-ci.org/ElemeFE/element.svg?branch=master )](https://travis-ci.org/ElemeFE/element)
2016-10-27 23:25:03 +08:00
[![Coverage Status ](https://coveralls.io/repos/github/ElemeFE/element/badge.svg?branch=master )](https://coveralls.io/github/ElemeFE/element?branch=master)
2016-10-31 15:36:41 +08:00
[![CDNJS ](https://img.shields.io/cdnjs/v/element-ui.svg )](https://cdnjs.com/libraries/element-ui)
2016-09-09 21:40:35 +08:00
[![npm package ](https://img.shields.io/npm/v/element-ui.svg )](https://www.npmjs.org/package/element-ui)
[![NPM downloads ](http://img.shields.io/npm/dm/element-ui.svg )](https://npmjs.org/package/element-ui)
2016-11-09 17:36:17 +08:00
![JS gzip size ](http://img.badgesize.io/https://unpkg.com/element-ui/lib/index.js?compression=gzip&label=gzip%20size:%20JS )
2017-09-28 18:01:29 +08:00
![CSS gzip size ](http://img.badgesize.io/https://unpkg.com/element-ui/lib/theme-chalk/index.css?compression=gzip&label=gzip%20size:%20CSS )
2017-04-25 10:28:06 +08:00
[![Join the chat at https://gitter.im/ElemeFE/element ](https://badges.gitter.im/ElemeFE/element.svg )](https://gitter.im/ElemeFE/element?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge& utm_content=badge)(Chinese)
[![Join the chat at https://gitter.im/element-en/Lobby ](https://badges.gitter.im/element-en/Lobby.svg )](https://gitter.im/element-en/Lobby?utm_source=badge& utm_medium=badge& utm_campaign=pr-badge& utm_content=badge)(English)
2016-12-20 10:34:10 +08:00
[![OpenCollective ](https://opencollective.com/element/backers/badge.svg )](#backers)
[![OpenCollective ](https://opencollective.com/element/sponsors/badge.svg )](#sponsors)
2016-09-09 21:40:35 +08:00
2016-11-16 14:09:25 +08:00
> A Vue.js 2.0 UI Toolkit for Web.
2016-07-27 14:15:02 +08:00
2017-09-22 21:34:39 +08:00
< a target = '_blank' rel = 'nofollow' href = 'https://app.codesponsor.io/link/bD3dKbdDE2F7Ky9LUN1kjTFK/ElemeFE/element' >
2017-09-22 21:25:30 +08:00
< img alt = 'Sponsor' width = '888' height = '68' src = 'https://app.codesponsor.io/embed/bD3dKbdDE2F7Ky9LUN1kjTFK/ElemeFE/element.svg' / >
< / a >
2017-01-13 22:12:02 +08:00
2016-09-21 18:45:29 +08:00
## Links
- [Home Page ](http://element.eleme.io/ )
- [Docs ](http://element.eleme.io/#/component )
2016-12-08 22:36:55 +08:00
- [awesome-element ](https://github.com/ElementUI/awesome-element )
2016-11-16 14:09:25 +08:00
- [FAQ ](./FAQ.md )
2016-11-27 14:57:44 +08:00
- [Customize Theme ](http://element.eleme.io/#/en-US/component/custom-theme )
2017-01-22 19:31:13 +08:00
- [Preview and generate theme online ](https://elementui.github.io/theme-preview )
2017-05-10 20:44:49 +08:00
- [Element for React ](https://github.com/eleme/element-react )
2017-06-07 11:47:11 +08:00
- [Atom helper ](https://github.com/ElemeFE/element-helper )
2016-10-31 12:25:19 +08:00
- Starter Kit
2017-04-03 19:50:19 +08:00
- [element-starter ](https://github.com/ElementUI/element-starter )
- [element-cooking-starter ](https://github.com/ElementUI/element-cooking-starter )
- [element-in-laravel-starter ](https://github.com/ElementUI/element-in-laravel-starter )
2016-10-31 12:25:19 +08:00
- [Design resources ](https://github.com/ElementUI/Resources )
- Boilerplate for bug reports
2017-04-03 19:50:19 +08:00
- [CodePen ](https://codepen.io/anon/pen/ozYpNA )
- [JSFiddle ](https://jsfiddle.net/gmve9d3p/ )
2016-10-31 12:25:19 +08:00
- [Mint UI ](https://github.com/ElemeFE/mint-ui ) - Mobile UI elements for Vue.js
2016-09-03 20:30:59 +08:00
2016-09-21 18:45:29 +08:00
## Install
2016-07-27 14:15:02 +08:00
```shell
2016-11-09 17:36:17 +08:00
npm install element-ui -S
2016-07-27 14:15:02 +08:00
```
## Quick Start
``` javascript
import Vue from 'vue'
import Element from 'element-ui'
Vue.use(Element)
// or
import {
Select,
Button
// ...
} from 'element-ui'
2016-09-06 12:01:53 +08:00
Vue.component(Select.name, Select)
Vue.component(Button.name, Button)
2016-07-27 14:15:02 +08:00
```
2016-11-16 14:09:25 +08:00
For more information, please refer to [Quick Start ](http://element.eleme.io/#/en-US/component/quickstart ) in our documentation.
2016-07-27 14:15:02 +08:00
2016-09-24 18:09:09 +08:00
## Browser Support
Modern browsers and Internet Explorer 9+.
2016-09-07 15:38:19 +08:00
## Development
2016-10-18 17:05:39 +08:00
Skip this part if you just want to use Element.
2016-09-07 15:38:19 +08:00
2017-02-04 16:42:28 +08:00
For those who are interested in contributing to Element, please refer to our contributing guide ([中文](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.zh-CN.md) | [English ](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.en-US.md )) to see how to run this project.
2016-09-03 20:30:59 +08:00
2016-09-01 14:17:01 +08:00
## Changelog
2016-09-24 20:26:03 +08:00
Detailed changes for each release are documented in the [release notes ](https://github.com/ElemeFE/element/releases ).
2016-09-01 14:17:01 +08:00
2016-10-18 17:05:39 +08:00
## FAQ
We have collected some [frequently asked questions ](https://github.com/ElemeFE/element/blob/master/FAQ.md ). Before reporting an issue, please search if the FAQ has the answer to your problem.
2016-09-07 12:40:16 +08:00
## Contribution
2017-02-04 16:42:28 +08:00
Please make sure to read the contributing guide ([中文](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.zh-CN.md) | [English ](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.en-US.md )) before making a pull request.
2016-09-07 12:40:16 +08:00
2016-12-06 16:05:38 +08:00
## Special Thanks
English documentation is brought to you by SwiftGG Translation Team. Our special thanks go to these fellows:
- [raychenfj ](https://github.com/raychenfj )
- [kevin ](http://thekevin.cn/ )
- [曾小涛 ](https://github.com/zengxiaotao )
- [湾仔王二 ](https://github.com/wanzaiwanger )
- [BlooDLine ](http://www.ibloodline.com/ )
2016-12-06 18:29:37 +08:00
- [陈铭嘉 ](https://chenmingjia.github.io/ )
2016-12-06 16:05:38 +08:00
- [千叶知风 ](http://mpc6.com/ )
- [梁杰 ](http://numbbbbb.com )
- [Changing ](https://github.com/sunzhuo11 )
- [mmoaay ](https://github.com/mmoaay )
2016-12-13 15:56:42 +08:00
## Donation
If you find Element useful, you can buy us a cup of coffee
2017-03-29 20:02:54 +08:00
< img width = "650" src = "http://fuss10.elemecdn.com/2/d0/ab1b8e5a1d96bcdcd6092ce0c66ecjpeg.jpeg?t=2017" alt = "" >
2016-12-13 15:56:42 +08:00
2016-12-20 11:51:52 +08:00
## Backers
Support us with a monthly donation and help us continue our activities. [[Become a backer ](https://opencollective.com/element#backer )]
< a href = "https://opencollective.com/element/backer/0/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/0/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/1/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/1/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/2/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/2/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/3/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/3/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/4/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/4/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/5/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/5/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/6/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/6/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/7/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/7/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/8/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/8/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/9/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/9/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/10/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/10/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/11/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/11/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/12/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/12/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/13/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/13/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/14/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/14/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/15/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/15/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/16/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/16/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/17/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/17/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/18/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/18/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/19/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/19/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/20/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/20/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/21/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/21/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/22/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/22/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/23/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/23/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/24/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/24/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/25/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/25/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/26/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/26/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/27/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/27/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/28/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/28/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/backer/29/website" target = "_blank" > < img src = "https://opencollective.com/element/backer/29/avatar.svg" > < / a >
## Sponsors
Become a sponsor and get your logo on our README on Github with a link to your site. [[Become a sponsor ](https://opencollective.com/element#sponsor )]
< a href = "https://opencollective.com/element/sponsor/0/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/0/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/1/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/1/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/2/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/2/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/3/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/3/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/4/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/4/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/5/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/5/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/6/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/6/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/7/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/7/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/8/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/8/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/9/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/9/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/10/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/10/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/11/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/11/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/12/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/12/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/13/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/13/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/14/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/14/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/15/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/15/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/16/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/16/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/17/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/17/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/18/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/18/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/19/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/19/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/20/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/20/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/21/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/21/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/22/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/22/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/23/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/23/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/24/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/24/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/25/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/25/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/26/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/26/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/27/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/27/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/28/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/28/avatar.svg" > < / a >
< a href = "https://opencollective.com/element/sponsor/29/website" target = "_blank" > < img src = "https://opencollective.com/element/sponsor/29/avatar.svg" > < / a >
2016-12-20 10:34:10 +08:00
2016-07-27 14:15:02 +08:00
## LICENSE
MIT