sard-uniapp 1.11.2 → 1.12.0

package/utils/geometry.d.ts

@@ -0,0 +1,67 @@
+export type ScrollIntoViewPosition = 'start' | 'center' | 'end' | 'nearest';
+export interface ScrollIntoViewValueOptions {
+    position?: ScrollIntoViewPosition;
+    startOffset?: number;
+    endOffset?: number;
+}
+export interface ScrollIntoViewOptions {
+    position?: ScrollIntoViewPosition;
+    startOffset?: number;
+    endOffset?: number;
+    duration?: number;
+}
+/**
+```
+                      page
+                     ╱
+    ╭───────────────╮    viewport
+  ╭─│─ ─ ─ ─ ─ ─ ─ ─│─╮ ╱
+  │ │ ╭───────────╮ │ │
+  │ │ │  element  │ │ │
+  │ │ ╰───────────╯ │ │
+  ╰─│─ ─ ─ ─ ─ ─ ─ ─│─╯
+    │               │
+    │               │
+    ╰───────────────╯
+```
+
+# 参数
+- viewportHeight: viewport 高度
+- viewportScrollTop: viewport 垂直滚动值
+- elementHeight: element 高度
+- elementOffsetTop: element 距离页面顶部距离
+
+# 选项
+- position: element 在视窗中的位置(start, center, end, nearest)
+- startOffset: element 距离视窗顶部的偏移量
+- endOffset: element 距离视窗底部的偏移量
+
+# 结果值
+- viewportScrollTop: viewport 新的垂直滚动值
+
+*/
+export declare function getScrollIntoViewValue(viewportHeight: number, viewportScrollTop: number, elementHeight: number, elementOffsetTop: number, options?: ScrollIntoViewValueOptions): number;
+export interface NodeRect {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+    height: number;
+    width: number;
+}
+interface MatchScrollVisibleOptions {
+    offset?: number;
+    errorValue?: number;
+}
+/**
+ * @description: 匹配元素列表中第一个位于滚动盒子可视区域的元素
+ */
+export declare function matchScrollVisible(rects: NodeRect[], callback: (index: number) => unknown, options?: MatchScrollVisibleOptions): Promise<unknown>;
+export declare function getAspectFillSize(origWidth: number, origHeight: number, containerWidth: number, containerHeight: number): [number, number];
+export declare function getAspectFitSize(origWidth: number, origHeight: number, containerWidth: number, containerHeight: number): [number, number];
+interface Point {
+    x: number;
+    y: number;
+}
+export declare function getTwoPointsDistance(p1: Point, p2: Point): number;
+export {};

package/utils/geometry.js

