element/README.md

147 lines
6.2 KiB
Markdown
Raw Normal View History

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>
2018-03-15 10:48:11 +08: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>
> A Vue.js 2.0 UI Toolkit for Web.
Element will stay with Vue 2.x
For Vue 3.0, we recommend using [Element Plus](https://github.com/element-plus/element-plus) from the same team
## Links
2017-10-25 11:58:58 +08:00
- Homepage and documentation
2018-03-15 10:57:45 +08:00
- [International users](http://element.eleme.io/#/en-US)
- [Chinese users](http://element-cn.eleme.io/#/zh-CN)
- [Spanish users](http://element.eleme.io/#/es)
- [French users](http://element.eleme.io/#/fr-FR)
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)
- [Vue.js 3.0 migration](https://github.com/element-plus/element-plus)
2017-10-25 11:58:58 +08:00
- [Customize theme](http://element.eleme.io/#/en-US/component/custom-theme)
- [Preview and generate theme online](https://elementui.github.io/theme-chalk-preview)
- [Element for React](https://github.com/elemefe/element-react)
- [Element for Angular](https://github.com/ElemeFE/element-angular)
2017-06-07 11:47:11 +08:00
- [Atom helper](https://github.com/ElemeFE/element-helper)
2018-02-07 10:29:20 +08:00
- [Visual Studio Code helper](https://github.com/ElemeFE/vscode-element-helper)
2017-10-25 11:58:58 +08:00
- Starter kit
2017-04-03 19:50:19 +08:00
- [element-starter](https://github.com/ElementUI/element-starter)
- [element-in-laravel-starter](https://github.com/ElementUI/element-in-laravel-starter)
2018-03-15 10:57:45 +08: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 20:30:59 +08:00
## Install
2016-07-27 14:15:02 +08:00
```shell
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
2017-10-27 11:30:04 +08:00
Modern browsers and Internet Explorer 10+.
2016-09-24 18:09:09 +08:00
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
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 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
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 12:40:16 +08:00
2016-12-06 16:05:38 +08:00
## Special Thanks
2017-12-12 12:45:09 +08:00
English documentation is brought to you by SwiftGG Translation Team:
2016-12-06 16:05:38 +08: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 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)
2017-12-12 12:45:09 +08: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)
French documentation is made possible by these community developers:
- [smalesys](https://github.com/smalesys)
- [blombard](https://github.com/blombard)
2019-09-02 11:34:24 +08:00
## Join Discussion Group
2019-09-02 11:34:24 +08:00
Scan the QR code using [Dingtalk App](https://www.dingtalk.com/) to join in discussion group :
<img alt="Join Discusion Group" src="https://user-images.githubusercontent.com/17680888/93177882-0ae92d80-f766-11ea-870d-3fa2d7f06454.png" width="300">
2016-12-20 10:34:10 +08:00
2016-07-27 14:15:02 +08:00
## LICENSE
[MIT](LICENSE)