uview-pro 0.3.0 → 0.3.1

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 (249) hide show
  1. package/changelog.md +584 -574
  2. package/components/common/props.ts +22 -22
  3. package/components/u-action-sheet/types.ts +37 -37
  4. package/components/u-action-sheet/u-action-sheet.vue +178 -178
  5. package/components/u-alert-tips/types.ts +41 -41
  6. package/components/u-alert-tips/u-alert-tips.vue +238 -238
  7. package/components/u-avatar/types.ts +36 -36
  8. package/components/u-avatar/u-avatar.vue +217 -217
  9. package/components/u-avatar-cropper/types.ts +23 -23
  10. package/components/u-avatar-cropper/u-avatar-cropper.vue +297 -297
  11. package/components/u-avatar-cropper/weCropper.d.ts +62 -62
  12. package/components/u-avatar-cropper/weCropper.js +1281 -1281
  13. package/components/u-avatar-cropper/weCropper.ts +1276 -1276
  14. package/components/u-back-top/types.ts +36 -36
  15. package/components/u-back-top/u-back-top.vue +140 -140
  16. package/components/u-badge/types.ts +38 -38
  17. package/components/u-badge/u-badge.vue +183 -183
  18. package/components/u-button/types.ts +66 -66
  19. package/components/u-button/u-button.vue +579 -579
  20. package/components/u-calendar/types.ts +75 -75
  21. package/components/u-calendar/u-calendar.vue +793 -793
  22. package/components/u-car-keyboard/types.ts +14 -14
  23. package/components/u-car-keyboard/u-car-keyboard.vue +262 -262
  24. package/components/u-card/types.ts +61 -61
  25. package/components/u-card/u-card.vue +209 -209
  26. package/components/u-cell-group/types.ts +19 -19
  27. package/components/u-cell-group/u-cell-group.vue +60 -60
  28. package/components/u-cell-item/types.ts +56 -56
  29. package/components/u-cell-item/u-cell-item.vue +226 -226
  30. package/components/u-checkbox/types.ts +33 -33
  31. package/components/u-checkbox/u-checkbox.vue +282 -282
  32. package/components/u-checkbox-group/types.ts +34 -34
  33. package/components/u-checkbox-group/u-checkbox-group.vue +130 -130
  34. package/components/u-circle-progress/types.ts +54 -54
  35. package/components/u-circle-progress/u-circle-progress.vue +206 -206
  36. package/components/u-city-select/types.ts +22 -22
  37. package/components/u-city-select/u-city-select.vue +276 -276
  38. package/components/u-col/types.ts +32 -32
  39. package/components/u-col/u-col.vue +142 -142
  40. package/components/u-collapse/types.ts +33 -33
  41. package/components/u-collapse/u-collapse.vue +190 -190
  42. package/components/u-collapse-item/types.ts +27 -27
  43. package/components/u-collapse-item/u-collapse-item.vue +290 -290
  44. package/components/u-column-notice/types.ts +50 -50
  45. package/components/u-column-notice/u-column-notice.vue +222 -222
  46. package/components/u-count-down/types.ts +44 -44
  47. package/components/u-count-down/u-count-down.vue +286 -286
  48. package/components/u-count-to/types.ts +34 -34
  49. package/components/u-count-to/u-count-to.vue +266 -266
  50. package/components/u-divider/types.ts +33 -33
  51. package/components/u-divider/u-divider.vue +145 -145
  52. package/components/u-dropdown/types.ts +34 -34
  53. package/components/u-dropdown/u-dropdown.vue +330 -330
  54. package/components/u-dropdown-item/types.ts +29 -29
  55. package/components/u-dropdown-item/u-dropdown-item.vue +120 -120
  56. package/components/u-empty/types.ts +38 -38
  57. package/components/u-empty/u-empty.vue +103 -103
  58. package/components/u-field/types.ts +71 -71
  59. package/components/u-field/u-field.vue +388 -388
  60. package/components/u-form/types.ts +29 -29
  61. package/components/u-form/u-form.vue +130 -130
  62. package/components/u-form-item/types.ts +72 -72
  63. package/components/u-form-item/u-form-item.vue +447 -447
  64. package/components/u-full-screen/types.ts +16 -16
  65. package/components/u-full-screen/u-full-screen.vue +103 -103
  66. package/components/u-gap/types.ts +20 -20
  67. package/components/u-gap/u-gap.vue +50 -50
  68. package/components/u-grid/types.ts +21 -21
  69. package/components/u-grid/u-grid.vue +91 -91
  70. package/components/u-grid-item/types.ts +16 -16
  71. package/components/u-grid-item/u-grid-item.vue +130 -130
  72. package/components/u-icon/types.ts +61 -61
  73. package/components/u-icon/u-icon.vue +296 -296
  74. package/components/u-image/types.ts +51 -51
  75. package/components/u-image/u-image.vue +239 -239
  76. package/components/u-index-anchor/types.ts +16 -16
  77. package/components/u-index-anchor/u-index-anchor.vue +94 -94
  78. package/components/u-index-list/types.ts +43 -43
  79. package/components/u-index-list/u-index-list.vue +352 -352
  80. package/components/u-input/types.ts +137 -137
  81. package/components/u-input/u-input.vue +288 -288
  82. package/components/u-keyboard/types.ts +40 -40
  83. package/components/u-keyboard/u-keyboard.vue +178 -178
  84. package/components/u-lazy-load/types.ts +37 -37
  85. package/components/u-lazy-load/u-lazy-load.vue +246 -246
  86. package/components/u-line/types.ts +44 -44
  87. package/components/u-line/u-line.vue +68 -68
  88. package/components/u-line-progress/types.ts +58 -58
  89. package/components/u-line-progress/u-line-progress.vue +126 -126
  90. package/components/u-link/types.ts +43 -43
  91. package/components/u-link/u-link.vue +84 -84
  92. package/components/u-loading/types.ts +35 -35
  93. package/components/u-loading/u-loading.vue +105 -105
  94. package/components/u-loading-popup/types.ts +26 -26
  95. package/components/u-loading-popup/u-loading-popup.vue +253 -253
  96. package/components/u-loadmore/types.ts +79 -79
  97. package/components/u-loadmore/u-loadmore.vue +156 -156
  98. package/components/u-mask/types.ts +40 -40
  99. package/components/u-mask/u-mask.vue +113 -113
  100. package/components/u-message-input/types.ts +74 -74
  101. package/components/u-message-input/u-message-input.vue +281 -281
  102. package/components/u-modal/types.ts +118 -118
  103. package/components/u-modal/u-modal.vue +220 -220
  104. package/components/u-navbar/types.ts +103 -103
  105. package/components/u-navbar/u-navbar.vue +251 -251
  106. package/components/u-no-network/image.ts +2 -2
  107. package/components/u-no-network/types.ts +28 -28
  108. package/components/u-no-network/u-no-network.vue +303 -303
  109. package/components/u-notice-bar/types.ts +111 -111
  110. package/components/u-notice-bar/u-notice-bar.vue +189 -189
  111. package/components/u-number-box/types.ts +42 -42
  112. package/components/u-number-box/u-number-box.vue +321 -321
  113. package/components/u-number-keyboard/types.ts +26 -26
  114. package/components/u-number-keyboard/u-number-keyboard.vue +188 -188
  115. package/components/u-picker/types.ts +123 -123
  116. package/components/u-picker/u-picker.vue +685 -685
  117. package/components/u-popup/types.ts +59 -59
  118. package/components/u-popup/u-popup.vue +385 -385
  119. package/components/u-radio/types.ts +27 -27
  120. package/components/u-radio/u-radio.vue +279 -279
  121. package/components/u-radio-group/types.ts +31 -31
  122. package/components/u-radio-group/u-radio-group.vue +96 -96
  123. package/components/u-rate/types.ts +42 -42
  124. package/components/u-rate/u-rate.vue +249 -249
  125. package/components/u-read-more/types.ts +37 -37
  126. package/components/u-read-more/u-read-more.vue +172 -172
  127. package/components/u-root-portal/u-root-portal.vue +56 -56
  128. package/components/u-row/types.ts +22 -22
  129. package/components/u-row/u-row.vue +105 -105
  130. package/components/u-row-notice/types.ts +41 -41
  131. package/components/u-row-notice/u-row-notice.vue +256 -256
  132. package/components/u-safe-bottom/u-safe-bottom.vue +57 -57
  133. package/components/u-search/types.ts +55 -55
  134. package/components/u-search/u-search.vue +279 -279
  135. package/components/u-section/types.ts +34 -34
  136. package/components/u-section/u-section.vue +150 -150
  137. package/components/u-select/types.ts +45 -45
  138. package/components/u-select/u-select.vue +388 -388
  139. package/components/u-skeleton/types.ts +22 -22
  140. package/components/u-skeleton/u-skeleton.vue +231 -231
  141. package/components/u-slider/types.ts +34 -34
  142. package/components/u-slider/u-slider.vue +255 -255
  143. package/components/u-status-bar/u-status-bar.vue +74 -74
  144. package/components/u-steps/types.ts +30 -30
  145. package/components/u-steps/u-steps.vue +181 -181
  146. package/components/u-sticky/types.ts +24 -24
  147. package/components/u-sticky/u-sticky.vue +178 -178
  148. package/components/u-subsection/types.ts +38 -38
  149. package/components/u-subsection/u-subsection.vue +339 -339
  150. package/components/u-swipe-action/types.ts +52 -52
  151. package/components/u-swipe-action/u-swipe-action.vue +276 -276
  152. package/components/u-swiper/types.ts +49 -49
  153. package/components/u-swiper/u-swiper.vue +308 -308
  154. package/components/u-switch/types.ts +30 -30
  155. package/components/u-switch/u-switch.vue +150 -150
  156. package/components/u-tabbar/types.ts +38 -38
  157. package/components/u-tabbar/u-tabbar.vue +315 -315
  158. package/components/u-table/types.ts +27 -27
  159. package/components/u-table/u-table.vue +67 -67
  160. package/components/u-tabs/types.ts +53 -53
  161. package/components/u-tabs/u-tabs.vue +302 -302
  162. package/components/u-tabs-swiper/types.ts +55 -55
  163. package/components/u-tabs-swiper/u-tabs-swiper.vue +409 -409
  164. package/components/u-tag/types.ts +39 -39
  165. package/components/u-tag/u-tag.vue +268 -268
  166. package/components/u-td/types.ts +14 -14
  167. package/components/u-td/u-td.vue +98 -98
  168. package/components/u-text/types.ts +72 -72
  169. package/components/u-text/u-text.vue +343 -343
  170. package/components/u-th/types.ts +14 -14
  171. package/components/u-th/u-th.vue +92 -92
  172. package/components/u-time-line/u-time-line.vue +53 -53
  173. package/components/u-time-line-item/types.ts +16 -16
  174. package/components/u-time-line-item/u-time-line-item.vue +90 -90
  175. package/components/u-toast/types.ts +38 -38
  176. package/components/u-toast/u-toast.vue +240 -240
  177. package/components/u-top-tips/types.ts +16 -16
  178. package/components/u-top-tips/u-top-tips.vue +130 -130
  179. package/components/u-tr/types.ts +11 -11
  180. package/components/u-tr/u-tr.vue +39 -39
  181. package/components/u-upload/types.ts +82 -82
  182. package/components/u-upload/u-upload.vue +568 -568
  183. package/components/u-verification-code/types.ts +24 -24
  184. package/components/u-verification-code/u-verification-code.vue +176 -176
  185. package/components/u-waterfall/types.ts +18 -18
  186. package/components/u-waterfall/u-waterfall.vue +187 -187
  187. package/iconfont.css +913 -913
  188. package/index.scss +25 -25
  189. package/index.ts +38 -38
  190. package/libs/config/config.ts +26 -26
  191. package/libs/config/zIndex.ts +37 -37
  192. package/libs/css/color.scss +155 -155
  193. package/libs/css/common.scss +178 -178
  194. package/libs/css/style.components.scss +16 -16
  195. package/libs/css/style.h5.scss +8 -8
  196. package/libs/css/style.mp.scss +72 -72
  197. package/libs/css/style.nvue.scss +15 -15
  198. package/libs/css/style.vue.scss +188 -188
  199. package/libs/function/$parent.ts +24 -24
  200. package/libs/function/addUnit.ts +13 -13
  201. package/libs/function/color.ts +37 -37
  202. package/libs/function/colorGradient.ts +139 -139
  203. package/libs/function/debounce.ts +28 -28
  204. package/libs/function/deepClone.ts +39 -39
  205. package/libs/function/deepMerge.ts +35 -35
  206. package/libs/function/getParent.ts +63 -63
  207. package/libs/function/getRect.ts +26 -26
  208. package/libs/function/guid.ts +42 -42
  209. package/libs/function/md5.ts +403 -403
  210. package/libs/function/parent.ts +21 -21
  211. package/libs/function/queryParams.ts +64 -64
  212. package/libs/function/random.ts +16 -16
  213. package/libs/function/randomArray.ts +11 -11
  214. package/libs/function/route.ts +118 -118
  215. package/libs/function/styleUtils.ts +83 -83
  216. package/libs/function/sys.ts +15 -15
  217. package/libs/function/test.ts +289 -289
  218. package/libs/function/throttle.ts +31 -31
  219. package/libs/function/timeFormat.ts +55 -55
  220. package/libs/function/timeFrom.ts +48 -48
  221. package/libs/function/toast.ts +14 -14
  222. package/libs/function/trim.ts +21 -21
  223. package/libs/function/type2icon.ts +39 -39
  224. package/libs/hooks/index.ts +4 -4
  225. package/libs/hooks/useCompRelation.ts +364 -364
  226. package/libs/hooks/useComponent.ts +759 -759
  227. package/libs/hooks/useEmitter.ts +79 -79
  228. package/libs/hooks/useParent.ts +33 -33
  229. package/libs/hooks/useRect.ts +33 -33
  230. package/libs/index.ts +337 -337
  231. package/libs/request/auto-http.ts +76 -76
  232. package/libs/request/index.ts +242 -242
  233. package/libs/store/index.ts +88 -88
  234. package/libs/util/async-validator.d.ts +75 -75
  235. package/libs/util/async-validator.js +1 -1
  236. package/libs/util/calendar.d.ts +57 -57
  237. package/libs/util/emitter.ts +112 -112
  238. package/libs/util/eventBus.ts +86 -86
  239. package/libs/util/logger.ts +364 -364
  240. package/libs/util/mitt.ts +118 -118
  241. package/libs/util/parent.ts +20 -20
  242. package/package.json +4 -4
  243. package/readme.md +241 -241
  244. package/theme.scss +38 -38
  245. package/types/components.d.ts +97 -97
  246. package/types/global.d.ts +331 -331
  247. package/types/ignore-errors.d.ts +30 -30
  248. package/types/index.d.ts +19 -19
  249. package/types/uni-app.d.ts +63 -63
