|
1 |
| -# vue3-element-admin |
| 1 | +## 简介 |
2 | 2 |
|
3 |
| -This template should help get you started developing with Vue 3 in Vite. |
| 3 | +这个模板使用了最新的 vue3 和 element-plus UI 框架,vite 构建工具、pinia 状态管理、vue-router 路由管理、mockjs 数据模拟,并集成了 typescript。功能从 Vue Element Admin 移植而来,详细使用可以参考[该文档](https://vue3-element-admin-site.midfar.com/zh/guide/essentials/router-and-nav.html)。 |
4 | 4 |
|
5 |
| -## Recommended IDE Setup |
| 5 | +## 特性 |
6 | 6 |
|
7 |
| -[VSCode](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur). |
| 7 | +- **最新技术栈**:使用 Vue3/vite3 等前端前沿技术开发 |
| 8 | +- **TypeScript**: 应用程序级 JavaScript 的语言 |
| 9 | +- **Mock 数据** 内置 Mock 数据方案 |
| 10 | +- **权限** 内置完善的动态路由权限生成方案 |
| 11 | +- **组件** 二次封装了多个常用的组件 |
8 | 12 |
|
9 |
| -## Type Support for `.vue` Imports in TS |
| 13 | +## 在线示例 |
10 | 14 |
|
11 |
| -TypeScript cannot handle type information for `.vue` imports by default, so we replace the `tsc` CLI with `vue-tsc` for type checking. In editors, we need [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) to make the TypeScript language service aware of `.vue` types. |
| 15 | +[vue3 element admin](https://vue3-element-admin.midfar.com/) |
12 | 16 |
|
13 |
| -## Customize configuration |
| 17 | +[element plus](https://element-plus.midfar.com/) |
14 | 18 |
|
15 |
| -See [Vite Configuration Reference](https://vitejs.dev/config/). |
| 19 | +## 准备 |
| 20 | +开发前请确保熟悉并掌握以下技术栈: |
16 | 21 |
|
17 |
| -## Project Setup |
| 22 | +- vue: https://cn.vuejs.org/ |
| 23 | +- TypeScript:https://www.tslang.cn/index.html |
| 24 | +- element-plus:https://element-plus.midfar.com/ |
| 25 | +- pinia: https://pinia.vuejs.org/zh/ |
| 26 | +- vue-router: https://router.vuejs.org/zh/ |
| 27 | + |
| 28 | +注:开发前请务必阅读上述所有文档。应用至实际项目开发请修改 readme 内容。 |
| 29 | + |
| 30 | +## 推荐的 IDE 工具和插件 |
| 31 | + |
| 32 | +[VSCode](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (禁用 Vetur) + [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin). |
| 33 | + |
| 34 | +## Vite 构建工具配置 |
| 35 | + |
| 36 | +参考 [Vite 配置](https://vitejs.dev/config/). |
| 37 | + |
| 38 | +## 主要结构 |
| 39 | + |
| 40 | +``` |
| 41 | +- mock // 模拟数据 |
| 42 | +- public |
| 43 | +- src |
| 44 | + - components // 组件 |
| 45 | + - views // 页面 |
| 46 | + - tableTemplates // 示例模块 |
| 47 | + - index.ts |
| 48 | + - login // 登录模块 |
| 49 | + - index.vue |
| 50 | + - settings.ts // 全局配置 |
| 51 | + - main.ts // 入口文件 |
| 52 | +- types // TypeScript类型 |
| 53 | +- package.json |
| 54 | +- CODE_OF_CONDUCT.md // 框架开发要求 |
| 55 | +- README.md //框架使用手册 |
| 56 | +``` |
| 57 | + |
| 58 | +## 使用 |
| 59 | + |
| 60 | +### 安装依赖 |
18 | 61 |
|
19 | 62 | ```sh
|
20 | 63 | npm install
|
21 | 64 | ```
|
22 | 65 |
|
23 |
| -### Compile and Hot-Reload for Development |
| 66 | +### 开发模式连接测试服 |
24 | 67 |
|
25 | 68 | ```sh
|
26 |
| -npm run dev |
| 69 | +npm run dev:test |
27 | 70 | ```
|
28 | 71 |
|
29 |
| -### Type-Check, Compile and Minify for Production |
| 72 | +### 打包到测试服 |
30 | 73 |
|
31 | 74 | ```sh
|
32 |
| -npm run build |
| 75 | +npm run build:test |
33 | 76 | ```
|
34 | 77 |
|
35 |
| -### Lint with [ESLint](https://eslint.org/) |
| 78 | +### 代码检查 [ESLint](https://eslint.org/) |
36 | 79 |
|
37 | 80 | ```sh
|
38 | 81 | npm run lint
|
39 | 82 | ```
|
| 83 | + |
| 84 | +## 支持环境 |
| 85 | + |
| 86 | +现代浏览器。 |
| 87 | + |
| 88 | +| IE/Edge | Firefox | Chrome | Safari | |
| 89 | +| ---------------- | --------------- | --------------- | --------------- | |
| 90 | +| IE10, IE11, Edge | last 2 versions | last 2 versions | last 2 versions | |
| 91 | + |
| 92 | +## TODO |
| 93 | + |
| 94 | +当前问题 |
| 95 | + |
| 96 | +- 暂未配置git提交规范。 |
| 97 | + |
| 98 | +## 参与贡献 |
| 99 | + |
| 100 | +我们非常欢迎你的贡献,你可以通过以下方式和我们一起共建基线框架: |
| 101 | + |
| 102 | + |
| 103 | +- 提交 pr |
| 104 | +- 修复 bug |
| 105 | +- 分享实践案例 |
0 commit comments