You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

162 lines
6.6 KiB

1 month ago
  1. <p align="center">
  2. <img width="300px" src="https://user-images.githubusercontent.com/10731096/95823103-9ce15780-0d5f-11eb-8010-1bd1b5910d4f.png">
  3. </p>
  4. <p align="center">
  5. <a href="https://www.npmjs.org/package/element-plus">
  6. <img src="https://img.shields.io/npm/v/element-plus.svg" />
  7. </a>
  8. <a href="https://github.com/element-plus/element-plus">
  9. <img src="https://img.shields.io/badge/node-%20%3E%3D%2018-47c219" />
  10. </a>
  11. <a href="https://npmcharts.com/compare/element-plus?minimal=true">
  12. <img src="https://img.shields.io/npm/dm/element-plus.svg" />
  13. </a>
  14. <a href="https://codecov.io/gh/element-plus/element-plus">
  15. <img src="https://codecov.io/gh/element-plus/element-plus/branch/dev/graph/badge.svg?token=BKSBO2GLZI"/>
  16. </a>
  17. <br>
  18. </p>
  19. <p align="center">Element Plus - A Vue.js 3 UI library</p>
  20. - 💪 Vue 3 Composition API
  21. - 🔥 Written in TypeScript
  22. ## Getting Started
  23. Alright, for you to get started if you are looking for making Element Plus better you should keep reading.
  24. For developers that uses Element Plus to develop your website you should go ahead visit [Getting Started](https://element-plus.org/).
  25. - 中国大陆[加速镜像站点](https://cn.element-plus.org/zh-CN/)
  26. ## Breaking change list
  27. The first stable release of Element Plus suitable for use in production was released on February 07, 2022. The APIs is stable right now, and here's also a full list about how to get upgraded from [Element UI](https://element.eleme.io) to Element Plus.
  28. You can find the breaking change list here: [Breaking Change List](https://github.com/element-plus/element-plus/discussions/5658).
  29. ### Migration Tool :hammer_and_wrench:
  30. We have made a migration tool for you to migrate your project from [Element UI](https://element.eleme.io) to Element Plus.
  31. You can find the [gogo code migration tool](https://github.com/thx/gogocode/tree/main/packages/gogocode-plugin-element) here.
  32. 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).
  33. ### Playground
  34. You can also try Element Plus out with the components built-in playground.
  35. #### Try it with our built-in playground
  36. [Playground](https://element-plus.run/)
  37. #### Try it with code sandbox
  38. [![Edit element-plus](https://codesandbox.io/static/img/play-codesandbox.svg)](https://codesandbox.io/s/element-plus-demo-dxtcr)
  39. <p align="center">
  40. <b>Special thanks to the generous sponsorship by:</b>
  41. </p>
  42. <br/>
  43. <p align="center">
  44. <b>Platinum Sponsors</b>
  45. </p>
  46. <table align="center" cellspacing="0" cellpadding="0">
  47. <tbody>
  48. <tr>
  49. <td align="center" valign="middle">
  50. <a href="https://melecode.com/" target="_blank">
  51. <img width="150px" src="https://github.com/element-plus/element-plus/assets/82012629/9ca4269c-7545-4463-9bdc-8e5a1fbd0b08">
  52. </a>
  53. </td>
  54. <td align="center" valign="middle">
  55. <a href="https://www.jnpfsoft.com/index.html?from=elementUI" target="_blank">
  56. <img width="150px" src="https://github.com/element-plus/element-plus/assets/17680888/6a044d82-c393-48ab-90b8-de0d3aad1624">
  57. </a>
  58. </td>
  59. <td align="center" valign="middle">
  60. <a href="https://vue.misboot.com/#/login?from=element-plus" target="_blank">
  61. <img width="150px" src="https://github.com/user-attachments/assets/ade8e7e6-f9a4-45d5-9006-44b548599a8d">
  62. </a>
  63. </td>
  64. <td align="center" valign="middle">
  65. <a href="http://github.crmeb.net/u/Element?from=element-plus" target="_blank">
  66. <img width="150px" src="https://github.com/user-attachments/assets/18079452-986c-4c6e-84ec-fb6175c26567">
  67. </a>
  68. </td>
  69. </tr>
  70. </tbody>
  71. </table>
  72. <p align="center">
  73. <b>Gold Sponsors</b>
  74. </p>
  75. <table align="center" cellspacing="0" cellpadding="0">
  76. <tbody>
  77. <tr>
  78. <td align="center" valign="middle">
  79. <a href="https://doc.buildadmin.com/?from=element-plus" target="_blank">
  80. <img width="130px" src="https://user-images.githubusercontent.com/17680888/173179536-30e35fd1-cd5a-482a-bc41-9d5f0aa66fd4.png">
  81. </a>
  82. </td>
  83. <td align="center" valign="middle">
  84. <a href="https://fantastic-admin.github.io/?from=element-plus" target="_blank">
  85. <img width="130px" src="https://github.com/user-attachments/assets/0dbd9c02-d132-4c9e-a162-2b5a8728fc7e">
  86. </a>
  87. </td>
  88. <td align="center" valign="middle">
  89. <a href="https://bit.dev/?from=element-ui" target="_blank">
  90. <img width="130px" src="https://user-images.githubusercontent.com/10095631/41342907-e44e7196-6f2f-11e8-92f2-47702dc8f059.png">
  91. </a>
  92. </td>
  93. </tr>
  94. </tbody>
  95. </table>
  96. ---
  97. ## Translations
  98. Element Plus is translated to multiple languages, you can click the badge to help up update the translation or apply to become
  99. a proofreader [![Crowdin](https://badges.crowdin.net/element-plus/localized.svg)](https://crowdin.com/project/element-plus)
  100. For now we are only showing English and Chinese for resource reasons, but we are looking forward to translate it into more languages, please go to the link
  101. above and leave a message if you want to help translating Element Plus into your desired language.
  102. ### How to help translating
  103. See how to help translating in [Translating Element Plus](https://element-plus.org/en-US/guide/translation.html).
  104. ## Stay tuned :eyes:
  105. Join our [Discord](https://discord.com/invite/gXK9XNzW3X) to start communicating with everybody.
  106. ## This thing is broken, I should help improve it!
  107. Awesommmmmmee. Everything you need is down below. You can also refer to
  108. [CONTRIBUTING](https://github.com/element-plus/element-plus/blob/dev/CONTRIBUTING.md) and
  109. [Code of Conduct](https://github.com/element-plus/element-plus/blob/dev/CODE_OF_CONDUCT.md)
  110. where you'll find the same information listed below.
  111. ## I would like to become a part of the development team!
  112. Welcome :star_struck:! We are looking for talented developers to join us and making Element Plus better! If you care to join the development team, please
  113. reach out to us, you are more than welcomed to join us! :heart:
  114. We are now lacking of experts of `Testing`, `GitHub Actions`, `PM`, if you do feel like you can and willing to help us, please do reach out to us. :pray:
  115. ## Contributors
  116. This project exists thanks to all the people who contribute.
  117. And thank you to all our backers! 🙏
  118. <a href="https://github.com/element-plus/element-plus/graphs/contributors">
  119. <img src="https://contrib.rocks/image?repo=element-plus/element-plus" />
  120. </a>
  121. ## License
  122. Element Plus is open source software licensed as
  123. [MIT](https://github.com/element-plus/element-plus/blob/master/LICENSE).