sard-uniapp 1.24.6 → 1.25.0

package/CHANGELOG.md

@@ -1,3 +1,37 @@
+# [1.25.0](https://github.com/sutras/sard-uniapp/compare/v1.24.7...v1.25.0) (2025-11-03)
+
+
+### Bug Fixes
+
+* **loading:** 修复根类名和样式设置错乱问题 ([f4ef355](https://github.com/sutras/sard-uniapp/commit/f4ef355e31d68e200868811a656f989ce6c7bd64))
+* **util:** 修复数组浅比较问题 ([7f04c96](https://github.com/sutras/sard-uniapp/commit/7f04c961210dfddfb475f41299dca6391e418060))
+
+
+### Features
+
+* **upload:** 允许通过调用方法调起文件选择 ([a78a645](https://github.com/sutras/sard-uniapp/commit/a78a6456f44c3fa6a7d1bba46b8354b07e458d1f))
+* 新增image组件 ([7c61f4d](https://github.com/sutras/sard-uniapp/commit/7c61f4da58ad4f3307da6472e9c9df85e0f82f59))
+
+
+
+## [1.24.7](https://github.com/sutras/sard-uniapp/compare/v1.24.6...v1.24.7) (2025-10-02)
+
+
+### Bug Fixes
+
+* **form:** 修复FormItemPlain错误定位问题 ([3b35b05](https://github.com/sutras/sard-uniapp/commit/3b35b05b6df5c5b3de447ffec9f7ff37b7be8ab3))
+* **scroll-spy:** 修复因重复设置current导致不滚动的问题 ([cb6ba8c](https://github.com/sutras/sard-uniapp/commit/cb6ba8c0563657ae0e826e7a3816430c9ff711d7))
+
+
+### Features
+
+* **config:** 允许全局配置组件的任意属性 ([889ad5b](https://github.com/sutras/sard-uniapp/commit/889ad5b1df4f9ddcfdeaffc6d2492d95f16550d3))
+* **scroll-spy:** 新增 disabled 属性 ([0d20897](https://github.com/sutras/sard-uniapp/commit/0d20897bdf2c97f2f6423a58ab90327ba606fae7))
+* **tabs:** 新增line插槽 ([1d05dd0](https://github.com/sutras/sard-uniapp/commit/1d05dd05893b3264a805e42abe6792212a4ba95a))
+* **tree:** 添加懒加载功能 ([f4c7d38](https://github.com/sutras/sard-uniapp/commit/f4c7d38aa952d67b0056922c22f47c04519f5a25))
+
+
+
 ## [1.24.6](https://github.com/sutras/sard-uniapp/compare/v1.24.5...v1.24.6) (2025-09-23)
 
 

package/README.md

@@ -25,7 +25,7 @@
 
 ## 特性
 
-- 🧩 101+个高质量组件，覆盖移动端主流场景
+- 🧩 102+个高质量组件，覆盖移动端主流场景
 - 💪 支持一套代码同时开发 H5 / 小程序 / App
 - 🌿 支持按需引入和 `Tree Shaking`
 - 📖 详尽的文档和案例展示

package/components/action-sheet/action-sheet.d.ts

@@ -1,4 +1,4 @@
-import { type ActionSheetProps } from './common';
+import { type ActionSheetItem, type ActionSheetProps } from './common';
 declare const _default: import("vue").DefineComponent<ActionSheetProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
     [x: string]: any;
 } & {
@@ -6,7 +6,14 @@ declare const _default: import("vue").DefineComponent<ActionSheetProps, {}, {},
 }, string, import("vue").PublicProps, Readonly<ActionSheetProps> & Readonly<{
     [x: `on${Capitalize<any>}`]: ((...args: any) => any) | undefined;
 }>, {
+    cancel: string;
+    rootStyle: string | false | import("vue").CSSProperties | import("vue").StyleValue[] | null;
+    rootClass: string;
+    description: string;
+    visible: boolean;
     duration: number;
     overlayClosable: boolean;
+    itemList: ActionSheetItem[];
+    beforeClose: (type: "close" | "cancel" | "select") => boolean | Promise<any>;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 export default _default;

package/components/action-sheet/common.d.ts

@@ -12,8 +12,105 @@ export interface ActionSheetProps {
     duration?: number;
 }
 export declare const defaultActionSheetProps: {
-    overlayClosable: boolean;
-    duration: number;
+    rootStyle?: (string | false | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        description: string;
+        itemList: ActionSheetItem[];
+        cancel: string;
+        visible: boolean;
+        overlayClosable: boolean;
+        beforeClose: (type: "close" | "cancel" | "select") => boolean | Promise<any>;
+        duration: number;
+    }) => string | false | import("vue").CSSProperties | StyleValue[]) | null) | undefined;
+    rootClass?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        description: string;
+        itemList: ActionSheetItem[];
+        cancel: string;
+        visible: boolean;
+        overlayClosable: boolean;
+        beforeClose: (type: "close" | "cancel" | "select") => boolean | Promise<any>;
+        duration: number;
+    }) => string)) | undefined;
+    description?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        description: string;
+        itemList: ActionSheetItem[];
+        cancel: string;
+        visible: boolean;
+        overlayClosable: boolean;
+        beforeClose: (type: "close" | "cancel" | "select") => boolean | Promise<any>;
+        duration: number;
+    }) => string)) | undefined;
+    itemList?: ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        description: string;
+        itemList: ActionSheetItem[];
+        cancel: string;
+        visible: boolean;
+        overlayClosable: boolean;
+        beforeClose: (type: "close" | "cancel" | "select") => boolean | Promise<any>;
+        duration: number;
+    }) => ActionSheetItem[]) | undefined;
+    cancel?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        description: string;
+        itemList: ActionSheetItem[];
+        cancel: string;
+        visible: boolean;
+        overlayClosable: boolean;
+        beforeClose: (type: "close" | "cancel" | "select") => boolean | Promise<any>;
+        duration: number;
+    }) => string)) | undefined;
+    visible?: (boolean | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        description: string;
+        itemList: ActionSheetItem[];
+        cancel: string;
+        visible: boolean;
+        overlayClosable: boolean;
+        beforeClose: (type: "close" | "cancel" | "select") => boolean | Promise<any>;
+        duration: number;
+    }) => boolean)) | undefined;
+    overlayClosable?: (boolean | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        description: string;
+        itemList: ActionSheetItem[];
+        cancel: string;
+        visible: boolean;
+        overlayClosable: boolean;
+        beforeClose: (type: "close" | "cancel" | "select") => boolean | Promise<any>;
+        duration: number;
+    }) => boolean)) | undefined;
+    beforeClose?: (((type: "close" | "cancel" | "select") => boolean | Promise<any>) | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        description: string;
+        itemList: ActionSheetItem[];
+        cancel: string;
+        visible: boolean;
+        overlayClosable: boolean;
+        beforeClose: (type: "close" | "cancel" | "select") => boolean | Promise<any>;
+        duration: number;
+    }) => (type: "close" | "cancel" | "select") => boolean | Promise<any>)) | undefined;
+    duration?: (number | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        description: string;
+        itemList: ActionSheetItem[];
+        cancel: string;
+        visible: boolean;
+        overlayClosable: boolean;
+        beforeClose: (type: "close" | "cancel" | "select") => boolean | Promise<any>;
+        duration: number;
+    }) => number)) | undefined;
 };
 export interface ActionSheetEmits extends TransitionHookEmits {
     (e: 'update:visible', visible: boolean): void;

package/components/alert/alert.d.ts

@@ -5,7 +5,13 @@ declare const __VLS_component: import("vue").DefineComponent<AlertProps, {}, {},
 }, string, import("vue").PublicProps, Readonly<AlertProps> & Readonly<{
     onClose?: (() => any) | undefined;
 }>, {
+    rootStyle: string | false | import("vue").CSSProperties | import("vue").StyleValue[] | null;
+    rootClass: string;
     type: "primary" | "success" | "warning" | "danger";
+    background: string;
+    showIcon: boolean;
+    closable: boolean;
+    color: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
 export default _default;

package/components/alert/common.d.ts

@@ -9,7 +9,69 @@ export interface AlertProps {
     background?: string;
 }
 export declare const defaultAlertProps: {
-    type: AlertProps["type"];
+    rootStyle?: (string | false | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        showIcon: boolean;
+        closable: boolean;
+        type: "primary" | "success" | "warning" | "danger";
+        color: string;
+        background: string;
+    }) => string | false | import("vue").CSSProperties | StyleValue[]) | null) | undefined;
+    rootClass?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        showIcon: boolean;
+        closable: boolean;
+        type: "primary" | "success" | "warning" | "danger";
+        color: string;
+        background: string;
+    }) => string)) | undefined;
+    showIcon?: (boolean | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        showIcon: boolean;
+        closable: boolean;
+        type: "primary" | "success" | "warning" | "danger";
+        color: string;
+        background: string;
+    }) => boolean)) | undefined;
+    closable?: (boolean | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        showIcon: boolean;
+        closable: boolean;
+        type: "primary" | "success" | "warning" | "danger";
+        color: string;
+        background: string;
+    }) => boolean)) | undefined;
+    type?: ("success" | "primary" | "warning" | "danger" | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        showIcon: boolean;
+        closable: boolean;
+        type: "primary" | "success" | "warning" | "danger";
+        color: string;
+        background: string;
+    }) => "success" | "primary" | "warning" | "danger")) | undefined;
+    color?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        showIcon: boolean;
+        closable: boolean;
+        type: "primary" | "success" | "warning" | "danger";
+        color: string;
+        background: string;
+    }) => string)) | undefined;
+    background?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        showIcon: boolean;
+        closable: boolean;
+        type: "primary" | "success" | "warning" | "danger";
+        color: string;
+        background: string;
+    }) => string)) | undefined;
 };
 export interface AlertSlots {
     default?(props: Record<string, never>): any;

package/components/avatar/avatar.d.ts

@@ -5,7 +5,15 @@ declare const __VLS_component: import("vue").DefineComponent<AvatarProps, {}, {}
 }, string, import("vue").PublicProps, Readonly<AvatarProps> & Readonly<{
     onClick?: ((event: any) => any) | undefined;
 }>, {
+    size: string;
+    rootStyle: string | false | import("vue").CSSProperties | import("vue").StyleValue[] | null;
+    rootClass: string;
+    background: string;
+    color: string;
     shape: "circle" | "square";
+    iconSize: string;
+    src: string;
+    index: number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
 export default _default;

package/components/avatar/common.d.ts

@@ -11,7 +11,105 @@ export interface AvatarProps {
     index?: number;
 }
 export declare const defaultAvatarProps: {
-    shape: AvatarProps["shape"];
+    rootStyle?: (string | false | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        shape: "circle" | "square";
+        size: string;
+        iconSize: string;
+        background: string;
+        color: string;
+        src: string;
+        index: number;
+    }) => string | false | import("vue").CSSProperties | StyleValue[]) | null) | undefined;
+    rootClass?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        shape: "circle" | "square";
+        size: string;
+        iconSize: string;
+        background: string;
+        color: string;
+        src: string;
+        index: number;
+    }) => string)) | undefined;
+    shape?: ("circle" | "square" | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        shape: "circle" | "square";
+        size: string;
+        iconSize: string;
+        background: string;
+        color: string;
+        src: string;
+        index: number;
+    }) => "circle" | "square")) | undefined;
+    size?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        shape: "circle" | "square";
+        size: string;
+        iconSize: string;
+        background: string;
+        color: string;
+        src: string;
+        index: number;
+    }) => string)) | undefined;
+    iconSize?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        shape: "circle" | "square";
+        size: string;
+        iconSize: string;
+        background: string;
+        color: string;
+        src: string;
+        index: number;
+    }) => string)) | undefined;
+    background?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        shape: "circle" | "square";
+        size: string;
+        iconSize: string;
+        background: string;
+        color: string;
+        src: string;
+        index: number;
+    }) => string)) | undefined;
+    color?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        shape: "circle" | "square";
+        size: string;
+        iconSize: string;
+        background: string;
+        color: string;
+        src: string;
+        index: number;
+    }) => string)) | undefined;
+    src?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        shape: "circle" | "square";
+        size: string;
+        iconSize: string;
+        background: string;
+        color: string;
+        src: string;
+        index: number;
+    }) => string)) | undefined;
+    index?: (number | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        shape: "circle" | "square";
+        size: string;
+        iconSize: string;
+        background: string;
+        color: string;
+        src: string;
+        index: number;
+    }) => number)) | undefined;
 };
 export interface AvatarSlots {
     default?(props: Record<string, never>): any;

package/components/avatar-group/avatar-group.d.ts

@@ -5,8 +5,13 @@ declare const __VLS_component: import("vue").DefineComponent<AvatarGroupProps, {
 }, string, import("vue").PublicProps, Readonly<AvatarGroupProps> & Readonly<{
     "onRemain-click"?: ((event: any) => any) | undefined;
 }>, {
-    showRemain: boolean;
+    max: number;
+    rootStyle: string | false | import("vue").CSSProperties | import("vue").StyleValue[] | null;
+    rootClass: string;
+    total: number;
     coverage: number;
+    showRemain: boolean;
+    remainText: string | number;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
 export default _default;

package/components/avatar-group/common.d.ts

@@ -9,8 +9,69 @@ export interface AvatarGroupProps {
     remainText?: string | number;
 }
 export declare const defaultAvatarGroupProps: {
-    coverage: number;
-    showRemain: boolean;
+    rootStyle?: (string | false | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        max: number;
+        total: number;
+        coverage: number;
+        showRemain: boolean;
+        remainText: string | number;
+    }) => string | false | import("vue").CSSProperties | StyleValue[]) | null) | undefined;
+    rootClass?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        max: number;
+        total: number;
+        coverage: number;
+        showRemain: boolean;
+        remainText: string | number;
+    }) => string)) | undefined;
+    max?: (number | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        max: number;
+        total: number;
+        coverage: number;
+        showRemain: boolean;
+        remainText: string | number;
+    }) => number)) | undefined;
+    total?: (number | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        max: number;
+        total: number;
+        coverage: number;
+        showRemain: boolean;
+        remainText: string | number;
+    }) => number)) | undefined;
+    coverage?: (number | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        max: number;
+        total: number;
+        coverage: number;
+        showRemain: boolean;
+        remainText: string | number;
+    }) => number)) | undefined;
+    showRemain?: (boolean | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        max: number;
+        total: number;
+        coverage: number;
+        showRemain: boolean;
+        remainText: string | number;
+    }) => boolean)) | undefined;
+    remainText?: (string | number | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        max: number;
+        total: number;
+        coverage: number;
+        showRemain: boolean;
+        remainText: string | number;
+    }) => string | number)) | undefined;
 };
 export interface AvatarGroupSlots {
     default?(props: Record<string, never>): any;

package/components/back-top/back-top.d.ts

@@ -5,8 +5,12 @@ declare const __VLS_component: import("vue").DefineComponent<BackTopProps, {}, {
 }, string, import("vue").PublicProps, Readonly<BackTopProps> & Readonly<{
     onClick?: ((event: any) => any) | undefined;
 }>, {
+    rootStyle: string | false | import("vue").CSSProperties | import("vue").StyleValue[] | null;
+    rootClass: string;
+    right: string;
     scrollTop: number;
     visibleHeight: number;
+    bottom: string;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
 export default _default;

package/components/back-top/common.d.ts

@@ -9,7 +9,46 @@ export interface BackTopProps {
 }
 export declare const defaultBackTopProps: () => {
     scrollTop: number;
-    visibleHeight: number;
+    rootStyle?: (string | false | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        scrollTop: number;
+        visibleHeight: number;
+        right: string;
+        bottom: string;
+    }) => string | false | import("vue").CSSProperties | StyleValue[]) | null) | undefined;
+    rootClass?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        scrollTop: number;
+        visibleHeight: number;
+        right: string;
+        bottom: string;
+    }) => string)) | undefined;
+    visibleHeight?: (number | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        scrollTop: number;
+        visibleHeight: number;
+        right: string;
+        bottom: string;
+    }) => number)) | undefined;
+    right?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        scrollTop: number;
+        visibleHeight: number;
+        right: string;
+        bottom: string;
+    }) => string)) | undefined;
+    bottom?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        scrollTop: number;
+        visibleHeight: number;
+        right: string;
+        bottom: string;
+    }) => string)) | undefined;
 };
 export interface BackTopSlots {
     default?(props: Record<string, never>): any;

package/components/badge/badge.d.ts

@@ -3,6 +3,13 @@ declare function __VLS_template(): Readonly<BadgeSlots> & BadgeSlots;
 declare const __VLS_component: import("vue").DefineComponent<BadgeProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<BadgeProps> & Readonly<{}>, {
     max: number;
     value: number | string;
+    fixed: boolean;
+    rootStyle: string | false | import("vue").CSSProperties | import("vue").StyleValue[] | null;
+    rootClass: string;
+    color: string;
+    showZero: boolean;
+    textColor: string;
+    dot: boolean;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
 declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
 export default _default;

package/components/badge/common.d.ts

@@ -11,8 +11,105 @@ export interface BadgeProps {
     fixed?: boolean;
 }
 export declare const defaultBadgeProps: {
-    value: number;
-    max: number;
+    rootStyle?: (string | false | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        value: number | string;
+        max: number;
+        showZero: boolean;
+        color: string;
+        textColor: string;
+        dot: boolean;
+        fixed: boolean;
+    }) => string | false | import("vue").CSSProperties | StyleValue[]) | null) | undefined;
+    rootClass?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        value: number | string;
+        max: number;
+        showZero: boolean;
+        color: string;
+        textColor: string;
+        dot: boolean;
+        fixed: boolean;
+    }) => string)) | undefined;
+    value?: (string | number | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        value: number | string;
+        max: number;
+        showZero: boolean;
+        color: string;
+        textColor: string;
+        dot: boolean;
+        fixed: boolean;
+    }) => string | number)) | undefined;
+    max?: (number | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        value: number | string;
+        max: number;
+        showZero: boolean;
+        color: string;
+        textColor: string;
+        dot: boolean;
+        fixed: boolean;
+    }) => number)) | undefined;
+    showZero?: (boolean | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        value: number | string;
+        max: number;
+        showZero: boolean;
+        color: string;
+        textColor: string;
+        dot: boolean;
+        fixed: boolean;
+    }) => boolean)) | undefined;
+    color?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        value: number | string;
+        max: number;
+        showZero: boolean;
+        color: string;
+        textColor: string;
+        dot: boolean;
+        fixed: boolean;
+    }) => string)) | undefined;
+    textColor?: (string | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        value: number | string;
+        max: number;
+        showZero: boolean;
+        color: string;
+        textColor: string;
+        dot: boolean;
+        fixed: boolean;
+    }) => string)) | undefined;
+    dot?: (boolean | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        value: number | string;
+        max: number;
+        showZero: boolean;
+        color: string;
+        textColor: string;
+        dot: boolean;
+        fixed: boolean;
+    }) => boolean)) | undefined;
+    fixed?: (boolean | ((props: {
+        rootStyle: StyleValue;
+        rootClass: string;
+        value: number | string;
+        max: number;
+        showZero: boolean;
+        color: string;
+        textColor: string;
+        dot: boolean;
+        fixed: boolean;
+    }) => boolean)) | undefined;
 };
 export interface BadgeSlots {
     default?(props: Record<string, never>): any;