af-mobile-client-vue3 1.3.30 → 1.3.32

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (284) hide show
  1. package/.claude/settings.local.json +10 -0
  2. package/.cursorrules +60 -60
  3. package/.editorconfig +9 -9
  4. package/.env +10 -10
  5. package/.env.development +1 -1
  6. package/.env.production +1 -1
  7. package/.node-version +1 -1
  8. package/.vscode/extensions.json +12 -12
  9. package/.vscode/settings.json +68 -66
  10. package/CLAUDE.md +218 -189
  11. package/README.md +182 -182
  12. package/af-example-mobile-vue-web.iml +9 -9
  13. package/build/vite/index.ts +98 -98
  14. package/build/vite/optimize.ts +34 -34
  15. package/build/vite/vconsole.ts +47 -47
  16. package/commitlint.config.ts +32 -32
  17. package/compress.js +36 -36
  18. package/eslint.config.ts +31 -30
  19. package/index.html +23 -23
  20. package/mock/data.ts +20 -20
  21. package/mock/index.ts +7 -7
  22. package/mock/modules/prose.mock.ts +13 -13
  23. package/mock/modules/user.mock.ts +95 -152
  24. package/mock/util.ts +19 -19
  25. package/netlify.toml +12 -12
  26. package/package.json +135 -114
  27. package/postcss.config.ts +27 -27
  28. package/public/favicon.svg +4 -4
  29. package/public/safari-pinned-tab.svg +4 -4
  30. package/scripts/verifyCommit.js +19 -19
  31. package/src/App.vue +79 -79
  32. package/src/api/auth/index.ts +77 -0
  33. package/src/api/auth/types.ts +200 -0
  34. package/src/api/mock/index.ts +30 -30
  35. package/src/api/user/index.ts +40 -40
  36. package/src/assets/img/user/login/background-shadow-1.svg +20 -20
  37. package/src/assets/img/user/login/logo-background.svg +20 -20
  38. package/src/bootstrap.ts +26 -26
  39. package/src/components/core/BeautifulLoading/index.vue +52 -52
  40. package/src/components/core/ImageUploader/index.vue +251 -251
  41. package/src/components/core/NavBar/index.vue +53 -53
  42. package/src/components/core/Tabbar/index.vue +32 -32
  43. package/src/components/core/Uploader/index.vue +124 -124
  44. package/src/components/core/XGridDropOption/index.vue +154 -154
  45. package/src/components/core/XMultiSelect/index.vue +183 -183
  46. package/src/components/core/XSelect/index.vue +149 -149
  47. package/src/components/data/CardContainer/CardContainer.vue +118 -118
  48. package/src/components/data/CardContainer/CardHeader.vue +99 -99
  49. package/src/components/data/InfoDisplay/index.vue +132 -132
  50. package/src/components/data/UserDetail/api.ts +24 -24
  51. package/src/components/data/UserDetail/index.vue +620 -620
  52. package/src/components/data/UserDetail/recordEntries.ts +159 -159
  53. package/src/components/data/UserDetail/types.ts +26 -26
  54. package/src/components/data/XBadge/index.vue +82 -82
  55. package/src/components/data/XCellDetail/index.vue +105 -105
  56. package/src/components/data/XCellList/XCellList.md +432 -432
  57. package/src/components/data/XCellList/index.vue +1436 -1436
  58. package/src/components/data/XCellListFilter/QrScanner/index.vue +207 -207
  59. package/src/components/data/XCellListFilter/QrScanner/startScanAnimation.ts +53 -53
  60. package/src/components/data/XCellListFilter/VpnRecognition/index.vue +119 -119
  61. package/src/components/data/XCellListFilter/index.vue +705 -705
  62. package/src/components/data/XForm/index.vue +659 -659
  63. package/src/components/data/XFormGroup/doc/DeviceForm.vue +122 -122
  64. package/src/components/data/XFormGroup/doc/FormGroupDemo.vue +56 -56
  65. package/src/components/data/XFormGroup/doc/README.md +286 -286
  66. package/src/components/data/XFormGroup/doc/UserForm.vue +102 -102
  67. package/src/components/data/XFormGroup/index.vue +240 -240
  68. package/src/components/data/XFormItem/index.vue +1310 -1310
  69. package/src/components/data/XOlMap/README.md +227 -227
  70. package/src/components/data/XOlMap/XLocationPicker/index.vue +226 -226
  71. package/src/components/data/XOlMap/index.vue +1490 -1490
  72. package/src/components/data/XOlMap/types.ts +149 -149
  73. package/src/components/data/XOlMap/utils/{wgs84ToGcj02.js → wgs84ToGcj02.ts} +171 -154
  74. package/src/components/data/XReportForm/DateTimeSecondsPicker.vue +208 -208
  75. package/src/components/data/XReportForm/XReportFormJsonRender.vue +220 -220
  76. package/src/components/data/XReportForm/index.vue +1393 -1393
  77. package/src/components/data/XReportGrid/XAddReport/XAddReport.vue +198 -198
  78. package/src/components/data/XReportGrid/XAddReport/index.js +3 -3
  79. package/src/components/data/XReportGrid/XAddReport/index.md +53 -53
  80. package/src/components/data/XReportGrid/XAddReport/index.ts +10 -10
  81. package/src/components/data/XReportGrid/XReport.vue +960 -960
  82. package/src/components/data/XReportGrid/XReportDemo.vue +33 -33
  83. package/src/components/data/XReportGrid/XReportDesign.vue +597 -597
  84. package/src/components/data/XReportGrid/XReportDrawer/XReportDrawer.vue +148 -148
  85. package/src/components/data/XReportGrid/XReportDrawer/index.js +3 -3
  86. package/src/components/data/XReportGrid/XReportDrawer/index.ts +10 -10
  87. package/src/components/data/XReportGrid/XReportJsonRender.vue +399 -399
  88. package/src/components/data/XReportGrid/XReportTrGroup.vue +592 -592
  89. package/src/components/data/XReportGrid/index.md +46 -46
  90. package/src/components/data/XReportGrid/print.js +184 -184
  91. package/src/components/data/XSignature/index.vue +284 -284
  92. package/src/components/data/XTag/index.vue +10 -10
  93. package/src/components/layout/NormalDataLayout/index.vue +69 -69
  94. package/src/components/layout/TabBarLayout/index.vue +40 -40
  95. package/src/composables/dark.ts +5 -5
  96. package/src/config/routes.ts +9 -9
  97. package/src/constants/index.ts +2 -2
  98. package/src/enums/requestEnum.ts +25 -25
  99. package/src/expression/ExpressionRunner.ts +28 -28
  100. package/src/expression/TestExpression.ts +510 -510
  101. package/src/expression/core/Delegate.ts +116 -116
  102. package/src/expression/core/Expression.ts +1359 -1359
  103. package/src/expression/core/Program.ts +985 -985
  104. package/src/expression/core/Token.ts +29 -29
  105. package/src/expression/enums/ExpressionType.ts +81 -81
  106. package/src/expression/enums/TokenType.ts +11 -11
  107. package/src/expression/exception/BreakWayException.ts +2 -2
  108. package/src/expression/exception/ContinueWayException.ts +2 -2
  109. package/src/expression/exception/ExpressionException.ts +29 -29
  110. package/src/expression/exception/ReturnWayException.ts +14 -14
  111. package/src/expression/exception/ServiceException.ts +22 -22
  112. package/src/expression/instances/JSONArray.ts +52 -52
  113. package/src/expression/instances/JSONObject.ts +118 -118
  114. package/src/expression/instances/LogicConsole.ts +31 -31
  115. package/src/font-style/font.css +4 -4
  116. package/src/hooks/useBoolean.ts +26 -26
  117. package/src/hooks/useCommon.ts +9 -9
  118. package/src/hooks/useLoading.ts +16 -16
  119. package/src/hooks/useLogin.ts +97 -97
  120. package/src/icons/svg/check-in.svg +32 -32
  121. package/src/icons/svg/dark.svg +4 -4
  122. package/src/icons/svg/github.svg +4 -4
  123. package/src/icons/svg/light.svg +4 -4
  124. package/src/icons/svg/link.svg +4 -4
  125. package/src/icons/svgo.yml +22 -22
  126. package/src/index.ts +4 -0
  127. package/src/layout/GridView/index.vue +16 -16
  128. package/src/layout/PageLayout.vue +9 -9
  129. package/src/layout/SingleLayout.vue +9 -9
  130. package/src/locales/en-US.json +128 -128
  131. package/src/locales/zh-CN.json +128 -128
  132. package/src/logic/LogicRunner.ts +67 -67
  133. package/src/logic/TestLogic.ts +13 -13
  134. package/src/logic/plugins/common/DateTools.ts +35 -35
  135. package/src/logic/plugins/common/VueTools.ts +30 -30
  136. package/src/logic/plugins/index.ts +7 -7
  137. package/src/main.ts +44 -44
  138. package/src/plugins/AppData.ts +38 -38
  139. package/src/plugins/GetLoginInfoService.ts +10 -10
  140. package/src/plugins/collectIcons.ts +10 -10
  141. package/src/plugins/index.ts +11 -11
  142. package/src/router/README.md +8 -8
  143. package/src/router/external-routes.ts +60 -0
  144. package/src/router/guards.ts +131 -59
  145. package/src/router/index.ts +35 -35
  146. package/src/router/invoiceRoutes.ts +33 -33
  147. package/src/router/routes.ts +426 -347
  148. package/src/services/api/Login.ts +6 -6
  149. package/src/services/api/common.ts +109 -109
  150. package/src/services/api/index.ts +7 -7
  151. package/src/services/api/manage.ts +8 -8
  152. package/src/services/api/search.ts +16 -16
  153. package/src/services/api/user.ts +17 -17
  154. package/src/services/restTools.ts +56 -56
  155. package/src/services/v3Api.ts +147 -147
  156. package/src/stores/index.ts +13 -13
  157. package/src/stores/modules/counter.ts +19 -19
  158. package/src/stores/modules/homeApp.ts +55 -55
  159. package/src/stores/modules/routeCache.ts +22 -23
  160. package/src/stores/modules/setting.ts +87 -87
  161. package/src/stores/modules/user.ts +326 -235
  162. package/src/stores/mutation-type.ts +12 -7
  163. package/src/styles/app.less +36 -36
  164. package/src/styles/login.less +109 -109
  165. package/src/styles/var.less +25 -25
  166. package/src/types/auth.ts +85 -0
  167. package/src/types/env.d.ts +16 -16
  168. package/src/types/platform.ts +194 -0
  169. package/src/types/settings.ts +1 -1
  170. package/src/types/vue-router.d.ts +13 -9
  171. package/src/utils/Storage.ts +124 -124
  172. package/src/utils/authority-utils.ts +84 -84
  173. package/src/utils/common.ts +41 -41
  174. package/src/utils/crypto.ts +39 -39
  175. package/src/utils/dataUtil.ts +42 -42
  176. package/src/utils/dictUtil.ts +52 -52
  177. package/src/utils/http/index.ts +201 -199
  178. package/src/utils/i18n.ts +72 -72
  179. package/src/utils/indexedDB.ts +195 -195
  180. package/src/utils/inline-px-to-vw.ts +28 -28
  181. package/src/utils/mobileUtil.ts +33 -34
  182. package/src/utils/platform-auth.ts +134 -0
  183. package/src/utils/progress.ts +19 -19
  184. package/src/utils/routerUtil.ts +271 -271
  185. package/src/utils/runEvalFunction.ts +13 -13
  186. package/src/utils/secureStorage.ts +70 -71
  187. package/src/utils/set-page-title.ts +5 -5
  188. package/src/utils/validate.ts +6 -6
  189. package/src/views/chat/index.vue +153 -153
  190. package/src/views/common/Forbidden.vue +97 -0
  191. package/src/views/common/LoadError.vue +63 -63
  192. package/src/views/common/NotFound.vue +67 -67
  193. package/src/views/component/EvaluateRecordView/index.vue +40 -40
  194. package/src/views/component/IconifyView/index.vue +504 -504
  195. package/src/views/component/UserDetailView/UserDetailPage.vue +77 -77
  196. package/src/views/component/UserDetailView/index.vue +234 -234
  197. package/src/views/component/XCellDetailView/index.vue +217 -217
  198. package/src/views/component/XCellListView/index.vue +108 -129
  199. package/src/views/component/XFormAppraiseView/index.vue +174 -174
  200. package/src/views/component/XFormGroupView/index.vue +78 -82
  201. package/src/views/component/XFormView/index.vue +27 -27
  202. package/src/views/component/XOlMapView/XLocationPicker/index.vue +118 -118
  203. package/src/views/component/XOlMapView/index.vue +434 -434
  204. package/src/views/component/XOlMapView/testData.ts +64 -64
  205. package/src/views/component/XReportFormIframeView/index.vue +47 -47
  206. package/src/views/component/XReportFormView/index.vue +13 -13
  207. package/src/views/component/XReportGridView/index.vue +17 -17
  208. package/src/views/component/XRequestView/index.vue +234 -234
  209. package/src/views/component/XSignatureView/index.vue +50 -50
  210. package/src/views/component/index.vue +181 -181
  211. package/src/views/component/menu.vue +117 -117
  212. package/src/views/component/notice.vue +46 -46
  213. package/src/views/component/topNav.vue +36 -36
  214. package/src/views/external/index.vue +152 -0
  215. package/src/views/invoiceShow/index.vue +61 -61
  216. package/src/views/loading/AuthLoading.vue +345 -0
  217. package/src/views/user/login/ForgetPasswordForm.vue +94 -94
  218. package/src/views/user/login/LoginForm.vue +350 -347
  219. package/src/views/user/login/LoginTitle.vue +76 -76
  220. package/src/views/user/login/LoginWave.vue +109 -109
  221. package/src/views/user/login/index.vue +22 -22
  222. package/src/views/user/my/comm/ModifyPassword.vue +346 -346
  223. package/src/views/user/my/index.vue +507 -507
  224. package/src/views/user/register/index.vue +952 -952
  225. package/src/views/userRecords/AbnormalAlarmRecords.vue +21 -21
  226. package/src/views/userRecords/CardReplacementRecords.vue +21 -21
  227. package/src/views/userRecords/ChangeRecords.vue +19 -19
  228. package/src/views/userRecords/CommandViewRecords.vue +20 -20
  229. package/src/views/userRecords/GasCompensationRecords.vue +20 -20
  230. package/src/views/userRecords/InstrumentCollectionRecords.vue +21 -21
  231. package/src/views/userRecords/MeterRecords.vue +20 -20
  232. package/src/views/userRecords/OperateRecords.vue +51 -51
  233. package/src/views/userRecords/OtherChargeRecords.vue +19 -19
  234. package/src/views/userRecords/PaymentRecords.vue +28 -28
  235. package/src/views/userRecords/PriceAdjustmentRecords.vue +19 -19
  236. package/src/views/userRecords/ReplacementRecords.vue +19 -19
  237. package/src/views/userRecords/SafetyRecords.vue +19 -19
  238. package/src/views/userRecords/TransactionRecords.vue +21 -21
  239. package/src/views/userRecords/TransferRecords.vue +19 -19
  240. package/src/views/userRecords/operateRecordDetail/index.vue +316 -316
  241. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/AddUserDetail.vue +124 -124
  242. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/AdvanceDeliveryDetail.vue +88 -88
  243. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/AutoAccountsCancelDetail.vue +205 -205
  244. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/AutoAccountsDetail.vue +192 -192
  245. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/BankDkDetail.vue +192 -192
  246. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/BankPayDetail.vue +192 -192
  247. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/BlacklistDetail.vue +153 -153
  248. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/CancellationDetail.vue +101 -101
  249. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/CardMeterCenterCancelDetail.vue +127 -127
  250. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/CardMeterCenterDetail.vue +153 -153
  251. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/CardOverUserDetail.vue +153 -153
  252. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/ChangeMeterCancelDetail.vue +166 -166
  253. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/ChangeMeterDetail.vue +205 -205
  254. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/DisableManageDetail.vue +127 -127
  255. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/EnableManageDetail.vue +114 -114
  256. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/FaZheChangeDetail.vue +124 -124
  257. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/FeeDeductionDetail.vue +153 -153
  258. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/GasPriceChangeDetail.vue +126 -126
  259. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/InputtorChangeDetail.vue +126 -126
  260. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/IotMeterCenterCancelDetail.vue +114 -114
  261. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/IotMeterCenterDetail.vue +127 -127
  262. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/IotOpenDetail.vue +88 -88
  263. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/MachineCardDetail.vue +101 -101
  264. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/MachineMeterCenterCancelDetail.vue +218 -218
  265. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/MachineMeterCenterDetail.vue +153 -153
  266. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/OffGasAddGasDetail.vue +140 -140
  267. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/OtherChargeCancelDetail.vue +127 -127
  268. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/OtherChargeDetail.vue +114 -114
  269. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/OverUserChangeDetail.vue +127 -127
  270. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/ReBillDetail.vue +127 -127
  271. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/RefundDetail.vue +114 -114
  272. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/ReplaceCardManageCancelDetail.vue +127 -127
  273. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/ReplaceCardManageDetail.vue +114 -114
  274. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/SaleCardGasDetail.vue +140 -140
  275. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/TransferManageCancelDetail.vue +152 -152
  276. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/TransferManageDetail.vue +178 -178
  277. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/UserChangeDetail.vue +123 -123
  278. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/WechatPayDetail.vue +192 -192
  279. package/src/views/userRecords/types.ts +66 -66
  280. package/tsconfig.json +39 -39
  281. package/uno.config.ts +82 -82
  282. package/vite.config.ts +119 -118
  283. package/src/router/types.ts +0 -7
  284. package/src/utils/wechatUtil.ts +0 -9
