2020-08-18 10:56:04 +08:00
|
|
|
<p align="center">
|
2020-10-13 14:27:15 +08:00
|
|
|
<img width="300px" src="https://user-images.githubusercontent.com/10731096/95823103-9ce15780-0d5f-11eb-8010-1bd1b5910d4f.png">
|
2020-08-18 10:56:04 +08:00
|
|
|
</p>
|
|
|
|
|
|
2020-08-18 11:17:47 +08:00
|
|
|
<p align="center">Element Plus - A Vue.js 3.0 UI library</p>
|
2020-08-18 10:56:04 +08:00
|
|
|
|
|
|
|
|
* 💪 Vue 3.0 Composition API
|
|
|
|
|
* 🔥 Written in TypeScript
|
|
|
|
|
|
|
|
|
|
This project is still under heavy development. Feel free to join us and make your first pull request.
|
|
|
|
|
|
2020-09-27 21:54:41 +08:00
|
|
|
[](https://codesandbox.io/s/element-plus-ncxnt?fontsize=14&hidenavigation=1&theme=dark)
|
2020-09-27 21:48:53 +08:00
|
|
|
|
2020-08-18 10:56:04 +08:00
|
|
|
---
|
2020-07-24 19:20:37 +08:00
|
|
|
|
2020-11-18 22:41:22 +08:00
|
|
|
Join our [Discord](https://discord.link/ElementPlus) to start communicating with everybody.
|
2020-08-22 16:52:59 +08:00
|
|
|
|
2020-07-24 19:20:37 +08:00
|
|
|
## Bootstrap project
|
|
|
|
|
With command
|
|
|
|
|
```bash
|
2020-07-24 20:29:10 +08:00
|
|
|
$ yarn bootstrap
|
2020-07-24 19:20:37 +08:00
|
|
|
```
|
|
|
|
|
the project will install all dependencies and run `lerna bootstrap` to initialize the project
|
|
|
|
|
|
2020-09-18 16:15:30 +08:00
|
|
|
## Website preview
|
2020-07-24 19:20:37 +08:00
|
|
|
With command
|
|
|
|
|
```bash
|
2020-09-18 16:15:30 +08:00
|
|
|
$ yarn website-dev
|
2020-07-24 19:20:37 +08:00
|
|
|
```
|
2020-09-18 16:15:30 +08:00
|
|
|
the project will launch website for you to preview all existing component
|
2020-07-24 20:29:10 +08:00
|
|
|
|
2020-09-18 16:15:30 +08:00
|
|
|
You can also use this command to start a blank page to debug
|
|
|
|
|
```bash
|
|
|
|
|
$ yarn website-dev:play
|
|
|
|
|
//source file: ./website/play/index.vue
|
|
|
|
|
```
|
2020-08-03 00:08:01 +08:00
|
|
|
## Component migration process
|
|
|
|
|
1. Convert the item in https://github.com/element-plus/element-plus/projects/1 to an issue
|
|
|
|
|
2. Assign yourself to the issue
|
|
|
|
|
3. Author your component by generating new component command below
|
|
|
|
|
4. Migrate tests and docs
|
|
|
|
|
5. Open a new pull request, fill in the component issue link in 1
|
2020-07-24 20:29:10 +08:00
|
|
|
|
|
|
|
|
## Generate new component
|
|
|
|
|
With command
|
|
|
|
|
```bash
|
|
|
|
|
$ yarn gen component-name
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Note the `component-name` must be in `kebab-case`, combining words by replacing each space with a dash.
|
2020-07-30 10:30:18 +08:00
|
|
|
|
|
|
|
|
## Commit template
|
|
|
|
|
With command
|
|
|
|
|
```bash
|
|
|
|
|
yarn cz
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Example
|
|
|
|
|
```
|
|
|
|
|
[TYPE](SCOPE):DESCRIPTION#[ISSUE]
|
|
|
|
|
# example feat(button):add type 'button' for form usage #1234
|
|
|
|
|
```
|
|
|
|
|
|
