sard-uniapp 1.19.5 → 1.20.0

package/components/upload-preview/index.scss

@@ -111,6 +111,7 @@
     padding: 0 var(--sar-upload-status-message-padding-x);
     margin-top: var(--sar-upload-status-message-margin-top);
     font-size: var(--sar-upload-status-message-font-size);
+    text-align: center;
   }
 
   @include e(remove) {

package/components/upload-preview/upload-preview.d.ts

@@ -1,10 +1,12 @@
 import { type UploadPreviewProps } from '../upload/common';
 declare const _default: import("vue").DefineComponent<UploadPreviewProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    remove: (index: number) => any;
-    "image-click": (index: number) => any;
+    click: () => any;
+    remove: () => any;
+    "image-click": () => any;
 }, string, import("vue").PublicProps, Readonly<UploadPreviewProps> & Readonly<{
-    onRemove?: ((index: number) => any) | undefined;
-    "onImage-click"?: ((index: number) => any) | undefined;
+    onClick?: (() => any) | undefined;
+    onRemove?: (() => any) | undefined;
+    "onImage-click"?: (() => any) | undefined;
 }>, {
     status: import("../upload/common").UploadStatus;
 }, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/components/upload-preview/upload-preview.vue

@@ -1,5 +1,9 @@
 <template>
-  <view :class="uploadPreviewClass" :style="uploadPreviewStyle">
+  <view
+    :class="uploadPreviewClass"
+    :style="uploadPreviewStyle"
+    @click="onClick"
+  >
     <image
       v-if="isImage"
       :class="bem.e('image')"
@@ -47,7 +51,7 @@
     <view
       v-if="removable && !disabled && !readonly && status !== 'uploading'"
       :class="bem.e('remove')"
-      @click="onRemove"
+      @click.stop="onRemove"
     >
       <view :class="bem.e('close')">
         <sar-icon family="sari" name="close" />
@@ -95,12 +99,11 @@ export default  _defineComponent({
     name: { type: String, required: false },
     message: { type: String, required: false },
     removable: { type: Boolean, required: false },
-    beforeRemove: { type: Function, required: false },
     index: { type: Number, required: true },
     disabled: { type: Boolean, required: false },
     readonly: { type: Boolean, required: false }
   }, defaultUploadPreviewProps),
