af-mobile-client-vue3 1.3.16 → 1.3.18

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 (274) hide show
  1. package/.cursorrules +60 -60
  2. package/.editorconfig +9 -9
  3. package/.env +10 -10
  4. package/.env.development +1 -1
  5. package/.env.production +1 -1
  6. package/.node-version +1 -1
  7. package/.vscode/extensions.json +12 -12
  8. package/.vscode/settings.json +66 -66
  9. package/CLAUDE.md +189 -189
  10. package/README.md +182 -182
  11. package/af-example-mobile-vue-web.iml +9 -9
  12. package/build/vite/index.ts +98 -98
  13. package/build/vite/optimize.ts +34 -34
  14. package/build/vite/vconsole.ts +47 -47
  15. package/commitlint.config.ts +32 -32
  16. package/compress.js +36 -36
  17. package/eslint.config.ts +30 -30
  18. package/index.html +23 -23
  19. package/mock/data.ts +20 -20
  20. package/mock/index.ts +7 -7
  21. package/mock/modules/prose.mock.ts +13 -13
  22. package/mock/modules/user.mock.ts +152 -152
  23. package/mock/util.ts +19 -19
  24. package/netlify.toml +12 -12
  25. package/package.json +114 -114
  26. package/postcss.config.ts +27 -27
  27. package/public/favicon.svg +4 -4
  28. package/public/safari-pinned-tab.svg +4 -4
  29. package/scripts/verifyCommit.js +19 -19
  30. package/src/App.vue +79 -79
  31. package/src/api/mock/index.ts +30 -30
  32. package/src/api/user/index.ts +40 -40
  33. package/src/assets/img/user/login/background-shadow-1.svg +20 -20
  34. package/src/assets/img/user/login/logo-background.svg +20 -20
  35. package/src/bootstrap.ts +26 -26
  36. package/src/components/core/BeautifulLoading/index.vue +52 -52
  37. package/src/components/core/ImageUploader/index.vue +244 -244
  38. package/src/components/core/NavBar/index.vue +53 -53
  39. package/src/components/core/Tabbar/index.vue +32 -32
  40. package/src/components/core/Uploader/index.vue +124 -124
  41. package/src/components/core/XGridDropOption/index.vue +154 -154
  42. package/src/components/core/XMultiSelect/index.vue +183 -183
  43. package/src/components/core/XSelect/index.vue +149 -149
  44. package/src/components/data/CardContainer/CardContainer.vue +118 -118
  45. package/src/components/data/CardContainer/CardHeader.vue +99 -99
  46. package/src/components/data/InfoDisplay/index.vue +132 -132
  47. package/src/components/data/UserDetail/api.ts +24 -24
  48. package/src/components/data/UserDetail/index.vue +620 -620
  49. package/src/components/data/UserDetail/recordEntries.ts +159 -159
  50. package/src/components/data/UserDetail/types.ts +26 -26
  51. package/src/components/data/XBadge/index.vue +82 -82
  52. package/src/components/data/XCellDetail/index.vue +105 -105
  53. package/src/components/data/XCellList/XCellList.md +313 -313
  54. package/src/components/data/XCellList/index.vue +1110 -1075
  55. package/src/components/data/XCellListFilter/QrScanner/index.vue +207 -207
  56. package/src/components/data/XCellListFilter/QrScanner/startScanAnimation.ts +53 -53
  57. package/src/components/data/XCellListFilter/VpnRecognition/index.vue +119 -119
  58. package/src/components/data/XCellListFilter/index.vue +705 -705
  59. package/src/components/data/XForm/index.vue +659 -659
  60. package/src/components/data/XFormGroup/doc/DeviceForm.vue +122 -122
  61. package/src/components/data/XFormGroup/doc/FormGroupDemo.vue +56 -56
  62. package/src/components/data/XFormGroup/doc/README.md +286 -286
  63. package/src/components/data/XFormGroup/doc/UserForm.vue +102 -102
  64. package/src/components/data/XFormGroup/index.vue +240 -240
  65. package/src/components/data/XFormItem/index.vue +1310 -1310
  66. package/src/components/data/XOlMap/README.md +227 -227
  67. package/src/components/data/XOlMap/XLocationPicker/index.vue +226 -226
  68. package/src/components/data/XOlMap/index.vue +1490 -1490
  69. package/src/components/data/XOlMap/types.ts +149 -149
  70. package/src/components/data/XOlMap/utils/wgs84ToGcj02.js +154 -154
  71. package/src/components/data/XReportForm/DateTimeSecondsPicker.vue +208 -208
  72. package/src/components/data/XReportForm/XReportFormJsonRender.vue +220 -220
  73. package/src/components/data/XReportForm/index.vue +1393 -1393
  74. package/src/components/data/XReportGrid/XAddReport/XAddReport.vue +198 -198
  75. package/src/components/data/XReportGrid/XAddReport/index.js +3 -3
  76. package/src/components/data/XReportGrid/XAddReport/index.md +53 -53
  77. package/src/components/data/XReportGrid/XAddReport/index.ts +10 -10
  78. package/src/components/data/XReportGrid/XReport.vue +960 -960
  79. package/src/components/data/XReportGrid/XReportDemo.vue +33 -33
  80. package/src/components/data/XReportGrid/XReportDesign.vue +597 -597
  81. package/src/components/data/XReportGrid/XReportDrawer/XReportDrawer.vue +148 -148
  82. package/src/components/data/XReportGrid/XReportDrawer/index.js +3 -3
  83. package/src/components/data/XReportGrid/XReportDrawer/index.ts +10 -10
  84. package/src/components/data/XReportGrid/XReportJsonRender.vue +399 -399
  85. package/src/components/data/XReportGrid/XReportTrGroup.vue +592 -592
  86. package/src/components/data/XReportGrid/index.md +46 -46
  87. package/src/components/data/XReportGrid/print.js +184 -184
  88. package/src/components/data/XSignature/index.vue +284 -284
  89. package/src/components/data/XTag/index.vue +10 -10
  90. package/src/components/layout/NormalDataLayout/index.vue +69 -69
  91. package/src/components/layout/TabBarLayout/index.vue +40 -40
  92. package/src/composables/dark.ts +5 -5
  93. package/src/config/routes.ts +9 -9
  94. package/src/constants/index.ts +2 -2
  95. package/src/enums/requestEnum.ts +25 -25
  96. package/src/expression/ExpressionRunner.ts +28 -28
  97. package/src/expression/TestExpression.ts +510 -510
  98. package/src/expression/core/Delegate.ts +116 -116
  99. package/src/expression/core/Expression.ts +1359 -1359
  100. package/src/expression/core/Program.ts +985 -985
  101. package/src/expression/core/Token.ts +29 -29
  102. package/src/expression/enums/ExpressionType.ts +81 -81
  103. package/src/expression/enums/TokenType.ts +11 -11
  104. package/src/expression/exception/BreakWayException.ts +2 -2
  105. package/src/expression/exception/ContinueWayException.ts +2 -2
  106. package/src/expression/exception/ExpressionException.ts +29 -29
  107. package/src/expression/exception/ReturnWayException.ts +14 -14
  108. package/src/expression/exception/ServiceException.ts +22 -22
  109. package/src/expression/instances/JSONArray.ts +52 -52
  110. package/src/expression/instances/JSONObject.ts +118 -118
  111. package/src/expression/instances/LogicConsole.ts +31 -31
  112. package/src/font-style/font.css +4 -4
  113. package/src/hooks/useBoolean.ts +26 -26
  114. package/src/hooks/useCommon.ts +9 -9
  115. package/src/hooks/useLoading.ts +16 -16
  116. package/src/hooks/useLogin.ts +97 -97
  117. package/src/icons/svg/check-in.svg +32 -32
  118. package/src/icons/svg/dark.svg +4 -4
  119. package/src/icons/svg/github.svg +4 -4
  120. package/src/icons/svg/light.svg +4 -4
  121. package/src/icons/svg/link.svg +4 -4
  122. package/src/icons/svgo.yml +22 -22
  123. package/src/layout/GridView/index.vue +16 -16
  124. package/src/layout/PageLayout.vue +9 -9
  125. package/src/layout/SingleLayout.vue +9 -9
  126. package/src/locales/en-US.json +128 -128
  127. package/src/locales/zh-CN.json +128 -128
  128. package/src/logic/LogicRunner.ts +67 -67
  129. package/src/logic/TestLogic.ts +13 -13
  130. package/src/logic/plugins/common/DateTools.ts +35 -35
  131. package/src/logic/plugins/common/VueTools.ts +30 -30
  132. package/src/logic/plugins/index.ts +7 -7
  133. package/src/main.ts +44 -44
  134. package/src/plugins/AppData.ts +38 -38
  135. package/src/plugins/GetLoginInfoService.ts +10 -10
  136. package/src/plugins/collectIcons.ts +10 -10
  137. package/src/plugins/index.ts +11 -11
  138. package/src/router/README.md +8 -8
  139. package/src/router/guards.ts +59 -59
  140. package/src/router/index.ts +35 -35
  141. package/src/router/invoiceRoutes.ts +33 -33
  142. package/src/router/routes.ts +353 -341
  143. package/src/router/types.ts +7 -7
  144. package/src/services/api/Login.ts +6 -6
  145. package/src/services/api/common.ts +109 -109
  146. package/src/services/api/index.ts +7 -7
  147. package/src/services/api/manage.ts +8 -8
  148. package/src/services/api/search.ts +16 -16
  149. package/src/services/api/user.ts +17 -17
  150. package/src/services/restTools.ts +56 -56
  151. package/src/services/v3Api.ts +147 -147
  152. package/src/stores/index.ts +11 -11
  153. package/src/stores/modules/counter.ts +19 -19
  154. package/src/stores/modules/routeCache.ts +23 -23
  155. package/src/stores/modules/setting.ts +77 -76
  156. package/src/stores/modules/user.ts +235 -235
  157. package/src/stores/mutation-type.ts +7 -7
  158. package/src/styles/app.less +36 -36
  159. package/src/styles/login.less +109 -109
  160. package/src/styles/var.less +25 -16
  161. package/src/types/env.d.ts +16 -16
  162. package/src/types/settings.ts +1 -1
  163. package/src/types/vue-router.d.ts +9 -9
  164. package/src/utils/Storage.ts +124 -124
  165. package/src/utils/authority-utils.ts +84 -84
  166. package/src/utils/common.ts +41 -41
  167. package/src/utils/crypto.ts +39 -39
  168. package/src/utils/dataUtil.ts +42 -42
  169. package/src/utils/dictUtil.ts +52 -52
  170. package/src/utils/http/index.ts +199 -199
  171. package/src/utils/i18n.ts +72 -72
  172. package/src/utils/indexedDB.ts +195 -195
  173. package/src/utils/inline-px-to-vw.ts +28 -28
  174. package/src/utils/mobileUtil.ts +34 -34
  175. package/src/utils/progress.ts +19 -19
  176. package/src/utils/routerUtil.ts +271 -271
  177. package/src/utils/runEvalFunction.ts +13 -13
  178. package/src/utils/secureStorage.ts +71 -71
  179. package/src/utils/set-page-title.ts +5 -5
  180. package/src/utils/validate.ts +6 -6
  181. package/src/utils/wechatUtil.ts +9 -9
  182. package/src/views/chat/index.vue +153 -153
  183. package/src/views/common/LoadError.vue +63 -63
  184. package/src/views/common/NotFound.vue +67 -67
  185. package/src/views/component/EvaluateRecordView/index.vue +40 -40
  186. package/src/views/component/IconifyView/index.vue +504 -504
  187. package/src/views/component/UserDetailView/UserDetailPage.vue +77 -77
  188. package/src/views/component/UserDetailView/index.vue +234 -234
  189. package/src/views/component/XCellDetailView/index.vue +217 -217
  190. package/src/views/component/XCellListView/index.vue +157 -108
  191. package/src/views/component/XFormAppraiseView/index.vue +174 -174
  192. package/src/views/component/XFormGroupView/index.vue +82 -78
  193. package/src/views/component/XFormGroupView/xformgroup222.vue +97 -0
  194. package/src/views/component/XFormView/index.vue +27 -27
  195. package/src/views/component/XOlMapView/XLocationPicker/index.vue +118 -118
  196. package/src/views/component/XOlMapView/index.vue +434 -434
  197. package/src/views/component/XOlMapView/testData.ts +64 -64
  198. package/src/views/component/XReportFormIframeView/index.vue +47 -47
  199. package/src/views/component/XReportFormView/index.vue +13 -13
  200. package/src/views/component/XReportGridView/index.vue +17 -17
  201. package/src/views/component/XRequestView/index.vue +234 -234
  202. package/src/views/component/XSignatureView/index.vue +50 -50
  203. package/src/views/component/index.vue +181 -181
  204. package/src/views/component/menu.vue +117 -117
  205. package/src/views/component/notice.vue +46 -46
  206. package/src/views/component/topNav.vue +36 -36
  207. package/src/views/invoiceShow/index.vue +61 -61
  208. package/src/views/user/login/ForgetPasswordForm.vue +94 -94
  209. package/src/views/user/login/LoginForm.vue +346 -346
  210. package/src/views/user/login/LoginTitle.vue +76 -76
  211. package/src/views/user/login/LoginWave.vue +109 -109
  212. package/src/views/user/login/index.vue +22 -22
  213. package/src/views/user/my/comm/ModifyPassword.vue +346 -346
  214. package/src/views/user/my/index.vue +340 -340
  215. package/src/views/user/register/index.vue +910 -0
  216. package/src/views/userRecords/AbnormalAlarmRecords.vue +21 -21
  217. package/src/views/userRecords/CardReplacementRecords.vue +21 -21
  218. package/src/views/userRecords/ChangeRecords.vue +19 -19
  219. package/src/views/userRecords/CommandViewRecords.vue +20 -20
  220. package/src/views/userRecords/GasCompensationRecords.vue +20 -20
  221. package/src/views/userRecords/InstrumentCollectionRecords.vue +21 -21
  222. package/src/views/userRecords/MeterRecords.vue +20 -20
  223. package/src/views/userRecords/OperateRecords.vue +51 -51
  224. package/src/views/userRecords/OtherChargeRecords.vue +19 -19
  225. package/src/views/userRecords/PaymentRecords.vue +28 -28
  226. package/src/views/userRecords/PriceAdjustmentRecords.vue +19 -19
  227. package/src/views/userRecords/ReplacementRecords.vue +19 -19
  228. package/src/views/userRecords/SafetyRecords.vue +19 -19
  229. package/src/views/userRecords/TransactionRecords.vue +21 -21
  230. package/src/views/userRecords/TransferRecords.vue +19 -19
  231. package/src/views/userRecords/operateRecordDetail/index.vue +316 -316
  232. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/AddUserDetail.vue +124 -124
  233. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/AdvanceDeliveryDetail.vue +88 -88
  234. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/AutoAccountsCancelDetail.vue +205 -205
  235. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/AutoAccountsDetail.vue +192 -192
  236. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/BankDkDetail.vue +192 -192
  237. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/BankPayDetail.vue +192 -192
  238. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/BlacklistDetail.vue +153 -153
  239. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/CancellationDetail.vue +101 -101
  240. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/CardMeterCenterCancelDetail.vue +127 -127
  241. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/CardMeterCenterDetail.vue +153 -153
  242. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/CardOverUserDetail.vue +153 -153
  243. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/ChangeMeterCancelDetail.vue +166 -166
  244. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/ChangeMeterDetail.vue +205 -205
  245. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/DisableManageDetail.vue +127 -127
  246. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/EnableManageDetail.vue +114 -114
  247. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/FaZheChangeDetail.vue +124 -124
  248. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/FeeDeductionDetail.vue +153 -153
  249. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/GasPriceChangeDetail.vue +126 -126
  250. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/InputtorChangeDetail.vue +126 -126
  251. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/IotMeterCenterCancelDetail.vue +114 -114
  252. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/IotMeterCenterDetail.vue +127 -127
  253. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/IotOpenDetail.vue +88 -88
  254. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/MachineCardDetail.vue +101 -101
  255. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/MachineMeterCenterCancelDetail.vue +218 -218
  256. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/MachineMeterCenterDetail.vue +153 -153
  257. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/OffGasAddGasDetail.vue +140 -140
  258. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/OtherChargeCancelDetail.vue +127 -127
  259. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/OtherChargeDetail.vue +114 -114
  260. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/OverUserChangeDetail.vue +127 -127
  261. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/ReBillDetail.vue +127 -127
  262. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/RefundDetail.vue +114 -114
  263. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/ReplaceCardManageCancelDetail.vue +127 -127
  264. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/ReplaceCardManageDetail.vue +114 -114
  265. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/SaleCardGasDetail.vue +140 -140
  266. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/TransferManageCancelDetail.vue +152 -152
  267. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/TransferManageDetail.vue +178 -178
  268. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/UserChangeDetail.vue +123 -123
  269. package/src/views/userRecords/operateRecordDetail/operateRecordDetails/WechatPayDetail.vue +192 -192
  270. package/src/views/userRecords/types.ts +66 -66
  271. package/tsconfig.json +39 -39
  272. package/uno.config.ts +82 -82
  273. package/vite.config.ts +118 -118
  274. package/.claude/settings.local.json +0 -8
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
+ }