package/README.md CHANGED
@@ -1,182 +1,182 @@
1
- <h1 align="center">af-system-mobile-vue-web</h1>
2
-
3
- <p align="center">基于v4架构的vue移动端主应用</p>
4
-
5
- <h1 align="center">介绍</h1>
6
-
7
- 🔥 脚手架选用Vue3-Vant-Mobile,一个集成 Vue3、Vite5、Vant4、Pinia2、Vitest、TypeScript 构建的集成最新技术栈、完整干净的移动端模板 -> [Github](https://github.com/CharleeWa/vue3-vant-mobile)
8
-
9
- 🔥 UI框架选用Vant4,有赞团队开发的轻量、可定制的移动端 Vue 组件库 -> [官网](https://vant-contrib.gitee.io/vant/#/zh-CN)
10
-
11
- <h1 align="center">使用指南</h1>
12
-
13
- <p align="center">指南非常地详细,并非说明上手多么地复杂,只是更好地使用它做的说明而已</p>
14
-
15
- ## 需要注意的地方
16
-
17
- - 本项目作为微前端框架micro-app的主应用,虽然同样派生自example项目,但example项目主要用于子应用的快速建设,因此本项目在微前端接入代码方面和example表现不一致
18
-
19
- ## 特性
20
-
21
- - 🌓 支持暗黑模式
22
- - 💪 使用TypeScript编写
23
- - 🚀 Vue3 生态开箱即用
24
- - 🤖 自动导入组件
25
- - 📦 使用pnpm包管理器
26
- - 💾 支持Mock服务器
27
- - 🌈 支持Git hooks(lint和commit)
28
- - 💖 移动端UI组件(Vant4)
29
- - 🍍 Pinia,Vue的状态管理库
30
-
31
- ### 包管理器
32
-
33
- 推荐使用 [pnpm](https://pnpm.io/) 来进行包管理,可以极大地减少install时间, 而且非常节省磁盘空间。
34
-
35
- ### 目录结构
36
-
37
- 下面是模板的主要目录结构和一些简要地说明。
38
-
39
- ```
40
- ├── src
41
- │ ├── api # Api ajax 等
42
- │ ├── assets # 本地静态资源
43
- │ ├── layouts # 封装布局组件
44
- │ ├── components # 业务通用组件和基础布局组件
45
- │ ├── router # Vue-Router
46
- │ ├── store # Pinia
47
- │ ├── utils # 工具库
48
- │ ├── views # 业务页面入口和常用模板
49
- │ ├── App.vue # Vue 模板入口
50
- │ └── main.ts # Vue 入口 JS
51
- │ └── app.less # 全局样式
52
- │ └── env.d.ts # 全局公用 TypeScript 类型
53
- ├── build/mock # mock 服务
54
- ├── mock # mock 数据
55
- ├── public # 静态文件
56
- ├── scripts # 公共执行脚本
57
- ├── tests # 单元测试
58
- ├── auto-imports.d.ts # Vue3 组合式API 类型声明文件
59
- ├── components.d.ts # 组件自注册类型声明文件
60
- ├── vite.config.ts # Vite 配置文件
61
- ├── tsconfig.json # TS 配置文件
62
- ├── index.html # 浏览器渲染入口
63
- ├── README.md # 简单介绍
64
- └── package.json # 项目的依赖
65
- ```
66
-
67
- ### 本地开发
68
-
69
- 最快的使用方式是在本项目的gitlab主页点击`派生`按钮,即可复制一份本项目结构
70
-
71
- 随后请按照以下步骤完成对项目的修改
72
-
73
- 1. 将`app.less`,`main.ts`,`progress.ts`,`vite.config.ts`,`index.html`中的`#example-app`改成你的业务模块实际名称,如`#safecheck-app`
74
- 2. 将`.env`中的`VITE_APP_PUBLIC_PATH`值改成你的业务模块实际名称,如`/safecheck-web`
75
- 3. 将`package.json`中的`af-example-mobile-vue-web`改成你的项目实际名称,如`af-safecheck-mobile-vue-web`
76
- 4. 在`af-system-mobile-vue-web`项目的`microApps.ts`文件中注册微应用
77
-
78
- 进入代码目录,安装项目的依赖。
79
-
80
- ```bash
81
- # with pnpm
82
- pnpm install
83
- ```
84
-
85
- > 如果网络状况不佳,可以设置 pnpm 的 npm 加载源,如 pnpm config set registry <https://registry.npmmirror.com>
86
-
87
- 完成前面的步骤以后,就可以开始进行业务开发了。
88
-
89
- - 启动服务
90
-
91
- ```bash
92
- pnpm dev
93
- ```
94
-
95
- - 打包构建
96
-
97
- ```bash
98
- pnpm build
99
- ```
100
-
101
- ## 浏览器支持
102
-
103
- 支持现代浏览器
104
-
105
- | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>IE | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari |
106
- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
107
- | not support | last 2 versions | last 2 versions | last 2 versions | last 2 versions |
108
-
109
- ### 新增页面
110
-
111
- 这里的『页面』指配置了路由,能够通过链接直接访问的模块,要新建一个页面,通常只需要在脚手架的基础上进行简单的配置。
112
-
113
- - 手动创建
114
-
115
- 在 src/views 下新建页面的vue文件,如果相关页面有多个,可以新建一个文件夹来放置相关文件。
116
-
117
- 值得提醒的是,样式文件默认使用 `Less`,如果想要集成其它预处理器,如 `Sass` 和 `Stylus`,请自行安装。
118
-
119
- 最后,记得将新建的文件加入路由 - router/index.ts
120
-
121
- ### 新增业务组件
122
-
123
- 对于一些可能被多处引用的功能模块,建议提炼成业务组件统一管理。这些组件一般有以下特征:
124
-
125
- - 只负责一块相对独立,稳定的功能;
126
- - 没有单独的路由配置;
127
- - 可能是纯静态的,也可能包含自己的 state,但不涉及 pinia 的数据流,仅受父组件(通常是一个页面)传递的参数控制。
128
-
129
- 这里以一个简单的静态组件为例进行介绍。假设你的应用中经常需要展现图片,这些图片有固定的高度和宽度,有背景颜色,还有一段文字介绍。你可以用一个组件来实现这个功能,它有默认的样式,同时可以接收父组件传递过来的参数进行展示。
130
-
131
- - 1、新建文件
132
-
133
- 在 src/components 下新建一个以组件名命名的文件夹,注意首字母大写,命名尽量体现组件的功能,这里就叫 image-wrapper。在此文件夹下新增 js/ts/vue 文件及样式文件(如果需要),命名为 index.ts和 index.less。
134
-
135
- > 如果你的组件比较复杂,可以分为多个文件,最后在 index.ts 中统一 export。
136
-
137
- 你的代码大概是这个样子:
138
-
139
- ```
140
- <template>
141
- <div class="image-wrapper">
142
- <img class="img" :src="src" :alt="desc" />
143
- <!-- 如果使用该组件的使用者没用 slot,则默认 div.desc 来输出传递的 desc 属性 -->
144
- <slot name="desc">
145
- <div class="desc" v-if="desc">{{ desc }}</div>
146
- </slot>
147
- </div>
148
- </template>
149
-
150
- <script setup lang="ts">
151
- const props = defineProps({
152
- src: String,
153
- desc: String,
154
- })
155
- </script>
156
- ```
157
-
158
- - 2、使用
159
-
160
- 在要使用这个组件的地方,按照组件定义的 API 传入参数,直接使用就好:
161
-
162
- ```
163
- <template>
164
- <!-- 普通使用方式 -->
165
- <image-wrapper :src="state.imageSrc" :desc="state.context"></image-wrapper>
166
- <!-- 使用 slot 的 desc 方式 -->
167
- <image-wrapper :src="state.imageSrc">
168
- <template #desc>
169
- <span>{{ state.context }}</span>
170
- </template>
171
- </image-wrapper>
172
- </template>
173
-
174
- <script setup lang="ts">
175
- const state = reactive({
176
- context: '示意图',
177
- imageSrc: 'xxxxxxxxx.png'
178
- })
179
- </script>
180
- ```
181
-
182
- 值得说明的是,我们不必先引入组件再使用组件,也不必先引入Vue3 API再使用API,因为这一切都由 `unplugin-vue-components` 和 `unplugin-auto-import` 帮我们做好了。
1
+ <h1 align="center">af-system-mobile-vue-web</h1>
2
+
3
+ <p align="center">基于v4架构的vue移动端主应用</p>
4
+
5
+ <h1 align="center">介绍</h1>
6
+
7
+ 🔥 脚手架选用Vue3-Vant-Mobile,一个集成 Vue3、Vite5、Vant4、Pinia2、Vitest、TypeScript 构建的集成最新技术栈、完整干净的移动端模板 -> [Github](https://github.com/CharleeWa/vue3-vant-mobile)
8
+
9
+ 🔥 UI框架选用Vant4,有赞团队开发的轻量、可定制的移动端 Vue 组件库 -> [官网](https://vant-contrib.gitee.io/vant/#/zh-CN)
10
+
11
+ <h1 align="center">使用指南</h1>
12
+
13
+ <p align="center">指南非常地详细,并非说明上手多么地复杂,只是更好地使用它做的说明而已</p>
14
+
15
+ ## 需要注意的地方
16
+
17
+ - 本项目作为微前端框架micro-app的主应用,虽然同样派生自example项目,但example项目主要用于子应用的快速建设,因此本项目在微前端接入代码方面和example表现不一致
18
+
19
+ ## 特性
20
+
21
+ - 🌓 支持暗黑模式
22
+ - 💪 使用TypeScript编写
23
+ - 🚀 Vue3 生态开箱即用
24
+ - 🤖 自动导入组件
25
+ - 📦 使用pnpm包管理器
26
+ - 💾 支持Mock服务器
27
+ - 🌈 支持Git hooks(lint和commit)
28
+ - 💖 移动端UI组件(Vant4)
29
+ - 🍍 Pinia,Vue的状态管理库
30
+
31
+ ### 包管理器
32
+
33
+ 推荐使用 [pnpm](https://pnpm.io/) 来进行包管理,可以极大地减少install时间, 而且非常节省磁盘空间。
34
+
35
+ ### 目录结构
36
+
37
+ 下面是模板的主要目录结构和一些简要地说明。
38
+
39
+ ```
40
+ ├── src
41
+ │ ├── api # Api ajax 等
42
+ │ ├── assets # 本地静态资源
43
+ │ ├── layouts # 封装布局组件
44
+ │ ├── components # 业务通用组件和基础布局组件
45
+ │ ├── router # Vue-Router
46
+ │ ├── store # Pinia
47
+ │ ├── utils # 工具库
48
+ │ ├── views # 业务页面入口和常用模板
49
+ │ ├── App.vue # Vue 模板入口
50
+ │ └── main.ts # Vue 入口 JS
51
+ │ └── app.less # 全局样式
52
+ │ └── env.d.ts # 全局公用 TypeScript 类型
53
+ ├── build/mock # mock 服务
54
+ ├── mock # mock 数据
55
+ ├── public # 静态文件
56
+ ├── scripts # 公共执行脚本
57
+ ├── tests # 单元测试
58
+ ├── auto-imports.d.ts # Vue3 组合式API 类型声明文件
59
+ ├── components.d.ts # 组件自注册类型声明文件
60
+ ├── vite.config.ts # Vite 配置文件
61
+ ├── tsconfig.json # TS 配置文件
62
+ ├── index.html # 浏览器渲染入口
63
+ ├── README.md # 简单介绍
64
+ └── package.json # 项目的依赖
65
+ ```
66
+
67
+ ### 本地开发
68
+
69
+ 最快的使用方式是在本项目的gitlab主页点击`派生`按钮,即可复制一份本项目结构
70
+
71
+ 随后请按照以下步骤完成对项目的修改
72
+
73
+ 1. 将`app.less`,`main.ts`,`progress.ts`,`vite.config.ts`,`index.html`中的`#example-app`改成你的业务模块实际名称,如`#safecheck-app`
74
+ 2. 将`.env`中的`VITE_APP_PUBLIC_PATH`值改成你的业务模块实际名称,如`/safecheck-web`
75
+ 3. 将`package.json`中的`af-example-mobile-vue-web`改成你的项目实际名称,如`af-safecheck-mobile-vue-web`
76
+ 4. 在`af-system-mobile-vue-web`项目的`microApps.ts`文件中注册微应用
77
+
78
+ 进入代码目录,安装项目的依赖。
79
+
80
+ ```bash
81
+ # with pnpm
82
+ pnpm install
83
+ ```
84
+
85
+ > 如果网络状况不佳,可以设置 pnpm 的 npm 加载源,如 pnpm config set registry <https://registry.npmmirror.com>
86
+
87
+ 完成前面的步骤以后,就可以开始进行业务开发了。
88
+
89
+ - 启动服务
90
+
91
+ ```bash
92
+ pnpm dev
93
+ ```
94
+
95
+ - 打包构建
96
+
97
+ ```bash
98
+ pnpm build
99
+ ```
100
+
101
+ ## 浏览器支持
102
+
103
+ 支持现代浏览器
104
+
105
+ | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>IE | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png" alt=" Edge" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Edge | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png" alt="Firefox" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Firefox | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png" alt="Chrome" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Chrome | [<img src="https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png" alt="Safari" width="24px" height="24px" />](http://godban.github.io/browsers-support-badges/)</br>Safari |
106
+ | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |
107
+ | not support | last 2 versions | last 2 versions | last 2 versions | last 2 versions |
108
+
109
+ ### 新增页面
110
+
111
+ 这里的『页面』指配置了路由,能够通过链接直接访问的模块,要新建一个页面,通常只需要在脚手架的基础上进行简单的配置。
112
+
113
+ - 手动创建
114
+
115
+ 在 src/views 下新建页面的vue文件,如果相关页面有多个,可以新建一个文件夹来放置相关文件。
116
+
117
+ 值得提醒的是,样式文件默认使用 `Less`,如果想要集成其它预处理器,如 `Sass` 和 `Stylus`,请自行安装。
118
+
119
+ 最后,记得将新建的文件加入路由 - router/index.ts
120
+
121
+ ### 新增业务组件
122
+
123
+ 对于一些可能被多处引用的功能模块,建议提炼成业务组件统一管理。这些组件一般有以下特征:
124
+
125
+ - 只负责一块相对独立,稳定的功能;
126
+ - 没有单独的路由配置;
127
+ - 可能是纯静态的,也可能包含自己的 state,但不涉及 pinia 的数据流,仅受父组件(通常是一个页面)传递的参数控制。
128
+
129
+ 这里以一个简单的静态组件为例进行介绍。假设你的应用中经常需要展现图片,这些图片有固定的高度和宽度,有背景颜色,还有一段文字介绍。你可以用一个组件来实现这个功能,它有默认的样式,同时可以接收父组件传递过来的参数进行展示。
130
+
131
+ - 1、新建文件
132
+
133
+ 在 src/components 下新建一个以组件名命名的文件夹,注意首字母大写,命名尽量体现组件的功能,这里就叫 image-wrapper。在此文件夹下新增 js/ts/vue 文件及样式文件(如果需要),命名为 index.ts和 index.less。
134
+
135
+ > 如果你的组件比较复杂,可以分为多个文件,最后在 index.ts 中统一 export。
136
+
137
+ 你的代码大概是这个样子:
138
+
139
+ ```
140
+ <template>
141
+ <div class="image-wrapper">
142
+ <img class="img" :src="src" :alt="desc" />
143
+ <!-- 如果使用该组件的使用者没用 slot,则默认 div.desc 来输出传递的 desc 属性 -->
144
+ <slot name="desc">
145
+ <div class="desc" v-if="desc">{{ desc }}</div>
146
+ </slot>
147
+ </div>
148
+ </template>
149
+
150
+ <script setup lang="ts">
151
+ const props = defineProps({
152
+ src: String,
153
+ desc: String,
154
+ })
155
+ </script>
156
+ ```
157
+
158
+ - 2、使用
159
+
160
+ 在要使用这个组件的地方,按照组件定义的 API 传入参数,直接使用就好:
161
+
162
+ ```
163
+ <template>
164
+ <!-- 普通使用方式 -->
165
+ <image-wrapper :src="state.imageSrc" :desc="state.context"></image-wrapper>
166
+ <!-- 使用 slot 的 desc 方式 -->
167
+ <image-wrapper :src="state.imageSrc">
168
+ <template #desc>
169
+ <span>{{ state.context }}</span>
170
+ </template>
171
+ </image-wrapper>
172
+ </template>
173
+
174
+ <script setup lang="ts">
175
+ const state = reactive({
176
+ context: '示意图',
177
+ imageSrc: 'xxxxxxxxx.png'
178
+ })
179
+ </script>
180
+ ```
181
+
182
+ 值得说明的是,我们不必先引入组件再使用组件,也不必先引入Vue3 API再使用API,因为这一切都由 `unplugin-vue-components` 和 `unplugin-auto-import` 帮我们做好了。
@@ -1,9 +1,9 @@
1
- <?xml version="1.0" encoding="UTF-8"?>
2
- <module type="WEB_MODULE" version="4">
3
- <component name="NewModuleRootManager" inherit-compiler-output="true">
4
- <exclude-output />
5
- <content url="file://$MODULE_DIR$" />
6
- <orderEntry type="inheritedJdk" />
7
- <orderEntry type="sourceFolder" forTests="false" />
8
- </component>
9
- </module>
1
+ <?xml version="1.0" encoding="UTF-8"?>
2
+ <module type="WEB_MODULE" version="4">
3
+ <component name="NewModuleRootManager" inherit-compiler-output="true">
4
+ <exclude-output />
5
+ <content url="file://$MODULE_DIR$" />
6
+ <orderEntry type="inheritedJdk" />
7
+ <orderEntry type="sourceFolder" forTests="false" />
8
+ </component>
9
+ </module>
@@ -1,98 +1,98 @@
1
- import { dirname, resolve } from 'node:path'
2
-
3
- import process from 'node:process'
4
- import { fileURLToPath } from 'node:url'
5
- import VueI18nPlugin from '@intlify/unplugin-vue-i18n/vite'
6
- import legacy from '@vitejs/plugin-legacy'
7
- import vue from '@vitejs/plugin-vue'
8
- import UnoCSS from 'unocss/vite'
9
- import { loadEnv } from 'vite'
10
- import viteCompression from 'vite-plugin-compression'
11
- import { mockDevServerPlugin } from 'vite-plugin-mock-dev-server'
12
- import { VitePWA } from 'vite-plugin-pwa'
13
- import Sitemap from 'vite-plugin-sitemap'
14
- import VueDevTools from 'vite-plugin-vue-devtools'
15
- import { createViteVConsole } from './vconsole'
16
-
17
- export function createVitePlugins(mode: string) {
18
- const env = loadEnv(mode, process.cwd())
19
-
20
- return [
21
- vue({
22
- template: {
23
- compilerOptions: {
24
- // 注册自定义组件micro-app 防止控制台警告
25
- isCustomElement: tag => tag.startsWith('micro-app'),
26
- },
27
- },
28
- }),
29
-
30
- // https://github.com/jbaubree/vite-plugin-sitemap
31
- Sitemap({
32
- outDir: `./dist/${env.VITE_APP_OUT_DIR}`,
33
- }),
34
-
35
- // https://github.com/pengzhanbo/vite-plugin-mock-dev-server
36
- mockDevServerPlugin(),
37
-
38
- // 生产环境 gzip 压缩资源
39
- viteCompression({
40
- algorithm: 'gzip',
41
- // 文件大于10240b(10kb)时才压缩文件
42
- threshold: 10240,
43
- // 禁止在控制台输出压缩结果
44
- verbose: false,
45
- // 压缩完文件后删除源文件
46
- deleteOriginFile: false,
47
- }),
48
-
49
- // https://github.com/intlify/bundle-tools/tree/main/packages/unplugin-vue-i18n
50
- VueI18nPlugin({
51
- // locale messages resource pre-compile option
52
- include: resolve(dirname(fileURLToPath(import.meta.url)), '../../src/locales/**'),
53
- }),
54
-
55
- legacy({
56
- targets: ['defaults', 'not IE 11'],
57
- }),
58
-
59
- // https://github.com/antfu/unocss
60
- // see uno.config.ts for config
61
- UnoCSS(),
62
-
63
- // https://github.com/vadxq/vite-plugin-vconsole
64
- createViteVConsole(mode),
65
-
66
- // https://github.com/vuejs/devtools-next
67
- VueDevTools(),
68
-
69
- // https://github.com/antfu/vite-plugin-pwa
70
- VitePWA({
71
- registerType: 'autoUpdate',
72
- includeAssets: ['favicon.svg', 'safari-pinned-tab.svg'],
73
- manifest: {
74
- name: 'af-mobile-client-vue3',
75
- short_name: 'af-mobile-client-vue3',
76
- theme_color: '#ffffff',
77
- icons: [
78
- {
79
- src: '/pwa-192x192.png',
80
- sizes: '192x192',
81
- type: 'image/png',
82
- },
83
- {
84
- src: '/pwa-512x512.png',
85
- sizes: '512x512',
86
- type: 'image/png',
87
- },
88
- {
89
- src: '/pwa-512x512.png',
90
- sizes: '512x512',
91
- type: 'image/png',
92
- purpose: 'any maskable',
93
- },
94
- ],
95
- },
96
- }),
97
- ]
98
- }
1
+ import { dirname, resolve } from 'node:path'
2
+
3
+ import process from 'node:process'
4
+ import { fileURLToPath } from 'node:url'
5
+ import VueI18nPlugin from '@intlify/unplugin-vue-i18n/vite'
6
+ import legacy from '@vitejs/plugin-legacy'
7
+ import vue from '@vitejs/plugin-vue'
8
+ import UnoCSS from 'unocss/vite'
9
+ import { loadEnv } from 'vite'
10
+ import viteCompression from 'vite-plugin-compression'
11
+ import { mockDevServerPlugin } from 'vite-plugin-mock-dev-server'
12
+ import { VitePWA } from 'vite-plugin-pwa'
13
+ import Sitemap from 'vite-plugin-sitemap'
14
+ import VueDevTools from 'vite-plugin-vue-devtools'
15
+ import { createViteVConsole } from './vconsole'
16
+
17
+ export function createVitePlugins(mode: string) {
18
+ const env = loadEnv(mode, process.cwd())
19
+
20
+ return [
21
+ vue({
22
+ template: {
23
+ compilerOptions: {
24
+ // 注册自定义组件micro-app 防止控制台警告
25
+ isCustomElement: tag => tag.startsWith('micro-app'),
26
+ },
27
+ },
28
+ }),
29
+
30
+ // https://github.com/jbaubree/vite-plugin-sitemap
31
+ Sitemap({
32
+ outDir: `./dist/${env.VITE_APP_OUT_DIR}`,
33
+ }),
34
+
35
+ // https://github.com/pengzhanbo/vite-plugin-mock-dev-server
36
+ mockDevServerPlugin(),
37
+
38
+ // 生产环境 gzip 压缩资源
39
+ viteCompression({
40
+ algorithm: 'gzip',
41
+ // 文件大于10240b(10kb)时才压缩文件
42
+ threshold: 10240,
43
+ // 禁止在控制台输出压缩结果
44
+ verbose: false,
45
+ // 压缩完文件后删除源文件
46
+ deleteOriginFile: false,
47
+ }),
48
+
49
+ // https://github.com/intlify/bundle-tools/tree/main/packages/unplugin-vue-i18n
50
+ VueI18nPlugin({
51
+ // locale messages resource pre-compile option
52
+ include: resolve(dirname(fileURLToPath(import.meta.url)), '../../src/locales/**'),
53
+ }),
54
+
55
+ legacy({
56
+ targets: ['defaults', 'not IE 11'],
57
+ }),
58
+
59
+ // https://github.com/antfu/unocss
60
+ // see uno.config.ts for config
61
+ UnoCSS(),
62
+
63
+ // https://github.com/vadxq/vite-plugin-vconsole
64
+ createViteVConsole(mode),
65
+
66
+ // https://github.com/vuejs/devtools-next
67
+ VueDevTools(),
68
+
69
+ // https://github.com/antfu/vite-plugin-pwa
70
+ VitePWA({
71
+ registerType: 'autoUpdate',
72
+ includeAssets: ['favicon.svg', 'safari-pinned-tab.svg'],
73
+ manifest: {
74
+ name: 'af-mobile-client-vue3',
75
+ short_name: 'af-mobile-client-vue3',
76
+ theme_color: '#ffffff',
77
+ icons: [
78
+ {
79
+ src: '/pwa-192x192.png',
80
+ sizes: '192x192',
81
+ type: 'image/png',
82
+ },
83
+ {
84
+ src: '/pwa-512x512.png',
85
+ sizes: '512x512',
86
+ type: 'image/png',
87
+ },
88
+ {
89
+ src: '/pwa-512x512.png',
90
+ sizes: '512x512',
91
+ type: 'image/png',
92
+ purpose: 'any maskable',
93
+ },
94
+ ],
95
+ },
96
+ }),
97
+ ]
98
+ }