-  emits: ["image-click", "remove"],
+  emits: ["image-click", "remove", "click"],
   setup(__props, { expose: __expose, emit: __emit }) {
     __expose();
     const props = __props;
@@ -116,7 +119,7 @@ export default  _defineComponent({
       return props.url || props.file?.path || "";
     });
     const onImageClick = () => {
-      emit("image-click", props.index);
+      emit("image-click");
     };
     const videoId = uniqid();
     const instance = getCurrentInstance();
@@ -131,30 +134,20 @@ export default  _defineComponent({
         controlsVisible.value = false;
       }
     };
-    const onPlayClick = () => {
+    const previewVideo = () => {
       videoContext.requestFullScreen({
         direction: 0
       });
     };
+    const onPlayClick = () => {
+      previewVideo();
+    };
     const onRemove = () => {
       if (!props.removable || props.disabled || props.readonly) return;
-      function remove() {
-        emit("remove", props.index);
-      }
-      if (props.beforeRemove) {
-        const ret = props.beforeRemove(props.index);
-        if (!ret) {
-          return;
-        }
-        if (ret instanceof Promise) {
-          ret.then(() => {
-            remove();
-          }).catch(() => {
-          });
-          return;
-        }
-      }
-      remove();
+      emit("remove");
+    };
+    const onClick = () => {
+      emit("click");
     };
     const uploadPreviewClass = computed(() => {
       return classNames(
@@ -166,7 +159,7 @@ export default  _defineComponent({
     const uploadPreviewStyle = computed(() => {
       return stringifyStyle(props.rootStyle);
     });
-    const __returned__ = { props, emit, bem, isImage, isVideo, mediaUrl, onImageClick, videoId, instance, controlsVisible, videoContext, onFullscreenchange, onPlayClick, onRemove, uploadPreviewClass, uploadPreviewStyle, SarIcon, SarLoading };
+    const __returned__ = { props, emit, bem, isImage, isVideo, mediaUrl, onImageClick, videoId, instance, controlsVisible, videoContext, onFullscreenchange, previewVideo, onPlayClick, onRemove, onClick, uploadPreviewClass, uploadPreviewStyle, SarIcon, SarLoading };
     return __returned__;
   }
 });

package/global.d.ts

@@ -82,8 +82,11 @@ declare module 'vue' {
     SarRadioInput: typeof import('./components/radio-input/radio-input').default
     SarRadioPopout: typeof import('./components/radio-popout/radio-popout').default
     SarRate: typeof import('./components/rate/rate').default
+    SarReadMore: typeof import('./components/read-more/read-more').default
+    SarResizeSensor: typeof import('./components/resize-sensor/resize-sensor').default
     SarResult: typeof import('./components/result/result').default
     SarRow: typeof import('./components/row/row').default
+    SarScrollList: typeof import('./components/scroll-list/scroll-list').default
     SarScrollSpy: typeof import('./components/scroll-spy/scroll-spy').default
     SarScrollSpyAnchor: typeof import('./components/scroll-spy-anchor/scroll-spy-anchor').default
     SarSearch: typeof import('./components/search/search').default
@@ -102,6 +105,8 @@ declare module 'vue' {
     SarStep: typeof import('./components/step/step').default
     SarStepper: typeof import('./components/stepper/stepper').default
     SarSteps: typeof import('./components/steps/steps').default
+    SarSticky: typeof import('./components/sticky/sticky').default
+    SarStickyBox: typeof import('./components/sticky-box/sticky-box').default
     SarSwipeAction: typeof import('./components/swipe-action/swipe-action').default
     SarSwiperDot: typeof import('./components/swiper-dot/swiper-dot').default
     SarSwitch: typeof import('./components/switch/switch').default

package/index.d.ts

@@ -73,7 +73,10 @@ export * from './components/radio';
 export * from './components/radio-input';
 export * from './components/radio-popout';
 export * from './components/rate';
+export * from './components/read-more';
+export * from './components/resize-sensor';
 export * from './components/result';
+export * from './components/scroll-list';
 export * from './components/scroll-spy';
 export * from './components/scroll-spy-anchor';
 export * from './components/search';
@@ -88,6 +91,8 @@ export * from './components/status-bar';
 export * from './components/step';
 export * from './components/stepper';
 export * from './components/steps';
+export * from './components/sticky';
+export * from './components/sticky-box';
 export * from './components/swipe-action';
 export * from './components/swiper-dot';
 export * from './components/switch';

package/index.js

@@ -73,7 +73,10 @@ export * from './components/radio';
 export * from './components/radio-input';
 export * from './components/radio-popout';
 export * from './components/rate';
+export * from './components/read-more';
+export * from './components/resize-sensor';
 export * from './components/result';
+export * from './components/scroll-list';
 export * from './components/scroll-spy';
 export * from './components/scroll-spy-anchor';
 export * from './components/search';
@@ -88,6 +91,8 @@ export * from './components/status-bar';
 export * from './components/step';
 export * from './components/stepper';
 export * from './components/steps';
+export * from './components/sticky';
+export * from './components/sticky-box';
 export * from './components/swipe-action';
 export * from './components/swiper-dot';
 export * from './components/switch';

package/index.scss

@@ -50,8 +50,10 @@
 @use './components/radio-popout/variables.scss' as *;
 @use './components/radio/variables.scss' as *;
 @use './components/rate/variables.scss' as *;
+@use './components/read-more/variables.scss' as *;
 @use './components/result/variables.scss' as *;
 @use './components/row/variables.scss' as *;
+@use './components/scroll-list/variables.scss' as *;
 @use './components/search/variables.scss' as *;
 @use './components/share-sheet/variables.scss' as *;
 @use './components/sidebar/variables.scss' as *;

package/package.json

@@ -2,7 +2,7 @@
   "id": "sard-uniapp",
   "name": "sard-uniapp",
   "displayName": "sard-uniapp",
-  "version": "1.19.5",
+  "version": "1.20.0",
   "description": "sard-uniapp 是一套基于 Uniapp + Vue3 框架开发的兼容多端的 UI 组件库",
   "main": "index.js",
   "scripts": {
@@ -108,6 +108,7 @@
     "@vitejs/plugin-vue-jsx": "^3.1.0",
     "@vue/runtime-core": "^3.4.21",
     "@vue/test-utils": "^2.4.6",
+    "chokidar": "^4.0.3",
     "consola": "^3.2.3",
     "eslint": "^9.16.0",
     "eslint-config-prettier": "^8.10.0",
@@ -122,8 +123,9 @@
     "lodash-es": "^4.17.21",
     "prettier": "^3.5.3",
     "region-data": "^1.2.3",
-    "sard-cli": "^1.3.1",
+    "sard-cli": "^1.3.3",
     "sass": "^1.69.7",
+    "tailwindcss": "^3.4.17",
     "tel-area-code": "^1.1.0",
     "ts-custom-error": "^3.3.1",
     "tsx": "^4.19.2",

package/use/index.d.ts

@@ -18,3 +18,7 @@ export * from './usePopoutInput';
 export * from './useFormPopout';
 export * from './useInitialVelocity';
 export * from './useStopMovedClick';
+export * from './useIndeterminate';
+export * from './useWindowResize';
+export * from './useSingleTask';
+export * from './useIntersectionObserver';

package/use/index.js

@@ -18,3 +18,7 @@ export * from './usePopoutInput';
 export * from './useFormPopout';
 export * from './useInitialVelocity';
 export * from './useStopMovedClick';
+export * from './useIndeterminate';
+export * from './useWindowResize';
+export * from './useSingleTask';
+export * from './useIntersectionObserver';

package/use/useIndeterminate.d.ts

@@ -0,0 +1,10 @@
+import { MaybeRef, type Ref } from 'vue';
+export declare function useIndeterminate(value: Ref<any[]>, options: MaybeRef<{
+    label: any;
+    value: any;
+    disabled?: boolean;
+}[]>): {
+    allChecked: Ref<boolean, boolean>;
+    isIndeterminate: import("vue").ComputedRef<boolean>;
+    onAllChange: (checked: boolean) => void;
+};

package/use/useIndeterminate.js

@@ -0,0 +1,27 @@
+import { computed, ref, unref, watch } from 'vue';
+export function useIndeterminate(value, options) {
+    const filterOptions = computed(() => {
+        return unref(options).filter((option) => !option.disabled);
+    });
+    const checkedLength = computed(() => value.value?.length || 0);
+    const optionsLength = computed(() => unref(filterOptions)?.length || 0);
+    const allChecked = ref(false);
+    const isIndeterminate = computed(() => {
+        return checkedLength.value > 0 && checkedLength.value < optionsLength.value;
+    });
+    const onAllChange = (checked) => {
+        value.value = checked
+            ? unref(filterOptions).map((option) => option.value)
+            : [];
+    };
+    watch([checkedLength, optionsLength], () => {
+        allChecked.value = checkedLength.value === optionsLength.value;
+    }, {
+        immediate: true,
+    });
+    return {
+        allChecked,
+        isIndeterminate,
+        onAllChange,
+    };
+}

package/use/useIntersectionObserver.d.ts

@@ -0,0 +1,16 @@
+import { type ComponentInternalInstance, MaybeRef } from 'vue';
+interface IntersectionObserverOptions {
+    root?: MaybeRef<string>;
+    selector?: MaybeRef<string>;
+    offsetTop?: MaybeRef<number | undefined>;
+    offsetBottom?: MaybeRef<number | undefined>;
+    thresholds?: number[];
+    initialRatio?: number;
+    observeAll?: boolean;
+    instance?: ComponentInternalInstance;
+}
+export declare function useIntersectionObserver(callback: (result: UniApp.ObserveResult) => void, options?: IntersectionObserverOptions): {
+    recreate: () => void;
+    disconnect: () => void;
+};
+export {};

package/use/useIntersectionObserver.js

@@ -0,0 +1,52 @@
+import { computed, getCurrentInstance, onBeforeUnmount, onMounted, unref, watch, } from 'vue';
+export function useIntersectionObserver(callback, options = {}) {
+    const instance = getCurrentInstance();
+    let observer = null;
+    const selector = computed(() => unref(options.selector));
+    const root = computed(() => unref(options.root));
+    const offsetTop = computed(() => -(unref(options.offsetTop) || 0));
+    const offsetBottom = computed(() => -(unref(options.offsetBottom) || 0));
+    const createObserver = () => {
+        if (!selector.value) {
+            return;
+        }
+        observer = uni.createIntersectionObserver(options.instance?.proxy || instance?.proxy, {
+            thresholds: options.thresholds,
+            initialRatio: options.initialRatio,
+            observeAll: options.observeAll,
+        });
+        if (root.value) {
+            observer?.relativeTo(root.value, {
+                top: offsetTop.value,
+                bottom: offsetBottom.value,
+            });
+        }
+        else {
+            observer?.relativeToViewport({
+                top: offsetTop.value,
+                bottom: offsetBottom.value,
+            });
+        }
+        observer?.observe(selector.value, callback);
+    };
+    watch([selector, root, offsetTop, offsetBottom], () => {
+        recreate();
+    });
+    const disconnect = () => {
+        observer?.disconnect();
+    };
+    const recreate = () => {
+        disconnect();
+        createObserver();
+    };
+    onMounted(() => {
+        createObserver();
+    });
+    onBeforeUnmount(() => {
+        disconnect();
+    });
+    return {
+        recreate,
+        disconnect,
+    };
+}

package/use/useSimulatedClick.js

@@ -1,4 +1,4 @@
-import { getDistanceBetweenTwoPoints } from '../utils';
+import { getTwoPointsDistance } from '../utils';
 import { useTimeout } from './useTimeout';
 export function useSimulatedClick(click, duration = 10000) {
     let timeout = false;
@@ -20,7 +20,7 @@ export function useSimulatedClick(click, duration = 10000) {
                 x: event.changedTouches[0].clientX,
                 y: event.changedTouches[0].clientY,
             };
-            const distance = getDistanceBetweenTwoPoints(downCoord, upCoord);
+            const distance = getTwoPointsDistance(downCoord, upCoord);
             if (distance <= 10) {
                 click();
             }

package/use/useSimulatedPress.js

@@ -1,4 +1,4 @@
-import { getDistanceBetweenTwoPoints } from '../utils';
+import { getTwoPointsDistance } from '../utils';
 import { useTimeout } from './useTimeout';
 export function useSimulatedPress(options = {}) {
     const { start, move, end, duration = 500 } = options;
@@ -29,7 +29,7 @@ export function useSimulatedPress(options = {}) {
             });
         }
         else if (isWaitingToTriggerPress.value) {
-            const distance = getDistanceBetweenTwoPoints(downCoord, moveCoord);
+            const distance = getTwoPointsDistance(downCoord, moveCoord);
             if (distance > 10) {
                 cancelTriggerPress();
             }

package/use/useSingleTask.d.ts

@@ -0,0 +1,6 @@
+export declare function useSingleTask(): {
+    isWorking: Readonly<import("vue").Ref<boolean, boolean>>;
+    startTask: (task: () => any) => Promise<void>;
+    onFinishTask: (handler: () => any) => void;
+    offFinishTask: (handler: () => any) => void;
+};

package/use/useSingleTask.js

@@ -0,0 +1,40 @@
+import { readonly, ref } from 'vue';
+export function useSingleTask() {
+    const isWorking = ref(false);
+    let listeners = [];
+    async function startTask(task) {
+        if (!isWorking.value) {
+            isWorking.value = true;
+            await task();
+            isWorking.value = false;
+            listeners.forEach((handler) => {
+                handler();
+            });
+            listeners = [];
+        }
+    }
+    function onFinishTask(handler) {
+        if (isWorking.value) {
+            if (!listeners.includes(handler)) {
+                listeners.push(handler);
+            }
+        }
+        else {
+            handler();
+        }
+    }
+    function offFinishTask(handler) {
+        if (isWorking.value) {
+            const index = listeners.indexOf(handler);
+            if (index !== -1) {
+                listeners.splice(index, 1);
+            }
+        }
+    }
+    return {
+        isWorking: readonly(isWorking),
+        startTask,
+        onFinishTask,
+        offFinishTask,
+    };
+}

package/use/useWindowResize.d.ts

@@ -0,0 +1,4 @@
+export declare function useWindowResize(callback: (size: {
+    windowWidth: number;
+    windowHeight: number;
+}) => void): void;

package/use/useWindowResize.js

@@ -0,0 +1,15 @@
+import { onBeforeUnmount, onMounted } from 'vue';
+export function useWindowResize(callback) {
+    const cb = (res) => {
+        callback({
+            windowWidth: res.size.windowWidth,
+            windowHeight: res.size.windowHeight,
+        });
+    };
+    onMounted(() => {
+        uni.onWindowResize?.(cb);
+    });
+    onBeforeUnmount(() => {
+        uni.offWindowResize?.(cb);
+    });
+}

package/utils/array.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @description: 确保目标是一个数组
+ * @param {any} target
+ * @return {array}
+ */
+export declare function toArray(target: any): any[];
+/**
+ * @description: 扩散性遍历
+ * @param {any[]} array 要遍历的数组
+ * @param {(el: any, spreadIndex: number, index: number) => any} callback 回调函数，接收当前元素、扩散性下标、迭代下标作为参数，
+ *  如果返回true，则中止遍历
+ * @param {number} currIndex 遍历开始的下标
+ * @param {number} direction 开始遍历的方向
+ * @return {number} 扩散性下标、或开始下标
+ */
+export declare function spreadEach(array: any[], callback: (el: any, spreadIndex: number, index: number) => any, startIndex?: number, direction?: number): number;
+/**
+ * 判断两数组是否相等，浅比较，元素个数和位置都要相等才为真。
+ */
+export declare function arrayEqual(arr1: any[], arr2: any[]): boolean;
+/**
+ * 打乱并返回数组，会修改原数组。
+ */
+export declare function shuffle<T>(array: T[]): T[];
+/**
+ * 移动数组中的元素，会返回移动后的新数组。
+ */
+export declare function arrayMove<T>(array: T[], fromIndex: number, toIndex: number): T[];

package/utils/array.js

@@ -0,0 +1,90 @@
+/**
+ * @description: 确保目标是一个数组
+ * @param {any} target
+ * @return {array}
+ */
+export function toArray(target) {
+    return Array.isArray(target) ? target : [target];
+}
+/**
+ * @description: 扩散性遍历
+ * @param {any[]} array 要遍历的数组
+ * @param {(el: any, spreadIndex: number, index: number) => any} callback 回调函数，接收当前元素、扩散性下标、迭代下标作为参数，
+ *  如果返回true，则中止遍历
+ * @param {number} currIndex 遍历开始的下标
+ * @param {number} direction 开始遍历的方向
+ * @return {number} 扩散性下标、或开始下标
+ */
+export function spreadEach(array, callback, startIndex = 0, direction = -1) {
+    const len = array.length;
+    let spreadIndex = startIndex;
+    let edge = 0;
+    direction = -direction;
+    for (let i = 0; i < len; i++) {
+        if (edge < 0) {
+            spreadIndex = len - 1 - i;
+        }
+        else if (edge > 0) {
+            spreadIndex = i;
+        }
+        else {
+            spreadIndex = spreadIndex + direction * i;
+            edge = spreadIndex === 0 ? 1 : spreadIndex === len - 1 ? -1 : 0;
+            direction = -direction;
+        }
+        if (typeof callback === 'function') {
+            if (callback(array[spreadIndex], spreadIndex, i)) {
+                return spreadIndex;
+            }
+        }
+    }
+    return startIndex;
+}
+/**
+ * 判断两数组是否相等，浅比较，元素个数和位置都要相等才为真。
+ */
+export function arrayEqual(arr1, arr2) {
+    return arr1.length === arr1.length && arr1.every((el, i) => el === arr2[i]);
+}
+/**
+ * 打乱并返回数组，会修改原数组。
+ */
+export function shuffle(array) {
+    const len = array.length;
+    for (let i = len - 1; i >= 0; i--) {
+        const randomIndex = ~~(Math.random() * (i + 1));
+        const temp = array[randomIndex];
+        array[randomIndex] = array[i];
+        array[i] = temp;
+    }
+    return array;
+}
+/**
+ * 移动数组中的元素，会返回移动后的新数组。
+ */
+export function arrayMove(array, fromIndex, toIndex) {
+    if (fromIndex === toIndex ||
+        fromIndex < 0 ||
+        fromIndex >= array.length ||
+        toIndex < 0 ||
+        toIndex >= array.length) {
+        return array;
+    }
+    const fromValue = array[fromIndex];
+    if (fromIndex > toIndex) {
+        return [
+            ...array.slice(0, fromIndex),
+            ...array.slice(fromIndex + 1, toIndex + 1),
+            fromValue,
+            ...array.slice(toIndex + 1),
+        ];
+    }
+    else {
+        return [
+            ...array.slice(0, toIndex),
+            fromValue,
+            ...array.slice(toIndex, fromIndex),
+            ...array.slice(fromIndex + 1),
+        ];
+    }
+}

package/utils/common.d.ts

@@ -0,0 +1,3 @@
+export interface AnyObject {
+    [key: string]: any;
+}

package/utils/common.js

@@ -0,0 +1 @@
+export {};