@@ -1,364 +1,364 @@
1
- // utils/useComponent.ts
2
- import { ref, reactive, getCurrentInstance, onUnmounted, nextTick, computed, watch, onMounted } from 'vue';
3
- import { logger } from '../util/logger';
4
-
5
- // 类型定义
6
- interface ParentContext {
7
- name: string;
8
- addChild: (child: ChildContext) => void;
9
- removeChild: (childId: string) => void;
10
- broadcast: (event: string, data?: any) => void;
11
- getChildren: () => ChildContext[];
12
- getExposed: () => Record<string, any>;
13
- getChildExposed: (childId: string) => Record<string, any>;
14
- getChildrenExposed: () => Array<{ id: string; name: string; exposed: Record<string, any> }>;
15
- }
16
-
17
- interface ChildContext {
18
- id: string;
19
- name: string;
20
- emitToParent: (event: string, data?: any) => void;
21
- getParentExposed: () => Record<string, any>;
22
- getInstance: () => any;
23
- getExposed: () => Record<string, any>;
24
- }
25
-
26
- // 符号定义
27
- const PARENT_CONTEXT_SYMBOL = Symbol('parent_context');
28
- const CHILDREN_CONTEXT_SYMBOL = Symbol('children_context');
29
-
30
- /**
31
- * 生成实例唯一ID
32
- */
33
- function generateInstanceId(componentName: string): string {
34
- return `${componentName}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
35
- }
36
-
37
- /**
38
- * 查找父组件实例
39
- */
40
- function findParentInstance(name: string, instance: any): any {
41
- if (!instance) return null;
42
-
43
- let parent = instance.parent;
44
- while (parent) {
45
- const parentName = parent.type?.name || parent.type?.__name;
46
- if (parentName === name) {
47
- return parent;
48
- }
49
- parent = parent.parent;
50
- }
51
- return null;
52
- }
53
-
54
- /**
55
- * 获取父组件上下文
56
- */
57
- function getParentContext(name: string, instance: any): ParentContext | null {
58
- const parentInstance = findParentInstance(name, instance);
59
- if (parentInstance) {
60
- return parentInstance.proxy?.[PARENT_CONTEXT_SYMBOL] || null;
61
- }
62
- return null;
63
- }
64
-
65
- /**
66
- * 父组件 Hook
67
- */
68
- export function useParent(componentName?: string) {
69
- const instance = getCurrentInstance();
70
- if (!instance) {
71
- throw new Error('useParent must be called within setup function');
72
- }
73
-
74
- // 使用组件名称作为默认名称
75
- const name = componentName || instance.type.name || instance.type.__name;
76
- if (!name) {
77
- throw new Error('Component name is required for useParent. Either provide a name or set component name.');
78
- }
79
-
80
- const children = reactive<ChildContext[]>([]);
81
- const childrenMap = new Map<string, ChildContext>();
82
-
83
- // 父组件上下文
84
- const parentContext: ParentContext = {
85
- name,
86
-
87
- addChild(child: ChildContext) {
88
- if (!childrenMap.has(child.id)) {
89
- childrenMap.set(child.id, child);
90
- children.push(child);
91
- logger.log(`Parent ${name} added child: ${child.name} (${child.id})`);
92
- }
93
- },
94
-
95
- removeChild(childId: string) {
96
- if (childrenMap.has(childId)) {
97
- const child = childrenMap.get(childId)!;
98
- childrenMap.delete(childId);
99
- const index = children.findIndex(c => c.id === childId);
100
- if (index > -1) {
101
- children.splice(index, 1);
102
- }
103
- logger.log(`Parent ${name} removed child: ${childId}`);
104
- }
105
- },
106
-
107
- broadcast(event: string, data?: any) {
108
- logger.log(`Parent ${name} broadcasting event: ${event} to ${childrenMap.size} children`);
109
- childrenMap.forEach(child => {
110
- const exposed = child.getExposed();
111
- if (exposed && typeof exposed[event] === 'function') {
112
- try {
113
- exposed[event](data);
114
- } catch (error) {
115
- logger.warn(`Error calling child method ${event}:`, error);
116
- }
117
- }
118
- });
119
- },
120
-
121
- getChildren() {
122
- return Array.from(childrenMap.values());
123
- },
124
-
125
- getExposed() {
126
- return instance.exposed || {};
127
- },
128
-
129
- getChildExposed(childId: string) {
130
- const child = childrenMap.get(childId);
131
- if (child && child.getExposed) {
132
- return child.getExposed();
133
- }
134
- logger.warn(`Child ${childId} not found or does not have getExposed method`);
135
- return {};
136
- },
137
-
138
- getChildrenExposed() {
139
- return Array.from(childrenMap.values())
140
- .filter(child => child.getExposed)
141
- .map(child => {
142
- const exposed = child.getExposed();
143
- return {
144
- id: child.id,
145
- name: child.name,
146
- exposed: exposed
147
- };
148
- })
149
- .filter(item => Object.keys(item.exposed).length > 0);
150
- }
151
- };
152
-
153
- // 在组件实例上存储父组件上下文
154
- if (instance.proxy) {
155
- instance.proxy[PARENT_CONTEXT_SYMBOL] = parentContext;
156
- }
157
-
158
- // 组件卸载时清理
159
- onUnmounted(() => {
160
- // 清理所有子组件引用
161
- childrenMap.forEach((child, childId) => {
162
- parentContext.removeChild(childId);
163
- });
164
- if (instance.proxy) {
165
- delete instance.proxy[PARENT_CONTEXT_SYMBOL];
166
- }
167
- logger.log(`Parent ${name} unmounted and cleaned up`);
168
- });
169
-
170
- return {
171
- parentName: name,
172
- children,
173
- broadcast: parentContext.broadcast,
174
- getChildren: parentContext.getChildren,
175
- getChildExposed: parentContext.getChildExposed,
176
- getChildrenExposed: parentContext.getChildrenExposed,
177
- getExposed: parentContext.getExposed
178
- };
179
- }
180
-
181
- /**
182
- * 子组件 Hook
183
- */
184
- export function useChildren(componentName?: string, parentName?: string) {
185
- const instance = getCurrentInstance();
186
- if (!instance) {
187
- throw new Error('useChildren must be called within setup function');
188
- }
189
-
190
- // 使用组件名称作为默认名称
191
- const name = componentName || instance.type.name || instance.type.__name;
192
- if (!name) {
193
- throw new Error('Component name is required for useChildren. Either provide a name or set component name.');
194
- }
195
-
196
- const instanceId = generateInstanceId(name);
197
- const parentRef = ref<ParentContext | null>(null);
198
- const parentExposed = ref<Record<string, any>>({});
199
-
200
- // 获取父组件暴露内容
201
- const getParentExposed = (): Record<string, any> => {
202
- if (parentRef.value) {
203
- const exposed = parentRef.value.getExposed();
204
- parentExposed.value = exposed;
205
- return exposed;
206
- }
207
- return {};
208
- };
209
-
210
- // 获取子组件exposed内容
211
- const getExposed = (): Record<string, any> => {
212
- return instance.exposed || {};
213
- };
214
-
215
- // 查找父组件
216
- const findParent = (): ParentContext | null => {
217
- // 如果指定了父组件名称,使用精确查找
218
- if (parentName) {
219
- return getParentContext(parentName, instance);
220
- }
221
-
222
- // 否则查找最近的父组件上下文
223
- let current = instance.parent;
224
- while (current) {
225
- const context = current.proxy?.[PARENT_CONTEXT_SYMBOL];
226
- if (context) {
227
- return context;
228
- }
229
- current = current.parent;
230
- }
231
- return null;
232
- };
233
-
234
- // 链接到父组件
235
- const linkParent = (): boolean => {
236
- const parent = findParent();
237
- if (parent) {
238
- parentRef.value = parent;
239
- parent.addChild(childContext);
240
- getParentExposed();
241
- logger.log(`Child ${name} linked to parent ${parent.name}`);
242
- return true;
243
- }
244
- return false;
245
- };
246
-
247
- // 向父组件发送事件
248
- const emitToParent = (event: string, data?: any) => {
249
- if (parentRef.value) {
250
- const exposed = parentRef.value.getExposed();
251
- if (exposed && typeof exposed[event] === 'function') {
252
- try {
253
- exposed[event](data, instanceId, name);
254
- } catch (error) {
255
- logger.warn(`Error calling parent method ${event}:`, error);
256
- }
257
- } else {
258
- logger.warn(`Parent method ${event} not found or not a function`);
259
- }
260
- } else {
261
- logger.warn(`No parent found to emit event: ${event}`);
262
- }
263
- };
264
-
265
- // 子组件上下文
266
- const childContext: ChildContext = {
267
- id: instanceId,
268
- name,
269
- emitToParent,
270
- getParentExposed,
271
- getInstance() {
272
- return instance;
273
- },
274
- getExposed
275
- };
276
-
277
- logger.log(`Child ${name} registered, looking for parent`);
278
-
279
- onMounted(() => {
280
- // 立即尝试连接父组件
281
- let connected = linkParent();
282
- nextTick(() => {
283
- // 如果未连接成功,500ms后重试一次
284
- if (!connected) {
285
- setTimeout(() => {
286
- linkParent();
287
- }, 500);
288
- }
289
- });
290
- });
291
-
292
- // 组件卸载时清理
293
- onUnmounted(() => {
294
- if (parentRef.value) {
295
- parentRef.value.removeChild(instanceId);
296
- }
297
- logger.log(`Child ${name} unmounted`);
298
- });
299
-
300
- return {
301
- childId: instanceId,
302
- childName: name,
303
- parent: parentRef,
304
- emitToParent,
305
- getParentExposed,
306
- parentExposed: computed(() => parentExposed.value),
307
- getExposed
308
- };
309
- }
310
-
311
- /**
312
- * 检查父组件是否存在
313
- */
314
- export function hasParent(parentName?: string): boolean {
315
- const instance = getCurrentInstance();
316
- if (!instance) return false;
317
-
318
- if (parentName) {
319
- return getParentContext(parentName, instance) !== null;
320
- }
321
-
322
- // 查找最近的父组件上下文
323
- let current = instance.parent;
324
- while (current) {
325
- const context = current.proxy?.[PARENT_CONTEXT_SYMBOL];
326
- if (context) {
327
- return true;
328
- }
329
- current = current.parent;
330
- }
331
- return false;
332
- }
333
-
334
- /**
335
- * 获取父组件上下文
336
- */
337
- export function getParentContextByName(parentName: string): ParentContext | null {
338
- const instance = getCurrentInstance();
339
- if (!instance) return null;
340
- return getParentContext(parentName, instance);
341
- }
342
-
343
- /**
344
- * 热更新清理函数
345
- */
346
- export function cleanupComponentRelations(): void {
347
- logger.log('Cleaning up component relations for hot reload');
348
- // 由于使用组件实例存储,热更新时会自动重新建立关系
349
- }
350
-
351
- // 热更新处理
352
- if (import.meta.hot) {
353
- import.meta.hot.accept(() => {
354
- logger.log('Hot reload detected, relations will be automatically reconnected');
355
- });
356
- }
357
-
358
- export default {
359
- useParent,
360
- useChildren,
361
- hasParent,
362
- getParentContextByName,
363
- cleanupComponentRelations
364
- };
1
+ // utils/useComponent.ts
2
+ import { ref, reactive, getCurrentInstance, onUnmounted, nextTick, computed, watch, onMounted } from 'vue';
3
+ import { logger } from '../util/logger';
4
+
5
+ // 类型定义
6
+ interface ParentContext {
7
+ name: string;
8
+ addChild: (child: ChildContext) => void;
9
+ removeChild: (childId: string) => void;
10
+ broadcast: (event: string, data?: any) => void;
11
+ getChildren: () => ChildContext[];
12
+ getExposed: () => Record<string, any>;
13
+ getChildExposed: (childId: string) => Record<string, any>;
14
+ getChildrenExposed: () => Array<{ id: string; name: string; exposed: Record<string, any> }>;
15
+ }
16
+
17
+ interface ChildContext {
18
+ id: string;
19
+ name: string;
20
+ emitToParent: (event: string, data?: any) => void;
21
+ getParentExposed: () => Record<string, any>;
22
+ getInstance: () => any;
23
+ getExposed: () => Record<string, any>;
24
+ }
25
+
26
+ // 符号定义
27
+ const PARENT_CONTEXT_SYMBOL = Symbol('parent_context');
28
+ const CHILDREN_CONTEXT_SYMBOL = Symbol('children_context');
29
+
30
+ /**
31
+ * 生成实例唯一ID
32
+ */
33
+ function generateInstanceId(componentName: string): string {
34
+ return `${componentName}_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
35
+ }
36
+
37
+ /**
38
+ * 查找父组件实例
39
+ */
40
+ function findParentInstance(name: string, instance: any): any {
41
+ if (!instance) return null;
42
+
43
+ let parent = instance.parent;
44
+ while (parent) {
45
+ const parentName = parent.type?.name || parent.type?.__name;
46
+ if (parentName === name) {
47
+ return parent;
48
+ }
49
+ parent = parent.parent;
50
+ }
51
+ return null;
52
+ }
53
+
54
+ /**
55
+ * 获取父组件上下文
56
+ */
57
+ function getParentContext(name: string, instance: any): ParentContext | null {
58
+ const parentInstance = findParentInstance(name, instance);
59
+ if (parentInstance) {
60
+ return parentInstance.proxy?.[PARENT_CONTEXT_SYMBOL] || null;
61
+ }
62
+ return null;
63
+ }
64
+
65
+ /**
66
+ * 父组件 Hook
67
+ */
68
+ export function useParent(componentName?: string) {
69
+ const instance = getCurrentInstance();
70
+ if (!instance) {
71
+ throw new Error('useParent must be called within setup function');
72
+ }
73
+
74
+ // 使用组件名称作为默认名称
75
+ const name = componentName || instance.type.name || instance.type.__name;
76
+ if (!name) {
77
+ throw new Error('Component name is required for useParent. Either provide a name or set component name.');
78
+ }
79
+
80
+ const children = reactive<ChildContext[]>([]);
81
+ const childrenMap = new Map<string, ChildContext>();
82
+
83
+ // 父组件上下文
84
+ const parentContext: ParentContext = {
85
+ name,
86
+
87
+ addChild(child: ChildContext) {
88
+ if (!childrenMap.has(child.id)) {
89
+ childrenMap.set(child.id, child);
90
+ children.push(child);
91
+ logger.log(`Parent ${name} added child: ${child.name} (${child.id})`);
92
+ }
93
+ },
94
+
95
+ removeChild(childId: string) {
96
+ if (childrenMap.has(childId)) {
97
+ const child = childrenMap.get(childId)!;
98
+ childrenMap.delete(childId);
99
+ const index = children.findIndex(c => c.id === childId);
100
+ if (index > -1) {
101
+ children.splice(index, 1);
102
+ }
103
+ logger.log(`Parent ${name} removed child: ${childId}`);
104
+ }
105
+ },
106
+
107
+ broadcast(event: string, data?: any) {
108
+ logger.log(`Parent ${name} broadcasting event: ${event} to ${childrenMap.size} children`);
109
+ childrenMap.forEach(child => {
110
+ const exposed = child.getExposed();
111
+ if (exposed && typeof exposed[event] === 'function') {
112
+ try {
113
+ exposed[event](data);
114
+ } catch (error) {
115
+ logger.warn(`Error calling child method ${event}:`, error);
116
+ }
117
+ }
118
+ });
119
+ },
120
+
121
+ getChildren() {
122
+ return Array.from(childrenMap.values());
123
+ },
124
+
125
+ getExposed() {
126
+ return instance.exposed || {};
127
+ },
128
+
129
+ getChildExposed(childId: string) {
130
+ const child = childrenMap.get(childId);
131
+ if (child && child.getExposed) {
132
+ return child.getExposed();
133
+ }
134
+ logger.warn(`Child ${childId} not found or does not have getExposed method`);
135
+ return {};
136
+ },
137
+
138
+ getChildrenExposed() {
139
+ return Array.from(childrenMap.values())
140
+ .filter(child => child.getExposed)
141
+ .map(child => {
142
+ const exposed = child.getExposed();
143
+ return {
144
+ id: child.id,
145
+ name: child.name,
146
+ exposed: exposed
147
+ };
148
+ })
149
+ .filter(item => Object.keys(item.exposed).length > 0);
150
+ }
151
+ };
152
+
153
+ // 在组件实例上存储父组件上下文
154
+ if (instance.proxy) {
155
+ instance.proxy[PARENT_CONTEXT_SYMBOL] = parentContext;
156
+ }
157
+
158
+ // 组件卸载时清理
159
+ onUnmounted(() => {
160
+ // 清理所有子组件引用
161
+ childrenMap.forEach((child, childId) => {
162
+ parentContext.removeChild(childId);
163
+ });
164
+ if (instance.proxy) {
165
+ delete instance.proxy[PARENT_CONTEXT_SYMBOL];
166
+ }
167
+ logger.log(`Parent ${name} unmounted and cleaned up`);
168
+ });
169
+
170
+ return {
171
+ parentName: name,
172
+ children,
173
+ broadcast: parentContext.broadcast,
174
+ getChildren: parentContext.getChildren,
175
+ getChildExposed: parentContext.getChildExposed,
176
+ getChildrenExposed: parentContext.getChildrenExposed,
177
+ getExposed: parentContext.getExposed
178
+ };
179
+ }
180
+
181
+ /**
182
+ * 子组件 Hook
183
+ */
184
+ export function useChildren(componentName?: string, parentName?: string) {
185
+ const instance = getCurrentInstance();
186
+ if (!instance) {
187
+ throw new Error('useChildren must be called within setup function');
188
+ }
189
+
190
+ // 使用组件名称作为默认名称
191
+ const name = componentName || instance.type.name || instance.type.__name;
192
+ if (!name) {
193
+ throw new Error('Component name is required for useChildren. Either provide a name or set component name.');
194
+ }
195
+
196
+ const instanceId = generateInstanceId(name);
197
+ const parentRef = ref<ParentContext | null>(null);
198
+ const parentExposed = ref<Record<string, any>>({});
199
+
200
+ // 获取父组件暴露内容
201
+ const getParentExposed = (): Record<string, any> => {
202
+ if (parentRef.value) {
203
+ const exposed = parentRef.value.getExposed();
204
+ parentExposed.value = exposed;
205
+ return exposed;
206
+ }
207
+ return {};
208
+ };
209
+
210
+ // 获取子组件exposed内容
211
+ const getExposed = (): Record<string, any> => {
212
+ return instance.exposed || {};
213
+ };
214
+
215
+ // 查找父组件
216
+ const findParent = (): ParentContext | null => {
217
+ // 如果指定了父组件名称,使用精确查找
218
+ if (parentName) {
219
+ return getParentContext(parentName, instance);
220
+ }
221
+
222
+ // 否则查找最近的父组件上下文
223
+ let current = instance.parent;
224
+ while (current) {
225
+ const context = current.proxy?.[PARENT_CONTEXT_SYMBOL];
226
+ if (context) {
227
+ return context;
228
+ }
229
+ current = current.parent;
230
+ }
231
+ return null;
232
+ };
233
+
234
+ // 链接到父组件
235
+ const linkParent = (): boolean => {
236
+ const parent = findParent();
237
+ if (parent) {
238
+ parentRef.value = parent;
239
+ parent.addChild(childContext);
240
+ getParentExposed();
241
+ logger.log(`Child ${name} linked to parent ${parent.name}`);
242
+ return true;
243
+ }
244
+ return false;
245
+ };
246
+
247
+ // 向父组件发送事件
248
+ const emitToParent = (event: string, data?: any) => {
249
+ if (parentRef.value) {
250
+ const exposed = parentRef.value.getExposed();
251
+ if (exposed && typeof exposed[event] === 'function') {
252
+ try {
253
+ exposed[event](data, instanceId, name);
254
+ } catch (error) {
255
+ logger.warn(`Error calling parent method ${event}:`, error);
256
+ }
257
+ } else {
258
+ logger.warn(`Parent method ${event} not found or not a function`);
259
+ }
260
+ } else {
261
+ logger.warn(`No parent found to emit event: ${event}`);
262
+ }
263
+ };
264
+
265
+ // 子组件上下文
266
+ const childContext: ChildContext = {
267
+ id: instanceId,
268
+ name,
269
+ emitToParent,
270
+ getParentExposed,
271
+ getInstance() {
272
+ return instance;
273
+ },
274
+ getExposed
275
+ };
276
+
277
+ logger.log(`Child ${name} registered, looking for parent`);
278
+
279
+ onMounted(() => {
280
+ // 立即尝试连接父组件
281
+ let connected = linkParent();
282
+ nextTick(() => {
283
+ // 如果未连接成功,500ms后重试一次
284
+ if (!connected) {
285
+ setTimeout(() => {
286
+ linkParent();
287
+ }, 500);
288
+ }
289
+ });
290
+ });
291
+
292
+ // 组件卸载时清理
293
+ onUnmounted(() => {
294
+ if (parentRef.value) {
295
+ parentRef.value.removeChild(instanceId);
296
+ }
297
+ logger.log(`Child ${name} unmounted`);
298
+ });
299
+
300
+ return {
301
+ childId: instanceId,
302
+ childName: name,
303
+ parent: parentRef,
304
+ emitToParent,
305
+ getParentExposed,
306
+ parentExposed: computed(() => parentExposed.value),
307
+ getExposed
308
+ };
309
+ }
310
+
311
+ /**
312
+ * 检查父组件是否存在
313
+ */
314
+ export function hasParent(parentName?: string): boolean {
315
+ const instance = getCurrentInstance();
316
+ if (!instance) return false;
317
+
318
+ if (parentName) {
319
+ return getParentContext(parentName, instance) !== null;
320
+ }
321
+
322
+ // 查找最近的父组件上下文
323
+ let current = instance.parent;
324
+ while (current) {
325
+ const context = current.proxy?.[PARENT_CONTEXT_SYMBOL];
326
+ if (context) {
327
+ return true;
328
+ }
329
+ current = current.parent;
330
+ }
331
+ return false;
332
+ }
333
+
334
+ /**
335
+ * 获取父组件上下文
336
+ */
337
+ export function getParentContextByName(parentName: string): ParentContext | null {
338
+ const instance = getCurrentInstance();
339
+ if (!instance) return null;
340
+ return getParentContext(parentName, instance);
341
+ }
342
+
343
+ /**
344
+ * 热更新清理函数
345
+ */
346
+ export function cleanupComponentRelations(): void {
347
+ logger.log('Cleaning up component relations for hot reload');
348
+ // 由于使用组件实例存储,热更新时会自动重新建立关系
349
+ }
350
+
351
+ // 热更新处理
352
+ if (import.meta.hot) {
353
+ import.meta.hot.accept(() => {
354
+ logger.log('Hot reload detected, relations will be automatically reconnected');
355
+ });
356
+ }
357
+
358
+ export default {
359
+ useParent,
360
+ useChildren,
361
+ hasParent,
362
+ getParentContextByName,
363
+ cleanupComponentRelations
364
+ };