@@ -0,0 +1,127 @@
+/**
+```
+                      page
+                     ╱
+    ╭───────────────╮    viewport
+  ╭─│─ ─ ─ ─ ─ ─ ─ ─│─╮ ╱
+  │ │ ╭───────────╮ │ │
+  │ │ │  element  │ │ │
+  │ │ ╰───────────╯ │ │
+  ╰─│─ ─ ─ ─ ─ ─ ─ ─│─╯
+    │               │
+    │               │
+    ╰───────────────╯
+```
+
+# 参数
+- viewportHeight: viewport 高度
+- viewportScrollTop: viewport 垂直滚动值
+- elementHeight: element 高度
+- elementOffsetTop: element 距离页面顶部距离
+
+# 选项
+- position: element 在视窗中的位置(start, center, end, nearest)
+- startOffset: element 距离视窗顶部的偏移量
+- endOffset: element 距离视窗底部的偏移量
+
+# 结果值
+- viewportScrollTop: viewport 新的垂直滚动值
+
+*/
+export function getScrollIntoViewValue(viewportHeight, viewportScrollTop, elementHeight, elementOffsetTop, options = {}) {
+    const { startOffset = 0, endOffset = 0 } = options;
+    let position = options.position || 'nearest';
+    const elementToViewportTopOffset = elementOffsetTop - viewportScrollTop - startOffset;
+    const elementToViewportBottomOffset = elementOffsetTop +
+        elementHeight -
+        viewportScrollTop -
+        viewportHeight +
+        endOffset;
+    if (position === 'nearest') {
+        if (elementToViewportTopOffset >= 0 && elementToViewportBottomOffset <= 0) {
+            return viewportScrollTop;
+        }
+        else {
+            position =
+                Math.abs(elementToViewportTopOffset) >
+                    Math.abs(elementToViewportBottomOffset)
+                    ? 'end'
+                    : 'start';
+        }
+    }
+    let nextScrollTop = 0;
+    switch (position) {
+        case 'start':
+            nextScrollTop = elementOffsetTop - startOffset;
+            break;
+        case 'center':
+            nextScrollTop =
+                elementOffsetTop -
+                    (viewportHeight - elementHeight - endOffset - startOffset) / 2 +
+                    startOffset;
+            break;
+        case 'end':
+            nextScrollTop =
+                elementOffsetTop + elementHeight - viewportHeight + endOffset;
+            break;
+    }
+    return nextScrollTop;
+}
+/**
+ * @description: 匹配元素列表中第一个位于滚动盒子可视区域的元素
+ */
+export async function matchScrollVisible(rects, callback, options = {}) {
+    const { offset: optionOffset = 0, errorValue = 3 } = options;
+    const offset = optionOffset + errorValue;
+    const convertedRect = rects.map((rect, i) => {
+        return {
+            top: rect.top,
+            bottom: i < rects.length - 1 ? rects[i + 1].top : 0,
+        };
+    });
+    for (let i = 0, l = convertedRect.length; i < l; i++) {
+        const rect = convertedRect[i];
+        if (i === 0 && rect.top > offset) {
+            return callback(0);
+        }
+        if (rect.top <= offset && rect.bottom > offset) {
+            return callback(i);
+        }
+        if (i === l - 1 && rect.bottom <= offset) {
+            return callback(i);
+        }
+    }
+}
+export function getAspectFillSize(origWidth, origHeight, containerWidth, containerHeight) {
+    let width = 0;
+    let height = 0;
+    if (origWidth > 0 && origHeight > 0) {
+        if (origWidth / origHeight > containerWidth / containerHeight) {
+            height = containerHeight;
+            width = (origWidth / origHeight) * containerHeight;
+        }
+        else {
+            width = containerWidth;
+            height = (origHeight / origWidth) * containerWidth;
+        }
+    }
+    return [width, height];
+}
+export function getAspectFitSize(origWidth, origHeight, containerWidth, containerHeight) {
+    let width = 0;
+    let height = 0;
+    if (origWidth > 0 && origHeight > 0) {
+        if (origWidth / origHeight > containerWidth / containerHeight) {
+            width = containerWidth;
+            height = (origHeight / origWidth) * containerWidth;
+        }
+        else {
+            height = containerHeight;
+            width = (origWidth / origHeight) * containerHeight;
+        }
+    }
+    return [width, height];
+}
+export function getTwoPointsDistance(p1, p2) {
+    return Math.sqrt(Math.pow(p2.x - p1.x, 2) + Math.pow(p2.y - p1.y, 2));
+}

package/utils/index.d.ts

@@ -9,3 +9,5 @@ export * from './lwa.slim';
 export * from './qrcode';
 export * from './system';
 export * from './object';
+export * from './geometry';
+export * from './inertialAnimate';

package/utils/index.js

@@ -9,3 +9,5 @@ export * from './lwa.slim';
 export * from './qrcode';
 export * from './system';
 export * from './object';
+export * from './geometry';
+export * from './inertialAnimate';

package/utils/inertialAnimate.d.ts

@@ -0,0 +1,10 @@
+export interface InertialAnimateOptions {
+    update?: (value: number) => void;
+    complete?: () => void;
+}
+export declare function createInertialAnimate(v: number, options: InertialAnimateOptions): {
+    stop: () => void;
+    play: () => void;
+    isAnimating(): boolean;
+};
+export type InertialAnimate = ReturnType<typeof createInertialAnimate>;

