ckl1 пре 1 година
родитељ
комит
73ce01cab6
4 измењених фајлова са 20 додато и 62 уклоњено
  1. 0 4
      .vitepress/config.js
  2. 5 1
      components/descriptions.md
  3. 9 1
      guide/fqa.md
  4. 6 56
      guide/mock.md

+ 0 - 4
.vitepress/config.js

@@ -282,10 +282,6 @@ function createSidebar() {
             text: 'Error 缺省组件',
             text: 'Error 缺省组件',
             link: '/components/error',
             link: '/components/error',
           },
           },
-          {
-            text: 'Sticky 黏性组件',
-            link: '/components/sticky',
-          },
           {
           {
             text: 'ContentDetailWrap 详情包裹组件',
             text: 'ContentDetailWrap 详情包裹组件',
             link: '/components/content-detail-wrap',
             link: '/components/content-detail-wrap',

+ 5 - 1
components/descriptions.md

@@ -1,6 +1,10 @@
 # Descriptions 描述组件
 # Descriptions 描述组件
 
 
-对 `element-plus` 的 `Descriptions` 组件进行封装。
+::: warning 注意
+从 v2.5.3之后,Descriptions 组件不再基于 `element-plus` 的 `Descriptions` 进行二次封装,所以可能有的属性无法使用,具体可以自行修改或者改造,或者可以提issue。
+:::
+
+~~对 `element-plus` 的 `Descriptions` 组件进行封装。~~
 
 
 Descriptions 组件位于 [src/components/Descriptions](https://github.com/kailong321200875/vue-element-plus-admin/tree/master/src/components/Descriptions) 内
 Descriptions 组件位于 [src/components/Descriptions](https://github.com/kailong321200875/vue-element-plus-admin/tree/master/src/components/Descriptions) 内
 
 

+ 9 - 1
guide/fqa.md

@@ -71,4 +71,12 @@
 
 
 项目中大部分使用了 `tsx` ,所以原先 `template` 的一些代码规范就不适用了,如 `v-if` 得使用 `{判断条件 ? 成立 : 不成立}` 来进行显示隐藏,可以查阅下相关文档。
 项目中大部分使用了 `tsx` ,所以原先 `template` 的一些代码规范就不适用了,如 `v-if` 得使用 `{判断条件 ? 成立 : 不成立}` 来进行显示隐藏,可以查阅下相关文档。
 
 
-并且请确保如果要使用 `tsx` 语法, `script` 是否声明了 `lang="tsx"`
+并且请确保如果要使用 `tsx` 语法, `script` 是否声明了 `lang="tsx"`
+
+## 添加路由之后,页面无法展示
+
+如果是在项目中直接添加静态路由,需要确保 appStore 中的 `dynamicRouter` 和 `serverDynamicRouter` 为 `false`,并且手动清除下浏览器的 `localStorage`
+
+## 添加新的 vue 文件后,编辑器类型报错
+
+这是 `Volar` 插件的问题,一般重启下编辑器即可生效。

+ 6 - 56
guide/mock.md

@@ -23,57 +23,7 @@ server: {
 },
 },
 ```
 ```
 
 
-之后在 [src/config/axios/config.ts](https://github.com/kailong321200875/vue-element-plus-admin/blob/master/src/config/axios/config.ts) 中更改 `base_url.base` 为你所配置的代理即可。
-
-```ts
-const config: {
-  base_url: {
-    base: string
-    dev: string
-    pro: string
-    test: string
-  }
-  result_code: number | string
-  default_headers: AxiosHeaders
-  request_timeout: number
-} = {
-  /**
-   * api请求基础路径
-   */
-  base_url: {
-    // 开发环境接口前缀
-    base: '/api',
-
-    // 打包开发环境接口前缀
-    dev: '',
-
-    // 打包生产环境接口前缀
-    pro: '',
-
-    // 打包测试环境接口前缀
-    test: ''
-  },
-
-  /**
-   * 接口成功返回状态码
-   */
-  result_code: '0000',
-
-  /**
-   * 接口请求超时时间
-   */
-  request_timeout: 60000,
-
-  /**
-   * 默认接口请求类型
-   * 可选值:application/x-www-form-urlencoded multipart/form-data
-   */
-  default_headers: 'application/json'
-}
-
-export { config }
-
-```
+配置接口前缀,可以在对应的 `env` 文件中,修改 `VITE_API_BASE_PATH` 的值
 
 
 ::: tip 注意
 ::: tip 注意
 
 
@@ -100,7 +50,7 @@ export { config }
 :::
 :::
 
 
 ```ts
 ```ts
-import request from '@/config/axios'
+import request from '@/axios'
 import type { TableData } from './types'
 import type { TableData } from './types'
 
 
 export const getTableListApi = (params: any) => {
 export const getTableListApi = (params: any) => {
@@ -160,7 +110,7 @@ export const REQUEST_TIMEOUT = 60000
 
 
 Mock 数据是前端开发过程中必不可少的一环,是分离前后端开发的关键链路。通过预先跟服务器端约定好的接口,模拟请求数据甚至逻辑,能够让前端开发独立自主,不会被服务端的开发进程所阻塞。
 Mock 数据是前端开发过程中必不可少的一环,是分离前后端开发的关键链路。通过预先跟服务器端约定好的接口,模拟请求数据甚至逻辑,能够让前端开发独立自主,不会被服务端的开发进程所阻塞。
 
 
-本项目使用 [vite-plugin-mock-dev-server](https://vite-plugin-mock-dev-server.netlify.app/) 来进行 mock 数据处理。**项目内 mock 服务分本地和线上**。
+本项目使用 [vite-mock-plugin](https://github.com/vbenjs/vite-plugin-mock) 来进行 mock 数据处理。**项目内 mock 服务分本地和线上**。
 
 
 ### 本地 Mock
 ### 本地 Mock
 
 
@@ -180,17 +130,17 @@ Mock 数据是前端开发过程中必不可少的一环,是分离前后端开
 
 
 ::: tip
 ::: tip
 
 
-mock 的值可以直接使用 [fakerjs](https://github.com/faker-js/faker#readme) 的语法。
+mock 的值可以直接使用 [mock.js](http://mockjs.com/) 的语法。
 
 
 :::
 :::
 
 
 #### 接口有了,如何去掉 mock
 #### 接口有了,如何去掉 mock
 
 
-可以在vite.config.ts中删除 `MockDevServerPlugin` 对应的代码。
+可以在对应的 `env` 文件中设置 `VITE_USE_MOCK` 为 `false` ,如果想要更彻底一点,可以在vite.config.ts中删除 `viteMockServe` 对应的代码。
 
 
 
 
 ### 线上 mock
 ### 线上 mock
 
 
 由于该项目是一个展示类项目,线上也是用 mock 数据,所以在打包后同时也集成了 mock。通常项目线上一般为正式接口。
 由于该项目是一个展示类项目,线上也是用 mock 数据,所以在打包后同时也集成了 mock。通常项目线上一般为正式接口。
 
 
-项目线上 mock 采用的是 [fakerjs](https://github.com/faker-js/faker#readme) 进行 mock 数据模拟。
+项目线上 mock 采用的是 [mock.js](http://mockjs.com/) 进行 mock 数据模拟。