1 | <p align="center">
|
2 | <img src="https://cdn.rawgit.com/ElemeFE/element/dev/element_logo.svg">
|
3 | </p>
|
4 |
|
5 | <p align="center">
|
6 | <a href="https://travis-ci.org/ElemeFE/element">
|
7 | <img src="https://travis-ci.org/ElemeFE/element.svg?branch=master">
|
8 | </a>
|
9 | <a href="https://coveralls.io/github/ElemeFE/element?branch=master">
|
10 | <img src="https://coveralls.io/repos/github/ElemeFE/element/badge.svg?branch=master">
|
11 | </a>
|
12 | <a href="https://cdnjs.com/libraries/element-ui">
|
13 | <img src="https://img.shields.io/cdnjs/v/element-ui.svg">
|
14 | </a>
|
15 | <a href="https://www.npmjs.org/package/element-ui">
|
16 | <img src="https://img.shields.io/npm/v/element-ui.svg">
|
17 | </a>
|
18 | <a href="https://npmcharts.com/compare/element-ui?minimal=true">
|
19 | <img src="http://img.shields.io/npm/dm/element-ui.svg">
|
20 | </a>
|
21 | <br>
|
22 | <a href="http://img.badgesize.io/https://unpkg.com/element-ui/lib/index.js?compression=gzip&label=gzip%20size:%20JS">
|
23 | <img src="http://img.badgesize.io/https://unpkg.com/element-ui/lib/index.js?compression=gzip&label=gzip%20size:%20JS">
|
24 | </a>
|
25 | <a href="http://img.badgesize.io/https://unpkg.com/element-ui/lib/theme-chalk/index.css?compression=gzip&label=gzip%20size:%20CSS">
|
26 | <img src="http://img.badgesize.io/https://unpkg.com/element-ui/lib/theme-chalk/index.css?compression=gzip&label=gzip%20size:%20CSS">
|
27 | </a>
|
28 | <a href="#backers">
|
29 | <img src="https://opencollective.com/element/backers/badge.svg">
|
30 | </a>
|
31 | <a href="#sponsors">
|
32 | <img src="https://opencollective.com/element/sponsors/badge.svg">
|
33 | </a>
|
34 | <a href="LICENSE">
|
35 | <img src="https://img.shields.io/badge/License-MIT-yellow.svg">
|
36 | </a>
|
37 | </p>
|
38 |
|
39 | > A Vue.js 2.0 UI Toolkit for Web.
|
40 |
|
41 | Element will stay with Vue 2.x
|
42 |
|
43 | For Vue 3.0, we recommend using [Element Plus](https://github.com/element-plus/element-plus) from the same team (Element Plus is a community develop project)
|
44 |
|
45 | ## Links
|
46 | - Homepage and documentation
|
47 | - [International users](http://element.eleme.io/#/en-US)
|
48 | - [Chinese users](http://element-cn.eleme.io/#/zh-CN)
|
49 | - [Spanish users](http://element.eleme.io/#/es)
|
50 | - [French users](http://element.eleme.io/#/fr-FR)
|
51 | - [awesome-element](https://github.com/ElementUI/awesome-element)
|
52 | - [FAQ](./FAQ.md)
|
53 | - [Vue.js 3.0 migration](https://github.com/element-plus/element-plus)
|
54 | - [Customize theme](http://element.eleme.io/#/en-US/component/custom-theme)
|
55 | - [Preview and generate theme online](https://elementui.github.io/theme-chalk-preview)
|
56 | - [Element for React](https://github.com/elemefe/element-react)
|
57 | - [Element for Angular](https://github.com/ElemeFE/element-angular)
|
58 | - [Atom helper](https://github.com/ElemeFE/element-helper)
|
59 | - [Visual Studio Code helper](https://github.com/ElemeFE/vscode-element-helper)
|
60 | - Starter kit
|
61 | - [element-starter](https://github.com/ElementUI/element-starter)
|
62 | - [element-in-laravel-starter](https://github.com/ElementUI/element-in-laravel-starter)
|
63 | - [Design resources](https://github.com/ElementUI/Resources)
|
64 | - Gitter
|
65 | - [International users](https://gitter.im/element-en/Lobby)
|
66 | - [Chinese users](https://gitter.im/ElemeFE/element)
|
67 |
|
68 | ## Install
|
69 | ```shell
|
70 | npm install element-ui -S
|
71 | ```
|
72 |
|
73 | ## Quick Start
|
74 | ``` javascript
|
75 | import Vue from 'vue'
|
76 | import Element from 'element-ui'
|
77 |
|
78 | Vue.use(Element)
|
79 |
|
80 | // or
|
81 | import {
|
82 | Select,
|
83 | Button
|
84 | // ...
|
85 | } from 'element-ui'
|
86 |
|
87 | Vue.component(Select.name, Select)
|
88 | Vue.component(Button.name, Button)
|
89 | ```
|
90 | For more information, please refer to [Quick Start](http://element.eleme.io/#/en-US/component/quickstart) in our documentation.
|
91 |
|
92 | ## Browser Support
|
93 | Modern browsers and Internet Explorer 10+.
|
94 |
|
95 | ## Development
|
96 | Skip this part if you just want to use Element.
|
97 |
|
98 | 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.
|
99 |
|
100 | ## Changelog
|
101 | Detailed changes for each release are documented in the [release notes](https://github.com/ElemeFE/element/releases).
|
102 |
|
103 | ## FAQ
|
104 | 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.
|
105 |
|
106 | ## Contribution
|
107 | 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.
|
108 |
|
109 | ## Special Thanks
|
110 | English documentation is brought to you by SwiftGG Translation Team:
|
111 | - [raychenfj](https://github.com/raychenfj)
|
112 | - [kevin](http://thekevin.cn/)
|
113 | - [曾小涛](https://github.com/zengxiaotao)
|
114 | - [湾仔王二](https://github.com/wanzaiwanger)
|
115 | - [BlooDLine](http://www.ibloodline.com/)
|
116 | - [陈铭嘉](https://chenmingjia.github.io/)
|
117 | - [千叶知风](http://mpc6.com/)
|
118 | - [梁杰](http://numbbbbb.com)
|
119 | - [Changing](https://github.com/sunzhuo11)
|
120 | - [mmoaay](https://github.com/mmoaay)
|
121 |
|
122 | Spanish documentation is made possible by these community developers:
|
123 | - [adavie1](https://github.com/adavie1)
|
124 | - [carmencitaqiu](https://github.com/carmencitaqiu)
|
125 | - [coderdiaz](https://github.com/coderdiaz)
|
126 | - [fedegar33](https://github.com/fedegar33)
|
127 | - [Gonzalo2310](https://github.com/Gonzalo2310)
|
128 | - [lesterbx](https://github.com/lesterbx)
|
129 | - [ProgramerGuy](https://github.com/ProgramerGuy)
|
130 | - [SantiagoGdaR](https://github.com/SantiagoGdaR)
|
131 | - [sigfriedCub1990](https://github.com/sigfriedCub1990)
|
132 | - [thechosenjuan](https://github.com/thechosenjuan)
|
133 |
|
134 | French documentation is made possible by these community developers:
|
135 | - [smalesys](https://github.com/smalesys)
|
136 | - [blombard](https://github.com/blombard)
|
137 |
|
138 | ## Join Discussion Group
|
139 |
|
140 | Scan the QR code using [Dingtalk App](https://www.dingtalk.com/) to join in discussion group :
|
141 |
|
142 | <img alt="Join Discusion Group" src="https://user-images.githubusercontent.com/17680888/93177882-0ae92d80-f766-11ea-870d-3fa2d7f06454.png" width="300">
|
143 |
|
144 |
|
145 | ## LICENSE
|
146 | [MIT](LICENSE)
|