package/utils/inertialAnimate.js

@@ -0,0 +1,42 @@
+import { ticker } from './lwa.slim';
+const friction = 0.95; // 摩擦系数
+const minVelocity = 0.1; // 最小速度
+export function createInertialAnimate(v, options) {
+    const initialVelocity = Math.abs(v);
+    let isAnimating = false;
+    const reversed = v < 0;
+    const { update, complete } = options;
+    let velocity = initialVelocity;
+    function animate() {
+        if (!isAnimating)
+            return;
+        velocity *= friction;
+        let displacement = velocity * 15;
+        displacement *= reversed ? -1 : 1;
+        update?.(displacement);
+        if (velocity < minVelocity) {
+            isAnimating = false;
+            ticker.remove(animate);
+            complete?.();
+        }
+    }
+    function play() {
+        if (!isAnimating) {
+            isAnimating = true;
+            ticker.add(animate);
+        }
+    }
+    function stop() {
+        if (isAnimating) {
+            isAnimating = false;
+            ticker.remove(animate);
+        }
+    }
+    return {
+        stop,
+        play,
+        isAnimating() {
+            return isAnimating;
+        },
+    };
+}

package/utils/is.d.ts

@@ -4,6 +4,14 @@
  * @return {boolean}
  */
 export declare function isPlainObject(target: any): target is Record<PropertyKey, any>;
+/**
+ * @description: 判断是否为对象
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isObject(target: any): target is object & {
+    [key: PropertyKey]: any;
+};
 /**
  * @description: 判断是否为函数
  * @param {any} target

package/utils/is.js

@@ -6,6 +6,14 @@
 export function isPlainObject(target) {
     return Object.prototype.toString.call(target) === '[object Object]';
 }
+/**
+ * @description: 判断是否为对象
+ * @param {any} target
+ * @return {boolean}
+ */
+export function isObject(target) {
+    return target !== null && typeof target === 'object';
+}
 /**
  * @description: 判断是否为函数
  * @param {any} target

package/utils/system.d.ts

@@ -2,3 +2,5 @@ export declare const systemInfo: UniApp.GetSystemInfoResult;
 export declare const isApp: boolean;
 export declare const isWeb: boolean;
 export declare const isMp: boolean;
+export declare const isAlipay: boolean;
+export declare const isWeixin: boolean;

package/utils/system.js

@@ -1,4 +1,7 @@
 export const systemInfo = uni.getSystemInfoSync();
-export const isApp = systemInfo.uniPlatform === 'app';
-export const isWeb = systemInfo.uniPlatform === 'web';
-export const isMp = systemInfo.uniPlatform.startsWith('mp-');
+const platform = systemInfo.uniPlatform;
+export const isApp = platform === 'app';
+export const isWeb = platform === 'web';
+export const isMp = platform.startsWith('mp-');
+export const isAlipay = platform === 'mp-alipay';
+export const isWeixin = platform === 'mp-weixin';

package/utils/utils.d.ts

@@ -119,6 +119,12 @@ export declare function isEmptyValue(value: any, whitespace?: boolean): boolean;
  * @return {boolean}
  */
 export declare function isRenderVisible(value: any): boolean;
+/**
+ * @description: 判断是否绑定为空值
+ * @param {any} target
+ * @return {boolean}
+ */
+export declare function isEmptyBinding(target: any): target is '' | null | undefined;
 export interface DebounceOptions {
     leading?: boolean;
     trailing?: boolean;
@@ -216,4 +222,5 @@ export declare function getDistanceBetweenTwoPoints(c1: Coord, c2: Coord): numbe
 export declare function getMayPrimitiveOption(option: string | number | boolean | {
     [key: PropertyKey]: any;
 }, key: string): any;
+export declare function sleep(time: number): Promise<unknown>;
 export {};

package/utils/utils.js

@@ -253,6 +253,14 @@ export function isRenderVisible(value) {
         value !== undefined &&
         (typeof value !== 'string' || value.trim() !== ''));
 }
