2016-12-13 12:52:52 +00:00
< p align = "center" >
2016-12-13 14:14:11 +00:00
< img src = "https://cdn.rawgit.com/ElemeFE/element/dev/element_logo.svg" >
2016-12-13 12:52:52 +00:00
< / p >
2017-03-20 06:47:23 +00:00
2018-03-15 02:48:11 +00:00
< p align = "center" >
< a href = "https://travis-ci.org/ElemeFE/element" >
< img src = "https://travis-ci.org/ElemeFE/element.svg?branch=master" >
< / a >
< a href = "https://coveralls.io/github/ElemeFE/element?branch=master" >
< img src = "https://coveralls.io/repos/github/ElemeFE/element/badge.svg?branch=master" >
< / a >
< a href = "https://cdnjs.com/libraries/element-ui" >
< img src = "https://img.shields.io/cdnjs/v/element-ui.svg" >
< / a >
< a href = "https://www.npmjs.org/package/element-ui" >
< img src = "https://img.shields.io/npm/v/element-ui.svg" >
< / a >
< a href = "https://npmcharts.com/compare/element-ui?minimal=true" >
< img src = "http://img.shields.io/npm/dm/element-ui.svg" >
< / a >
< br >
< a href = "http://img.badgesize.io/https://unpkg.com/element-ui/lib/index.js?compression=gzip&label=gzip%20size:%20JS" >
< img src = "http://img.badgesize.io/https://unpkg.com/element-ui/lib/index.js?compression=gzip&label=gzip%20size:%20JS" >
< / a >
< a href = "http://img.badgesize.io/https://unpkg.com/element-ui/lib/theme-chalk/index.css?compression=gzip&label=gzip%20size:%20CSS" >
< img src = "http://img.badgesize.io/https://unpkg.com/element-ui/lib/theme-chalk/index.css?compression=gzip&label=gzip%20size:%20CSS" >
< / a >
< a href = "#backers" >
< img src = "https://opencollective.com/element/backers/badge.svg" >
< / a >
< a href = "#sponsors" >
< img src = "https://opencollective.com/element/sponsors/badge.svg" >
< / a >
< a href = "LICENSE" >
< img src = "https://img.shields.io/badge/License-MIT-yellow.svg" >
< / a >
< / p >
2017-03-20 06:47:23 +00:00
2020-10-29 02:10:12 +00:00
> A Vue.js 2.0 UI Toolkit for Web.
2023-08-23 02:27:00 +00:00
Element will stay with Vue 2.x
2020-10-29 02:10:12 +00:00
2022-11-15 06:52:19 +00:00
For Vue 3.0, we recommend using [Element Plus ](https://github.com/element-plus/element-plus )(Element Plus is a community develop project)
2020-10-29 02:10:12 +00:00
2023-08-23 02:27:00 +00:00
For MiniProgram development, we recommend using [MorJS ](https://github.com/eleme/morjs )
2016-09-21 10:45:29 +00:00
## Links
2017-10-25 03:58:58 +00:00
- Homepage and documentation
2018-03-15 02:57:45 +00:00
- [International users ](http://element.eleme.io/#/en-US )
2023-02-07 02:41:25 +00:00
- [Chinese users ](http://element.eleme.io/#/zh-CN )
2018-03-15 02:57:45 +00:00
- [Spanish users ](http://element.eleme.io/#/es )
2019-02-21 08:35:34 +00:00
- [French users ](http://element.eleme.io/#/fr-FR )
2016-12-08 14:36:55 +00:00
- [awesome-element ](https://github.com/ElementUI/awesome-element )
2016-11-16 06:09:25 +00:00
- [FAQ ](./FAQ.md )
2020-11-11 08:46:22 +00:00
- [Vue.js 3.0 migration ](https://github.com/element-plus/element-plus )
2017-10-25 03:58:58 +00:00
- [Customize theme ](http://element.eleme.io/#/en-US/component/custom-theme )
- [Preview and generate theme online ](https://elementui.github.io/theme-chalk-preview )
2018-06-22 11:02:31 +00:00
- [Element for React ](https://github.com/elemefe/element-react )
2018-01-26 03:24:09 +00:00
- [Element for Angular ](https://github.com/ElemeFE/element-angular )
2017-06-07 03:47:11 +00:00
- [Atom helper ](https://github.com/ElemeFE/element-helper )
2018-02-07 02:29:20 +00:00
- [Visual Studio Code helper ](https://github.com/ElemeFE/vscode-element-helper )
2017-10-25 03:58:58 +00:00
- Starter kit
2017-04-03 11:50:19 +00:00
- [element-starter ](https://github.com/ElementUI/element-starter )
- [element-in-laravel-starter ](https://github.com/ElementUI/element-in-laravel-starter )
2018-03-15 02:57:45 +00:00
- [Design resources ](https://github.com/ElementUI/Resources )
- Gitter
- [International users ](https://gitter.im/element-en/Lobby )
- [Chinese users ](https://gitter.im/ElemeFE/element )
2016-09-03 12:30:59 +00:00
2016-09-21 10:45:29 +00:00
## Install
2016-07-27 06:15:02 +00:00
```shell
2016-11-09 09:36:17 +00:00
npm install element-ui -S
2016-07-27 06:15:02 +00: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 04:01:53 +00:00
Vue.component(Select.name, Select)
Vue.component(Button.name, Button)
2016-07-27 06:15:02 +00:00
```
2016-11-16 06:09:25 +00:00
For more information, please refer to [Quick Start ](http://element.eleme.io/#/en-US/component/quickstart ) in our documentation.
2016-07-27 06:15:02 +00:00
2016-09-24 10:09:09 +00:00
## Browser Support
2017-10-27 03:30:04 +00:00
Modern browsers and Internet Explorer 10+.
2016-09-24 10:09:09 +00:00
2016-09-07 07:38:19 +00:00
## Development
2016-10-18 09:05:39 +00:00
Skip this part if you just want to use Element.
2016-09-07 07:38:19 +00:00
2019-02-21 08:35:34 +00: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 ) | [Español ](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.es.md ) | [Français ](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.fr-FR.md )) to see how to run this project.
2016-09-03 12:30:59 +00:00
2016-09-01 06:17:01 +00:00
## Changelog
2016-09-24 12:26:03 +00:00
Detailed changes for each release are documented in the [release notes ](https://github.com/ElemeFE/element/releases ).
2016-09-01 06:17:01 +00:00
2016-10-18 09:05:39 +00: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 04:40:16 +00:00
## Contribution
2019-02-21 08:35:34 +00: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 ) | [Español ](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.es.md ) | [Français ](https://github.com/ElemeFE/element/blob/master/.github/CONTRIBUTING.fr-FR.md )) before making a pull request.
2016-09-07 04:40:16 +00:00
2016-12-06 08:05:38 +00:00
## Special Thanks
2017-12-12 04:45:09 +00:00
English documentation is brought to you by SwiftGG Translation Team:
2016-12-06 08:05:38 +00:00
- [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 10:29:37 +00:00
- [陈铭嘉 ](https://chenmingjia.github.io/ )
2016-12-06 08:05:38 +00:00
- [千叶知风 ](http://mpc6.com/ )
- [梁杰 ](http://numbbbbb.com )
- [Changing ](https://github.com/sunzhuo11 )
- [mmoaay ](https://github.com/mmoaay )
2017-12-12 04:45:09 +00:00
Spanish documentation is made possible by these community developers:
- [adavie1 ](https://github.com/adavie1 )
- [carmencitaqiu ](https://github.com/carmencitaqiu )
- [coderdiaz ](https://github.com/coderdiaz )
- [fedegar33 ](https://github.com/fedegar33 )
- [Gonzalo2310 ](https://github.com/Gonzalo2310 )
- [lesterbx ](https://github.com/lesterbx )
- [ProgramerGuy ](https://github.com/ProgramerGuy )
- [SantiagoGdaR ](https://github.com/SantiagoGdaR )
- [sigfriedCub1990 ](https://github.com/sigfriedCub1990 )
- [thechosenjuan ](https://github.com/thechosenjuan )
2019-05-07 03:35:54 +00:00
French documentation is made possible by these community developers:
- [smalesys ](https://github.com/smalesys )
2019-06-25 02:25:18 +00:00
- [blombard ](https://github.com/blombard )
2019-05-07 03:35:54 +00:00
2019-09-02 03:34:24 +00:00
## Join Discussion Group
2019-01-02 09:00:32 +00:00
2019-09-02 03:34:24 +00:00
Scan the QR code using [Dingtalk App ](https://www.dingtalk.com/ ) to join in discussion group :
2019-01-02 09:00:32 +00:00
2020-09-15 07:16:14 +00:00
< img alt = "Join Discusion Group" src = "https://user-images.githubusercontent.com/17680888/93177882-0ae92d80-f766-11ea-870d-3fa2d7f06454.png" width = "300" >
2016-12-20 02:34:10 +00:00
2016-07-27 06:15:02 +00:00
## LICENSE
2018-01-14 11:16:40 +00:00
[MIT ](LICENSE )