159 lines
6.4 KiB
Markdown
159 lines
6.4 KiB
Markdown
<p align="center">
|
|
<img width="300px" src="https://user-images.githubusercontent.com/10731096/95823103-9ce15780-0d5f-11eb-8010-1bd1b5910d4f.png">
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="https://www.npmjs.org/package/element-plus">
|
|
<img src="https://img.shields.io/npm/v/element-plus.svg" />
|
|
</a>
|
|
<a href="https://github.com/element-plus/element-plus">
|
|
<img src="https://img.shields.io/badge/node-%20%3E%3D%2020-47c219" />
|
|
</a>
|
|
<a href="https://npmcharts.com/compare/element-plus?minimal=true">
|
|
<img src="https://img.shields.io/npm/dm/element-plus.svg" />
|
|
</a>
|
|
<a href="https://codecov.io/gh/element-plus/element-plus">
|
|
<img src="https://codecov.io/gh/element-plus/element-plus/branch/dev/graph/badge.svg?token=BKSBO2GLZI"/>
|
|
</a>
|
|
<br>
|
|
</p>
|
|
|
|
<p align="center">Element Plus - A Vue.js 3 UI library</p>
|
|
|
|
- 💪 Vue 3 Composition API
|
|
- 🔥 Written in TypeScript
|
|
|
|
## Getting Started
|
|
|
|
Alright, if you're looking to make Element Plus better, keep reading.
|
|
For developers using Element Plus to build websites, please visit [Getting Started](https://element-plus.org/).
|
|
|
|
- 中国大陆[加速镜像站点](https://cn.element-plus.org/zh-CN/)
|
|
|
|
## Breaking Change List
|
|
|
|
The first stable release of Element Plus, suitable for production use, was released on February 7, 2022. The API is stable now, and here's a full list on how to upgrade from [Element UI](https://element.eleme.io) to Element Plus.
|
|
|
|
You can find the breaking change list here: [Breaking Change List](https://github.com/element-plus/element-plus/discussions/5658).
|
|
|
|
### Migration Tool :hammer_and_wrench:
|
|
|
|
We have made a migration tool for you to migrate your project from [Element UI](https://element.eleme.io) to Element Plus.
|
|
|
|
You can find the [gogocode migration tool](https://github.com/thx/gogocode/tree/main/packages/gogocode-plugin-element) here.
|
|
|
|
We have tested this on [Vue Element Admin](https://github.com/PanJiaChen/vue-element-admin). You can find the transpiled code [here](https://github.com/gogocodeio/vue-element-admin).
|
|
|
|
### Playground
|
|
|
|
You can also try out Element Plus with its built-in component playground.
|
|
|
|
#### Try it with our built-in playground
|
|
|
|
[Playground](https://element-plus.run/)
|
|
|
|
#### Try it with CodeSandbox
|
|
|
|
[](https://codesandbox.io/p/github/element-plus/element-plus-demo/main)
|
|
|
|
<p align="center">
|
|
<b>Special thanks to our generous sponsors:</b>
|
|
</p>
|
|
<br/>
|
|
<p align="center">
|
|
<b>Platinum Sponsors</b>
|
|
</p>
|
|
<table align="center" cellspacing="0" cellpadding="0">
|
|
<tbody>
|
|
<tr>
|
|
<td align="center" valign="middle">
|
|
<a href="https://melecode.com/" target="_blank">
|
|
<img width="150px" src="https://github.com/element-plus/element-plus/assets/82012629/9ca4269c-7545-4463-9bdc-8e5a1fbd0b08">
|
|
</a>
|
|
</td>
|
|
<td align="center" valign="middle">
|
|
<a href="https://www.jnpfsoft.com/index.html?from=elementUI" target="_blank">
|
|
<img width="150px" src="https://github.com/element-plus/element-plus/assets/17680888/6a044d82-c393-48ab-90b8-de0d3aad1624">
|
|
</a>
|
|
</td>
|
|
<td align="center" valign="middle">
|
|
<a href="http://github.crmeb.net/u/Element?from=element-plus" target="_blank">
|
|
<img width="150px" src="https://github.com/user-attachments/assets/18079452-986c-4c6e-84ec-fb6175c26567">
|
|
</a>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
<p align="center">
|
|
<b>Gold Sponsors</b>
|
|
</p>
|
|
<table align="center" cellspacing="0" cellpadding="0">
|
|
<tbody>
|
|
<tr>
|
|
<td align="center" valign="middle">
|
|
<a href="https://doc.buildadmin.com/?from=element-plus" target="_blank">
|
|
<img width="130px" src="https://user-images.githubusercontent.com/17680888/173179536-30e35fd1-cd5a-482a-bc41-9d5f0aa66fd4.png">
|
|
</a>
|
|
</td>
|
|
<td align="center" valign="middle">
|
|
<a href="https://bit.dev/?from=element-ui" target="_blank">
|
|
<img width="130px" src="https://user-images.githubusercontent.com/10095631/41342907-e44e7196-6f2f-11e8-92f2-47702dc8f059.png">
|
|
</a>
|
|
</td>
|
|
</tr>
|
|
</tbody>
|
|
</table>
|
|
|
|
---
|
|
|
|
## Translations
|
|
|
|
Element Plus has been translated into multiple languages. You can click the badge to help us update the translations or apply to become
|
|
a proofreader. [](https://crowdin.com/project/element-plus)
|
|
|
|
For now, we are only providing English and Chinese versions due to limited resources, but we are looking forward to translating it into more languages. Please visit the link
|
|
above and leave a message if you would like to help translate Element Plus into your preferred language.
|
|
|
|
### How to help translate
|
|
|
|
See how to help translate in [Translating Element Plus](https://element-plus.org/en-US/guide/translation.html).
|
|
|
|
## Stay tuned :eyes:
|
|
|
|
Join our [Discord](https://discord.com/invite/gXK9XNzW3X) to start communicating with everybody.
|
|
|
|
## This thing is broken, I should help improve it!
|
|
|
|
Awesommmmmmee. Everything you need is down below. You can also refer to
|
|
[CONTRIBUTING](https://github.com/element-plus/element-plus/blob/dev/CONTRIBUTING.md) and
|
|
[Code of Conduct](https://github.com/element-plus/element-plus/blob/dev/CODE_OF_CONDUCT.md)
|
|
where you'll find the same information listed below.
|
|
|
|
## I would like to become a part of the development team!
|
|
|
|
Welcome :star_struck:! We are looking for talented developers to join us and make Element Plus better! If you're interested in joining the development team, please
|
|
reach out to us -- you're more than welcome to join us! :heart:
|
|
|
|
We are now looking for experts in `Testing`, `GitHub Actions` and `PM`. If you feel like you can and are willing to help, please don't hesitate to reach out to us. :pray:
|
|
|
|
## Contributors
|
|
|
|
This project exists thanks to all the people who contribute.
|
|
|
|
And thank you to all our backers! 🙏
|
|
|
|
<a href="https://openomy.app/github/element-plus/element-plus" target="_blank" style="display: block; width: 100%;" align="center">
|
|
<img src="https://openomy.app/svg?repo=element-plus/element-plus&chart=bubble&latestMonth=3" target="_blank" alt="Contribution Leaderboard" style="display: block; width: 100%;" />
|
|
</a>
|
|
|
|
<hr />
|
|
|
|
<a href="https://github.com/element-plus/element-plus/graphs/contributors">
|
|
<img src="https://contrib.rocks/image?repo=element-plus/element-plus" />
|
|
</a>
|
|
|
|
## License
|
|
|
|
Element Plus is open source software licensed as
|
|
[MIT](https://github.com/element-plus/element-plus/blob/master/LICENSE).
|