+/**
+ * @description: 判断是否绑定为空值
+ * @param {any} target
+ * @return {boolean}
+ */
+export function isEmptyBinding(target) {
+    return target === null || target === undefined || target === '';
+}
 export function debounce(func, wait, options = {}) {
     let lastArgs, lastThis, maxWait, result, timerId, lastCallTime;
     let lastInvokeTime = 0;
@@ -652,3 +660,8 @@ export function getDistanceBetweenTwoPoints(c1, c2) {
 export function getMayPrimitiveOption(option, key) {
     return isPrimitive(option) ? option : option[key];
 }
+export async function sleep(time) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, time);
+    });
+}

package/components/_template/_template.d.ts

@@ -1,16 +0,0 @@
-import { type _TemplateProps, type _TemplateSlots } from './common';
-declare function __VLS_template(): Readonly<_TemplateSlots> & _TemplateSlots;
-declare const __VLS_component: import("vue").DefineComponent<_TemplateProps, {
-    reset: () => void;
-}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
-    click: (event: any) => any;
-}, string, import("vue").PublicProps, Readonly<_TemplateProps> & Readonly<{
-    onClick?: ((event: any) => any) | undefined;
-}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
-declare const _default: __VLS_WithTemplateSlots<typeof __VLS_component, ReturnType<typeof __VLS_template>>;
-export default _default;
-type __VLS_WithTemplateSlots<T, S> = T & {
-    new (): {
-        $slots: S;
-    };
-};

package/components/_template/_template.vue

@@ -1,45 +0,0 @@
-<template>
-  <view :class="_templateClass" :style="_templateStyle">
-    <slot></slot>
-  </view>
-</template>
-
-<script>
-import { defineComponent as _defineComponent } from "vue";
-import { computed } from "vue";
-import { classNames, stringifyStyle, createBem } from "../../utils";
-export default  _defineComponent({
-  ...{
-    options: {
-      virtualHost: true,
-      styleIsolation: "shared"
-    }
-  },
-  __name: "_template",
-  props: {
-    rootStyle: { type: [Boolean, null, String, Object, Array], required: false, skipCheck: true },
-    rootClass: { type: String, required: false }
-  },
-  emits: ["click"],
-  setup(__props, { expose: __expose }) {
-    const props = __props;
-    const bem = createBem("_template");
-    __expose({
-      reset: () => {
-      }
-    });
-    const _templateClass = computed(() => {
-      return classNames(bem.b(), props.rootClass);
-    });
-    const _templateStyle = computed(() => {
-      return stringifyStyle(props.rootStyle);
-    });
-    const __returned__ = { props, bem, _templateClass, _templateStyle };
-    return __returned__;
-  }
-});
-</script>
-
-<style lang="scss">
-@import './index.scss';
-</style>

package/components/_template/common.d.ts

@@ -1,14 +0,0 @@
-import { type StyleValue } from 'vue';
-export interface _TemplateProps {
-    rootStyle?: StyleValue;
-    rootClass?: string;
-}
-export interface _TemplateSlots {
-    default?(props: Record<string, never>): any;
-}
-export interface _TemplateEmits {
-    (e: 'click', event: any): void;
-}
-export interface _TemplateExpose {
-    reset: () => void;
-}

package/components/_template/index.d.ts

@@ -1 +0,0 @@
-export type { _TemplateProps, _TemplateSlots, _TemplateEmits, _TemplateExpose, } from './common';

package/components/_template/index.scss

@@ -1,17 +0,0 @@
-@use '../style/base' as *;
-
-@include bem(_template) {
-  @include b() {
-    @include universal;
-  }
-
-  @include e(element) {
-    @include universal;
-
-    @include m(modifier) {
-    }
-  }
-
-  @include m(modifier) {
-  }
-}

package/components/_template/variables.scss

@@ -1,5 +0,0 @@
-// #variables
-page {
-  --sar-template-bg: #fff;
-}
-// #endvariables