uview-pro 0.3.1 → 0.3.3

package/changelog.md

@@ -1,3 +1,40 @@
+## 0.3.3（2025-10-16）
+
+### 🐛 Bug Fixes | Bug 修复
+
+- **u-read-more:** 修复 init 方法无法在外部调用的问题 ([415d401](https://github.com/anyup/uView-Pro/commit/415d401883a3567653ab1f311b28b075b7bb5603))
+- **u-button:** 修复 hover-class 属性被忽略的问题 ([b919c58](https://github.com/anyup/uView-Pro/commit/b919c58cea048f9e559a6448cebe5abbf1490acf))
+
+### ♻️ Code Refactoring | 代码重构
+
+- **component-relation:** 重构组件关系逻辑并添加新功能 ([85d0cd2](https://github.com/anyup/uView-Pro/commit/85d0cd20db839a61733887f82825d47de0a1b1a6))
+- **u-talbe:** 重构u-td和u-th组件，增强u-table的兼容性 ([3fbbc52](https://github.com/anyup/uView-Pro/commit/3fbbc5233bd41b91ca829f9a65cf95ee3b599e36))
+- 修改 uView Pro 日志配置 ([6b9bb68](https://github.com/anyup/uView-Pro/commit/6b9bb6852af3eb24f109207f864145771c3e9c79))
+- **clipboard:** add clipboard function ([efdaa58](https://github.com/anyup/uView-Pro/commit/efdaa58dda923b281d9b764a82a7492f36717ac4))
+
+### 👥 Contributors
+
+<a href="https://github.com/koboshi"><img src="https://github.com/koboshi.png?size=40" width="40" height="40" alt="koboshi" title="koboshi"/></a> <a href="https://github.com/anyup"><img src="https://github.com/anyup.png?size=40" width="40" height="40" alt="anyup" title="anyup"/></a> <a href="https://github.com/lonelyflyer"><img src="https://github.com/lonelyflyer.png?size=40" width="40" height="40" alt="Lonelyflyer" title="Lonelyflyer"/></a> 
+
+## 0.3.2（2025-10-15）
+
+### 📝 Documentation | 文档
+
+- **changelog:** 更新 CHANGELOG.md 生成配置 ([27a2609](https://github.com/anyup/uView-Pro/commit/27a26095b92cf8cbc6477c563a68b1557f9fb045))
+- 更新交流群图片链接 ([832815d](https://github.com/anyup/uView-Pro/commit/832815deb63f8b144f525591d16e3ccf900b8632))
+
+### ⚡ Performance Improvements | 性能优化
+
+- **component-relation:** 增强组件间通信功能；修改 broadcast 方法，支持定向广播；移除对子组件名称的强制要求，允许匿名组件 ([28ea814](https://github.com/anyup/uView-Pro/commit/28ea814810055aa4c99b53d676b16da337fdf7d5))
+
+### 🐛 Bug Fixes | Bug 修复
+
+- **u-index-list:** 重构索引锚点组件，兼容多端，修复IndexList索引列表在微信小程序没有吸顶效果 ([ce6a7a3](https://github.com/anyup/uView-Pro/commit/ce6a7a3c01b622cad268779098390c0d593f75bc))
+
+### 👥 Contributors
+
+<a href="https://github.com/anyup"><img src="https://github.com/anyup.png?size=40" width="40" height="40" alt="anyup" title="anyup"/></a>
+
 ## 0.3.1（2025-10-14）
 
 ### 📝 Documentation | 文档

package/components/u-button/u-button.vue

@@ -151,7 +151,9 @@ const waveActive = ref(false); // 激活水波纹
  */
 const getHoverClass = computed(() => {
     // 如果开启水波纹效果，则不启用hover-class效果
-    if (props.loading || props.disabled || props.ripple || props.hoverClass) return '';
+    if (props.loading || props.disabled || props.ripple) return '';
+    // 如果用户传了 hoverClass，优先使用用户的
+    if (props.hoverClass) return props.hoverClass;
     let hoverClass = '';
     hoverClass = props.plain ? 'u-' + props.type + '-plain-hover' : 'u-' + props.type + '-hover';
     return hoverClass;

package/components/u-index-anchor/u-index-anchor.vue

@@ -31,8 +31,8 @@ export default {
 
 <script setup lang="ts">
 import { IndexAnchorProps } from './types';
-import { ref, computed, onMounted, getCurrentInstance } from 'vue';
-import { $u } from '../..';
+import { ref, onMounted } from 'vue';
+import { $u, useChildren } from '../..';
 
 /**
  * indexAnchor 索引列表锚点
@@ -46,28 +46,54 @@ import { $u } from '../..';
  */
 
 const props = defineProps(IndexAnchorProps);
+const { parentExposed } = useChildren('u-index-anchor', 'u-index-list');
 
 // 响应式变量
 const active = ref(false);
 const wrapperStyle = ref<Record<string, any>>({});
 const anchorStyle = ref<Record<string, any>>({});
-let parent: any = null;
-
-const instance = getCurrentInstance();
+const top = ref(0);
+const height = ref(0);
 
 // 挂载时查找父组件并注册
 onMounted(() => {
-    parent = $u.$parent('u-index-list', instance);
-    if (parent) {
-        parent.exposed?.children.push(instance);
-        parent.exposed?.updateData();
+    if (parentExposed) {
+        parentExposed?.value?.updateData();
     }
 });
+
+function setTop(val) {
+    top.value = val;
+}
+
+function setHeight(val) {
+    height.value = val;
+}
+
+function setActive(val) {
+    active.value = val;
+}
+
+function setAnchorStyle(val) {
+    anchorStyle.value = val;
+}
+
+function setWrapperStyle(val) {
+    wrapperStyle.value = val;
+}
+
 defineExpose({
+    props,
+    top,
+    height,
     active,
     wrapperStyle,
     anchorStyle,
-    props
+    setTop,
+    setHeight,
+    setActive,
+    setAnchorStyle,
+    setWrapperStyle
 });
 </script>
 

package/components/u-index-list/u-index-list.vue

@@ -49,7 +49,7 @@ export default {
 
 <script setup lang="ts">
 import { ref, reactive, computed, watch, onMounted, getCurrentInstance } from 'vue';
-import { $u } from '../..';
+import { $u, useParent } from '../..';
 import { IndexListProps } from './types';
 
 /**
@@ -84,8 +84,6 @@ const activeAnchorIndex = ref(0);
 const showSidebar = ref(true);
 const touchmove = ref(false);
 const touchmoveIndex = ref(0);
-// 孩子锚点组件
-const children = reactive<any[]>([]);
 const sidebar = reactive<{ height: number; top: number }>({ height: 0, top: 0 });
 const scrollToAnchorIndex = ref<number | null>(null);
 const timer = ref<any>(null);
@@ -101,8 +99,7 @@ const indexList = computed(() => props.indexList ?? getIndexList()).value;
 const zIndex = computed(() => props.zIndex).value;
 const activeColor = computed(() => props.activeColor).value;
 
-// 只能在created生命周期定义children，如果在data定义，会因为循环引用而报错
-children.length = 0;
+const { children, broadcast } = useParent('u-index-anchor');
 
 // 兼容 H5/非H5 stickyOffsetTop
 onMounted(() => {
@@ -146,11 +143,9 @@ function setRect() {
 function setAnchorsRect() {
     return Promise.all(
         children.map((anchor, index) => {
-            $u.getRect('.u-index-anchor-wrapper', anchor).then((rect: any) => {
-                Object.assign(anchor, {
-                    height: rect.height,
-                    top: rect.top
-                });
+            $u.getRect('.u-index-anchor-wrapper', anchor.getInstance()).then((rect: any) => {
+                broadcast('setTop', rect.top, anchor.id);
+                broadcast('setHeight', rect.height, anchor.id);
             });
         })
     );
@@ -182,9 +177,9 @@ function setSiderbarRect() {
 function getActiveAnchorIndex() {
     const sticky = props.sticky;
     for (let i = children.length - 1; i >= 0; i--) {
-        const preAnchorHeight = i > 0 ? children[i - 1].height : 0;
+        const preAnchorHeight = i > 0 ? children[i - 1].getExposed().height.value : 0;
         const reachTop = sticky ? preAnchorHeight : 0;
-        if (reachTop >= children[i].top) {
+        if (reachTop >= children[i].getExposed().top.value) {
             return i;
         }
     }
@@ -203,7 +198,7 @@ function onScroll() {
     if (sticky) {
         let isActiveAnchorSticky = false;
         if (active !== -1) {
-            isActiveAnchorSticky = children[active].top <= 0;
+            isActiveAnchorSticky = children[active].getExposed().top.value <= 0;
         }
         children.forEach((item, index) => {
             if (index === active) {
@@ -212,7 +207,7 @@ function onScroll() {
                     color: `${activeColor}`
                 };
                 if (isActiveAnchorSticky) {
-                    wrapperStyle = { height: `${children[index].height}px` };
+                    wrapperStyle = { height: `${children[index].getExposed().height.value}px` };
                     anchorStyle = {
                         position: 'fixed',
                         top: `${stickyOffsetTop.value}px`,
@@ -220,31 +215,30 @@ function onScroll() {
                         color: `${activeColor}`
                     };
                 }
-                item.active = active;
-                item.wrapperStyle = wrapperStyle;
-                item.anchorStyle = anchorStyle;
+                broadcast('setActive', active, item.id);
+                broadcast('setAnchorStyle', anchorStyle, item.id);
+                broadcast('setWrapperStyle', wrapperStyle, item.id);
             } else if (index === active - 1) {
                 const currentAnchor = children[index];
-                const currentOffsetTop = currentAnchor.top;
-                const targetOffsetTop = index === children.length - 1 ? top.value : children[index + 1].top;
+                const currentOffsetTop = currentAnchor.getExposed().top.value;
+                const targetOffsetTop =
+                    index === children.length - 1 ? top.value : children[index + 1].getExposed().top.value;
                 const parentOffsetHeight = targetOffsetTop - currentOffsetTop;
-                const translateY = parentOffsetHeight - currentAnchor.height;
+                const translateY = parentOffsetHeight - currentAnchor.getExposed().height.value;
                 const anchorStyle = {
                     position: 'relative',
                     transform: `translate3d(0, ${translateY}px, 0)`,
                     zIndex: `${zIndex ? zIndex : $u.zIndex.indexListSticky}`,
                     color: `${activeColor}`
                 };
-                item.active = active;
-                item.anchorStyle = anchorStyle;
+                broadcast('setActive', active, currentAnchor.id);
+                broadcast('setAnchorStyle', anchorStyle, currentAnchor.id);
+                broadcast('setWrapperStyle', '', item.id);
             } else {
-                item.active = false;
-                item.anchorStyle = '';
-                item.wrapperStyle = '';
+                broadcast('setActive', false, item.id);
+                broadcast('setAnchorStyle', '', item.id);
+                broadcast('setWrapperStyle', '', item.id);
             }
-            item.exposed.active = item.active;
-            item.exposed.anchorStyle = item.anchorStyle;
-            item.exposed.wrapperStyle = item.wrapperStyle;
         });
     }
 }
@@ -284,12 +278,12 @@ function scrollToAnchor(index: number) {
         return;
     }
     scrollToAnchorIndex.value = index;
-    const anchor = children.find(item => item.props.index === indexList[index]);
+    const anchor = children.find(item => item.getExposed().props.index === indexList[index]);
     if (anchor) {
-        emit('select', anchor.props.index);
+        emit('select', anchor.getExposed().props.index);
         uni.pageScrollTo({
             duration: 0,
-            scrollTop: anchor.top + Number(props.scrollTop)
+            scrollTop: anchor.getExposed().top.value + Number(props.scrollTop)
         });
     }
 }

package/components/u-read-more/u-read-more.vue

@@ -119,6 +119,10 @@ function init() {
         }
     });
 }
+// 显式暴露init方法
+defineExpose({
+    init
+});
 
 /**
  * 展开或者收起内容

package/components/u-td/u-td.vue

@@ -18,8 +18,8 @@ export default {
 </script>
 
 <script setup lang="ts">
-import { ref, onMounted, getCurrentInstance, watch } from 'vue';
-import { $u } from '../..';
+import { computed } from 'vue';
+import { $u, useChildren } from '../..';
 import { TdProps } from './types';
 
 /**
@@ -32,52 +32,19 @@ import { TdProps } from './types';
 
 const props = defineProps(TdProps);
 
-/**
- * 组合式API变量声明
- * 保留所有说明注释
- */
-const tdStyle = ref<Record<string, any>>({}); // 单元格样式
-let parent: any = null; // 父组件实例
-
-/**
- * 更新单元格样式
- */
-function updateStyle() {
-    if (!parent) return;
+const { parentExposed } = useChildren('u-td', 'u-table');
 
+const tdStyle = computed(() => {
     const style: Record<string, any> = {};
     if (props.width && props.width !== 'auto') style.width = props.width;
     else style.flex = '1';
-    style.textAlign = parent.props.align;
-    style.fontSize = parent.props.fontSize + 'rpx';
-    style.padding = parent.props.padding;
-    style.borderBottom = `solid 1px ${parent.props.borderColor}`;
-    style.borderRight = `solid 1px ${parent.props.borderColor}`;
-    style.color = parent.props.color;
-    tdStyle.value = style;
-}
-
-/**
- * 组件挂载时查找父组件u-table并合并样式
- */
-onMounted(() => {
-    // 查找父组件u-table
-    const instance = getCurrentInstance();
-    if (instance) {
-        parent = $u.$parent('u-table');
-        if (parent) {
-            updateStyle();
-
-            // 监听父组件属性变化
-            watch(
-                () => parent.props,
-                () => {
-                    updateStyle();
-                },
-                { deep: true }
-            );
-        }
-    }
+    style.textAlign = parentExposed.value?.props?.align;
+    style.fontSize = parentExposed.value?.props?.fontSize + 'rpx';
+    style.padding = parentExposed.value?.props?.padding;
+    style.borderBottom = `solid 1px ${parentExposed.value?.props?.borderColor}`;
+    style.borderRight = `solid 1px ${parentExposed.value?.props?.borderColor}`;
+    style.color = parentExposed.value?.props?.color;
+    return style;
 });
 </script>
 

package/components/u-th/u-th.vue

@@ -18,8 +18,8 @@ export default {
 </script>
 
 <script setup lang="ts">
-import { ref, onMounted, getCurrentInstance, watch } from 'vue';
-import { $u } from '../..';
+import { computed } from 'vue';
+import { $u, useChildren } from '../..';
 import { ThProps } from './types';
 
 /**
@@ -32,47 +32,18 @@ import { ThProps } from './types';
 
 const props = defineProps(ThProps);
 
-const thStyle = ref<Record<string, any>>({}); // 标题单元格样式
-let parent: any = null; // 父组件实例
-
-/**
- * 更新标题单元格样式
- */
-function updateStyle() {
-    if (!parent) return;
+const { parentExposed } = useChildren('u-th', 'u-table');
 
+const thStyle = computed(() => {
     const style: Record<string, any> = {};
     if (props.width && props.width !== 'auto') style.width = props.width;
     else style.flex = '1';
-    style.textAlign = parent.props.align;
-    style.padding = parent.props.padding;
-    style.borderBottom = `solid 1px ${parent.props.borderColor}`;
-    style.borderRight = `solid 1px ${parent.props.borderColor}`;
-    Object.assign(style, parent.props.thStyle);
-    thStyle.value = style;
-}
-
-/**
- * 组件挂载时查找父组件u-table并合并样式
- */
-onMounted(() => {
-    // 查找父组件u-table
-    const instance = getCurrentInstance();
-    if (instance) {
-        parent = $u.$parent('u-table');
-        if (parent) {
-            updateStyle();
-
-            // 监听父组件属性变化
-            watch(
-                () => parent.props,
-                () => {
-                    updateStyle();
-                },
-                { deep: true }
-            );
-        }
-    }
+    style.textAlign = parentExposed.value?.props?.align;
+    style.padding = parentExposed.value?.props?.padding;
+    style.borderBottom = `solid 1px ${parentExposed.value?.props?.borderColor}`;
+    style.borderRight = `solid 1px ${parentExposed.value?.props?.borderColor}`;
+    Object.assign(style, parentExposed.value?.props?.thStyle);
+    return style;
 });
 </script>
 

package/libs/function/clipboard.ts

@@ -0,0 +1,78 @@
+function H5Copy(text: string, config: TClipboardOptions) {
+    const success = (result: string) => {
+        if (config.showToast) {
+            uni.showToast({
+                title: '复制成功',
+                icon: 'none'
+            });
+        }
+        config.success(result);
+        config.complete(result);
+    };
+    const fail = (err: string) => {
+        if (config.showToast) {
+            uni.showToast({
+                title: '复制失败',
+                icon: 'none'
+            });
+        }
+        config.fail(err);
+        config.complete(err);
+    };
+
+    const textarea = document.createElement('textarea');
+    textarea.value = text;
+    textarea.readOnly = true;
+    textarea.style.position = 'absolute';
+    textarea.style.left = '-9999px';
+    document.body.appendChild(textarea);
+
+    textarea.select();
+    textarea.setSelectionRange(0, text.length);
+
+    try {
+        const result = document.execCommand('copy');
+        if (result) {
+            success('复制成功');
+        } else {
+            // console.error(`复制失败，可能不是用户主动触发点击的方式调用,因web安全性，不能js直接调用!`);
+            fail('复制失败，可能不是用户主动触发点击的方式调用,因browser安全性，不能js直接调用!');
+        }
+    } catch (err) {
+        // console.error('【Clipboard Error】:', err);
+        fail(err);
+    } finally {
+        document.body.removeChild(textarea);
+    }
+}
+
+function UniCopy(text: string, config: TClipboardOptions) {
+    const opt = Object.assign({ data: text }, config);
+    console.log(opt);
+    uni.setClipboardData(opt);
+}
+
+type TClipboardOptions = Omit<UniNamespace.SetClipboardDataOptions, 'data'>;
+
+export function clipboard(content: string, options?: TClipboardOptions) {
+    const text = String(content);
+    const showToast = typeof options.showToast === 'boolean' ? options.showToast : true;
+    const copySuccessCb = typeof options.success === 'function' ? options.success : () => {};
+    const copyFailCb = typeof options.success === 'function' ? options.fail : () => {};
+    const copyCompleteCb = typeof options.complete === 'function' ? options.complete : () => {};
+
+    let config: TClipboardOptions = {
+        showToast,
+        success: copySuccessCb,
+        fail: copyFailCb,
+        complete: copyCompleteCb
+    };
+
+    // #ifdef H5
+    H5Copy(text, config);
+    // #endif
+
+    // #ifndef H5
+    UniCopy(text, config);
+    // #endif
+}

package/libs/hooks/useCompRelation.ts

@@ -1,5 +1,14 @@
 // utils/useComponent.ts
-import { ref, reactive, getCurrentInstance, onUnmounted, nextTick, computed, watch, onMounted } from 'vue';
+import {
+    ref,
+    reactive,
+    getCurrentInstance,
+    onUnmounted,
+    nextTick,
+    computed,
+    onMounted,
+    type ComponentInternalInstance
+} from 'vue';
 import { logger } from '../util/logger';
 
 // 类型定义
@@ -7,11 +16,13 @@ interface ParentContext {
     name: string;
     addChild: (child: ChildContext) => void;
     removeChild: (childId: string) => void;
-    broadcast: (event: string, data?: any) => void;
+    broadcast: (event: string, data?: any, childIds?: string | string[]) => void;
+    broadcastToChildren: (componentName: string, event: string, data?: any) => void;
     getChildren: () => ChildContext[];
     getExposed: () => Record<string, any>;
     getChildExposed: (childId: string) => Record<string, any>;
     getChildrenExposed: () => Array<{ id: string; name: string; exposed: Record<string, any> }>;
+    getInstance: () => any;
 }
 
 interface ChildContext {
@@ -25,7 +36,6 @@ interface ChildContext {
 
 // 符号定义
 const PARENT_CONTEXT_SYMBOL = Symbol('parent_context');
-const CHILDREN_CONTEXT_SYMBOL = Symbol('children_context');
 
 /**
  * 生成实例唯一ID
@@ -56,10 +66,36 @@ function findParentInstance(name: string, instance: any): any {
  */
 function getParentContext(name: string, instance: any): ParentContext | null {
     const parentInstance = findParentInstance(name, instance);
-    if (parentInstance) {
-        return parentInstance.proxy?.[PARENT_CONTEXT_SYMBOL] || null;
+    return parentInstance?.proxy?.[PARENT_CONTEXT_SYMBOL] || null;
+}
+
+/**
+ * 递归查找所有指定名称的子组件
+ */
+function findAllChildComponents(componentName: string, instance: any): any[] {
+    const components: any[] = [];
+
+    function traverse(currentInstance: any) {
+        if (!currentInstance?.subTree) return;
+
+        const subTree = currentInstance.subTree?.children || [];
+        const children = Array.isArray(subTree) ? subTree : [subTree];
+
+        children.forEach((vnode: any) => {
+            const child = vnode.component;
+            if (!child) return;
+
+            const name = child.type?.name || child.type?.__name;
+            if (name === componentName) {
+                components.push(child);
+            }
+            traverse(child);
+        });
     }
-    return null;
+
+    traverse(instance);
+    logger.log(`Found ${components.length} ${componentName} components`);
+    return components;
 }
 
 /**
@@ -71,96 +107,103 @@ export function useParent(componentName?: string) {
         throw new Error('useParent must be called within setup function');
     }
 
-    // 使用组件名称作为默认名称
     const name = componentName || instance.type.name || instance.type.__name;
     if (!name) {
-        throw new Error('Component name is required for useParent. Either provide a name or set component name.');
+        throw new Error('Component name is required for useParent');
     }
 
     const children = reactive<ChildContext[]>([]);
     const childrenMap = new Map<string, ChildContext>();
 
-    // 父组件上下文
+    const broadcast = (event: string, data?: any, childIds?: string | string[]) => {
+        const targetChildren = childIds
+            ? ((Array.isArray(childIds) ? childIds : [childIds])
+                  .map(id => childrenMap.get(id))
+                  .filter(Boolean) as ChildContext[])
+            : Array.from(childrenMap.values());
+
+        logger.log(`Parent ${name} broadcasting event: ${event} to ${targetChildren.length} children`);
+
+        targetChildren.forEach(child => {
+            const exposed = child.getExposed();
+            if (exposed && typeof exposed[event] === 'function') {
+                try {
+                    exposed[event](data);
+                } catch (error) {
+                    logger.warn(`Error calling child method ${event}:`, error);
+                }
+            }
+        });
+    };
+
+    const broadcastToChildren = (componentName: string, event: string, data?: any) => {
+        logger.log(`Parent ${name} broadcasting event: ${event} to all ${componentName} components`);
+
+        const childComponents = findAllChildComponents(componentName, instance);
+        let successCount = 0;
+
+        childComponents.forEach(childComponent => {
+            const exposed = childComponent.exposed || childComponent.proxy;
+            if (exposed && typeof exposed[event] === 'function') {
+                try {
+                    exposed[event](data);
+                    successCount++;
+                } catch (error) {
+                    logger.warn(`Error calling ${componentName} method ${event}:`, error);
+                }
+            }
+        });
+
+        logger.log(
+            `Parent ${name} successfully called ${successCount} of ${childComponents.length} ${componentName} components`
+        );
+    };
+
     const parentContext: ParentContext = {
         name,
-
         addChild(child: ChildContext) {
             if (!childrenMap.has(child.id)) {
                 childrenMap.set(child.id, child);
                 children.push(child);
-                logger.log(`Parent ${name} added child: ${child.name} (${child.id})`);
+                logger.log(`Parent ${name} added child: ${child.name}`);
             }
         },
-
         removeChild(childId: string) {
             if (childrenMap.has(childId)) {
                 const child = childrenMap.get(childId)!;
                 childrenMap.delete(childId);
                 const index = children.findIndex(c => c.id === childId);
-                if (index > -1) {
-                    children.splice(index, 1);
-                }
+                if (index > -1) children.splice(index, 1);
                 logger.log(`Parent ${name} removed child: ${childId}`);
             }
         },
-
-        broadcast(event: string, data?: any) {
-            logger.log(`Parent ${name} broadcasting event: ${event} to ${childrenMap.size} children`);
-            childrenMap.forEach(child => {
-                const exposed = child.getExposed();
-                if (exposed && typeof exposed[event] === 'function') {
-                    try {
-                        exposed[event](data);
-                    } catch (error) {
-                        logger.warn(`Error calling child method ${event}:`, error);
-                    }
-                }
-            });
-        },
-
-        getChildren() {
-            return Array.from(childrenMap.values());
-        },
-
-        getExposed() {
-            return instance.exposed || {};
-        },
-
+        broadcast,
+        broadcastToChildren,
+        getChildren: () => Array.from(childrenMap.values()),
+        getExposed: () => instance.exposed || {},
         getChildExposed(childId: string) {
             const child = childrenMap.get(childId);
-            if (child && child.getExposed) {
-                return child.getExposed();
-            }
-            logger.warn(`Child ${childId} not found or does not have getExposed method`);
-            return {};
+            return child?.getExposed?.() || {};
         },
-
         getChildrenExposed() {
             return Array.from(childrenMap.values())
                 .filter(child => child.getExposed)
-                .map(child => {
-                    const exposed = child.getExposed();
-                    return {
-                        id: child.id,
-                        name: child.name,
-                        exposed: exposed
-                    };
-                })
+                .map(child => ({
+                    id: child.id,
+                    name: child.name,
+                    exposed: child.getExposed()
+                }))
                 .filter(item => Object.keys(item.exposed).length > 0);
-        }
+        },
+        getInstance: () => instance
     };
 
-    // 在组件实例上存储父组件上下文
     if (instance.proxy) {
         instance.proxy[PARENT_CONTEXT_SYMBOL] = parentContext;
     }
 
-    // 组件卸载时清理
     onUnmounted(() => {
-        // 清理所有子组件引用
-        childrenMap.forEach((child, childId) => {
-            parentContext.removeChild(childId);
-        });
+        childrenMap.forEach((_, childId) => parentContext.removeChild(childId));
         if (instance.proxy) {
             delete instance.proxy[PARENT_CONTEXT_SYMBOL];
         }
@@ -170,11 +213,13 @@ export function useParent(componentName?: string) {
     return {
         parentName: name,
         children,
-        broadcast: parentContext.broadcast,
+        broadcast,
+        broadcastToChildren,
         getChildren: parentContext.getChildren,
         getChildExposed: parentContext.getChildExposed,
         getChildrenExposed: parentContext.getChildrenExposed,
-        getExposed: parentContext.getExposed
+        getExposed: parentContext.getExposed,
+        getInstance: parentContext.getInstance
     };
 }
 
@@ -187,17 +232,24 @@ export function useChildren(componentName?: string, parentName?: string) {
         throw new Error('useChildren must be called within setup function');
     }
 
-    // 使用组件名称作为默认名称
     const name = componentName || instance.type.name || instance.type.__name;
-    if (!name) {
-        throw new Error('Component name is required for useChildren. Either provide a name or set component name.');
-    }
-
-    const instanceId = generateInstanceId(name);
-    const parentRef = ref<ParentContext | null>(null);
+    const instanceId = generateInstanceId(name || 'anonymous');
+    const parentRef = ref<any | null>(null);
     const parentExposed = ref<Record<string, any>>({});
 
-    // 获取父组件暴露内容
+    const createSimulatedParentContext = (parentInstance: any): ParentContext => ({
+        name: parentInstance?.type?.name || parentInstance?.type?.__name || 'unknown',
+        addChild: () => logger.log('Simulated parent added child'),
+        removeChild: () => logger.log('Simulated parent removed child'),
+        broadcast: () => logger.log('Simulated parent broadcasting'),
+        broadcastToChildren: () => logger.log('Simulated parent broadcasting to children'),
+        getChildren: () => [],
+        getExposed: () => parentInstance?.exposed || {},
+        getChildExposed: () => ({}),
+        getChildrenExposed: () => [],
+        getInstance: () => parentInstance
+    });
+
     const getParentExposed = (): Record<string, any> => {
         if (parentRef.value) {
             const exposed = parentRef.value.getExposed();
@@ -207,99 +259,98 @@ export function useChildren(componentName?: string, parentName?: string) {
         return {};
     };
 
-    // 获取子组件exposed内容
-    const getExposed = (): Record<string, any> => {
-        return instance.exposed || {};
-    };
+    const getExposed = (): Record<string, any> => instance.exposed || {};
 
-    // 查找父组件
     const findParent = (): ParentContext | null => {
-        // 如果指定了父组件名称，使用精确查找
         if (parentName) {
-            return getParentContext(parentName, instance);
+            const parentContext = getParentContext(parentName, instance);
+            if (parentContext) {
+                if (!parentContext.getInstance) {
+                    parentContext.getInstance = () => findParentInstance(parentName, instance);
+                }
+                return parentContext;
+            }
+
+            const parentInstance = findParentInstance(parentName, instance);
+            if (parentInstance) {
+                return createSimulatedParentContext(parentInstance);
+            }
         }
 
-        // 否则查找最近的父组件上下文
         let current = instance.parent;
         while (current) {
             const context = current.proxy?.[PARENT_CONTEXT_SYMBOL];
             if (context) {
+                if (!context.getInstance) {
+                    context.getInstance = () => current;
+                }
                 return context;
             }
             current = current.parent;
         }
-        return null;
+
+        return instance.parent ? createSimulatedParentContext(instance.parent) : null;
     };
 
-    // 链接到父组件
     const linkParent = (): boolean => {
         const parent = findParent();
         if (parent) {
             parentRef.value = parent;
-            parent.addChild(childContext);
+            if (parent.addChild && childContext) {
+                parent.addChild(childContext);
+            }
             getParentExposed();
-            logger.log(`Child ${name} linked to parent ${parent.name}`);
+            logger.log(`Child ${name || 'anonymous'} linked to parent ${parent.name}`);
             return true;
         }
+        logger.log(`Child ${name || 'anonymous'} no parent found, working in standalone mode`);
         return false;
     };
 
-    // 向父组件发送事件
     const emitToParent = (event: string, data?: any) => {
         if (parentRef.value) {
-            const exposed = parentRef.value.getExposed();
+            const exposed = getParentExposed();
             if (exposed && typeof exposed[event] === 'function') {
                 try {
                     exposed[event](data, instanceId, name);
                 } catch (error) {
                     logger.warn(`Error calling parent method ${event}:`, error);
                 }
-            } else {
-                logger.warn(`Parent method ${event} not found or not a function`);
             }
-        } else {
-            logger.warn(`No parent found to emit event: ${event}`);
         }
     };
 
-    // 子组件上下文
     const childContext: ChildContext = {
         id: instanceId,
-        name,
+        name: name || 'anonymous',
         emitToParent,
         getParentExposed,
-        getInstance() {
-            return instance;
-        },
+        getInstance: () => instance,
         getExposed
     };
 
-    logger.log(`Child ${name} registered, looking for parent`);
+    logger.log(`Child ${name || 'anonymous'} registered, looking for parent`);
 
     onMounted(() => {
-        // 立即尝试连接父组件
         let connected = linkParent();
         nextTick(() => {
-            // 如果未连接成功，500ms后重试一次
+            connected = linkParent();
             if (!connected) {
-                setTimeout(() => {
-                    linkParent();
-                }, 500);
+                setTimeout(linkParent, 500);
             }
         });
     });
 
-    // 组件卸载时清理
     onUnmounted(() => {
-        if (parentRef.value) {
+        if (parentRef.value?.removeChild) {
             parentRef.value.removeChild(instanceId);
         }
-        logger.log(`Child ${name} unmounted`);
+        logger.log(`Child ${name || 'anonymous'} unmounted`);
     });
 
     return {
         childId: instanceId,
-        childName: name,
+        childName: name || 'anonymous',
         parent: parentRef,
         emitToParent,
         getParentExposed,
@@ -319,13 +370,9 @@ export function hasParent(parentName?: string): boolean {
         return getParentContext(parentName, instance) !== null;
     }
 
-    // 查找最近的父组件上下文
     let current = instance.parent;
     while (current) {
-        const context = current.proxy?.[PARENT_CONTEXT_SYMBOL];
-        if (context) {
-            return true;
-        }
+        if (current.proxy?.[PARENT_CONTEXT_SYMBOL]) return true;
         current = current.parent;
     }
     return false;
@@ -336,8 +383,7 @@ export function hasParent(parentName?: string): boolean {
  */
 export function getParentContextByName(parentName: string): ParentContext | null {
     const instance = getCurrentInstance();
-    if (!instance) return null;
-    return getParentContext(parentName, instance);
+    return instance ? getParentContext(parentName, instance) : null;
 }
 
 /**
@@ -345,7 +391,6 @@ export function getParentContextByName(parentName: string): ParentContext | null
  */
 export function cleanupComponentRelations(): void {
     logger.log('Cleaning up component relations for hot reload');
-    // 由于使用组件实例存储，热更新时会自动重新建立关系
 }
 
 // 热更新处理

package/libs/index.ts

@@ -46,6 +46,8 @@ import throttle from './function/throttle';
 import getRect from './function/getRect';
 // 获取父组件
 import { parentData, parent } from './function/parent';
+// 剪贴板
+import { clipboard } from './function/clipboard';
 // 配置信息
 import config from './config/config';
 // 各个需要fixed的地方的z-index配置文件
@@ -268,6 +270,7 @@ export {
     $parent,
     parent,
     parentData,
+    clipboard,
     dispatch,
     broadcast,
     config,
@@ -301,6 +304,7 @@ export const $u = {
     $parent,
     parent,
     parentData,
+    clipboard,
     addUnit,
     trim,
     type: ['primary', 'success', 'error', 'warning', 'info'],

package/package.json

@@ -2,7 +2,7 @@
     "id": "uview-pro",
     "name": "uview-pro",
     "displayName": "【Vue3重构版】uView Pro｜基于Vue3+TS全面重构的70+精选UI组件库",
-    "version": "0.3.1",
+    "version": "0.3.3",
     "description": "uView Pro，是全面支持Vue3的uni-app生态框架，70+精选组件已使用TypeScript重构，已全面支持uni-app Vue3.0",
     "main": "index.ts",
     "module": "index.ts",

package/readme.md

@@ -73,7 +73,7 @@ pnpm dev
 
 <table class="table">
     <tr>
-        <td><img src="https://ik.imagekit.io/anyup/images/social/weixin-chat.png?updatedAt=1760233880982" width="250" height="345" ></td>
+        <td><img src="https://ik.imagekit.io/anyup/images/social/weixin-chat-cl.png" width="250" height="345" ></td>
         <td><img src="https://ik.imagekit.io/anyup/images/social/qq-chat.png" width="250" height="345" ></td>
     </tr>
     <tr>

package/types/components.d.ts

@@ -91,7 +91,9 @@ declare module 'vue' {
         uWaterfall: (typeof import('../components/u-waterfall/u-waterfall.vue'))['default'];
         uText: (typeof import('../components/u-text/u-text.vue'))['default'];
         uRootPortal: (typeof import('../components/u-root-portal/u-root-portal.vue'))['default'];
+        uStatusBar: (typeof import('../components/u-status-bar/u-status-bar.vue'))['default'];
+        uSafeBottom: (typeof import('../components/u-safe-bottom/u-safe-bottom.vue'))['default'];
     }
 }
 
-export {};
+export { };