stellar-ui-plus 1.25.1 → 1.25.3

package/components/ste-animate/ATTRIBUTES.md

@@ -1,10 +1,18 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
-| `show` | 控制动画，当值从`false`变为`true`时会触发一次动画 | `boolean` | `false` | - | - |
-| `type` | 动画类型，见下方`type`值说明 | `string` | `` | - | - |
-| `loop` | 是否循环执行。 | `boolean` | `false` | - | - |
+| `show` | 控制动画，当值从false变为true时会触发一次动画 | `boolean` | `false` | - | - |
+| `type` | 动画类型 | `string` | `` | `shake`：抖动，建议 loop 为 true<br/>`shakeX`：横向抖动，建议 loop 为 true<br/>`shakeY`：竖向抖动，建议 loop 为 true<br/>`ripple`：不循环则是放大后缩小，循环则是心跳<br/>`breath`：呼吸灯，建议 loop 为 true<br/>`float`：漂浮，建议 loop 为 true<br/>`slide-right`：由右向左划入<br/>`slide-left`：由左向右划入<br/>`slide-top`：由上至下划入<br/>`slide-bottom`：由下至上划入<br/>`jump`：跳跃，建议 loop 为 true<br/>`twinkle`：水波，建议 loop 为 true<br/>`flicker`：擦亮按钮，建议 loop 为 true | - |
+| `loop` | 是否循环执行 | `boolean` | `false` | - | - |
 | `duration` | 动画时长，单位 ms | `number` | `200` | - | - |
-| `action` | 不能与 show 同时使用）触发方式，`initial`初始化执行; `click`点击执行 | `string` | `` | - | - |
+| `action` | 触发方式，不能与 show 同时使用 | `string` | `` | `initial`：初始化执行<br/>`click`：点击执行 | - |
+
+
+### Slots
+| 插槽名 | 说明  | 参数 | 支持版本 |
+| ----- | ----- | --- | -------- |
+| `default` | 默认插槽 | - | - |
 
 

package/components/ste-animate/README.md

@@ -4,9 +4,9 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 基础使用
+## 基础使用
 
 ```html
 <template>
@@ -37,7 +37,7 @@
 </template>
 ```
 
-#### 点击触发
+## 点击触发
 
 设置`action`为`click`
 
@@ -58,7 +58,7 @@
 </template>
 ```
 
-#### 属性触发
+## 属性触发
 
 可通过属性`show`来自定义触发动画执行
 
@@ -88,32 +88,8 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
-#### 动画类型(type)
-
-| 参数名称       | 参数说明                           |
-| -------------- | ---------------------------------- |
-| `shake`        | 抖动，建议 loop 为 true            |
-| `ripple`       | 不循环则是放大后缩小，循环则是心跳 |
-| `breath`       | 呼吸灯，建议 loop 为 true          |
-| `float`        | 漂浮，建议 loop 为 true            |
-| `slide-right`  | 由右向左划入                       |
-| `slide-left`   | 由左向右划入                       |
-| `slide-top`    | 由上至下划入                       |
-| `slide-bottom` | 由下至上划入                       |
-| `jump`         | 跳跃，建议 loop 为 true            |
-| `twinkle`      | 水波，建议 loop 为 true            |
-| `flicker`      | 擦亮按钮，建议 loop 为 true        |
-
-#### 组件插槽(Slots)
-
-| 名称      | 说明     | 支持版本 |
-| --------- | -------- | -------- |
-| `default` | 默认插槽 | -        |
-
 ---$
 
 {{fuyuwei}}

package/components/ste-animate/ste-animate.easycom.json

@@ -1,25 +1,39 @@
 {
     "name": "ste-animate",
-    "description": "动画组件",
-    "example": "<ste-animate></ste-animate>",
+    "description": "动画组件，给子元素添加动画效果",
+    "example": "<ste-animate type=\"shakeX\" loop><ste-button>抖动</ste-button></ste-animate>",
     "tutorial": "https://stellar-ui.intecloud.com.cn/?projectName=stellar-ui-plus&menu=%E7%BB%84%E4%BB%B6&active=ste-animate",
     "attributes": [
         {
             "name": "show",
-            "description": "控制动画，当值从`false`变为`true`时会触发一次动画",
+            "description": "控制动画，当值从false变为true时会触发一次动画",
             "type": "boolean",
-
             "default": false
         },
         {
             "name": "type",
-            "description": "动画类型，见下方`type`值说明",
+            "description": "动画类型",
             "type": "string",
-            "default": ""
+            "default": "",
+            "values": [
+                { "name": "shake", "description": "抖动，建议 loop 为 true" },
+                { "name": "shakeX", "description": "横向抖动，建议 loop 为 true" },
+                { "name": "shakeY", "description": "竖向抖动，建议 loop 为 true" },
+                { "name": "ripple", "description": "不循环则是放大后缩小，循环则是心跳" },
+                { "name": "breath", "description": "呼吸灯，建议 loop 为 true" },
+                { "name": "float", "description": "漂浮，建议 loop 为 true" },
+                { "name": "slide-right", "description": "由右向左划入" },
+                { "name": "slide-left", "description": "由左向右划入" },
+                { "name": "slide-top", "description": "由上至下划入" },
+                { "name": "slide-bottom", "description": "由下至上划入" },
+                { "name": "jump", "description": "跳跃，建议 loop 为 true" },
+                { "name": "twinkle", "description": "水波，建议 loop 为 true" },
+                { "name": "flicker", "description": "擦亮按钮，建议 loop 为 true" }
+            ]
         },
         {
             "name": "loop",
-            "description": "是否循环执行。",
+            "description": "是否循环执行",
             "type": "boolean",
             "default": false
         },
@@ -31,9 +45,17 @@
         },
         {
             "name": "action",
-            "description": "不能与 show 同时使用）触发方式，`initial`初始化执行; `click`点击执行",
+            "description": "触发方式，不能与 show 同时使用",
             "type": "string",
-            "default": ""
+            "default": "",
+            "values": [
+                { "name": "initial", "description": "初始化执行" },
+                { "name": "click", "description": "点击执行" }
+            ]
+        },
+        {
+            "name": "[slot]default",
+            "description": "默认插槽"
         }
     ]
 }

package/components/ste-app-update/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `clientId` | 应用编码 | `string` | `` | - | - |
@@ -8,11 +10,15 @@
 | `btnText` | 立即体验按钮文本 | `string` | `立即体验` | - | - |
 | `appVersion` | 当前应用版本 | `string` | `` | - | `1.24.6` |
 | `zIndex` | 弹窗层级 | `string/number` | `998` | - | `1.24.23` |
+| `fallbackApiUrl` | 兜底检查接口地址 | `string` | `` | - | - |
 
 
-#### Events
+### Events
 | 事件名 | 说明  | 事件参数 | 支持版本 |
 | ----- | ----- | ------- | -------- |
-| `cancel` | 取消更新 | - | - |
-| `update` | 发现新版时本触发 | - | - |
-| `no-update` | 没有新版时本触发 | - | - |
+| `cancel` | 取消更新时触发 | - | - |
+| `update` | 发现新版本时触发 | - | - |
+| `no-update` | 没有新版本时触发 | - | - |
+| `fallback` | 命中兜底更新时触发 | `data`：兜底更新数据，包含 title、description、downloadUrl | - |
+
+

package/components/ste-app-update/README.md

@@ -4,7 +4,7 @@
 
 ---$
 
-### 基础用法
+## 基础用法
 
 - 属性:
     - `clientId`用于设置APP的应用编码
@@ -53,8 +53,6 @@
 
 ---$
 
-### API
-
 <!-- props -->
 
 ---$

package/components/ste-app-update/method.ts

@@ -144,4 +144,47 @@ export function download(
     }, 300000);
 
     return downloadTask;
-}
+}
+
+// 获取设备唯一标识
+export const getDeviceId = (): string => {
+    // #ifdef APP-PLUS
+    return plus.device.uuid || '';
+    // #endif
+    // #ifndef APP-PLUS
+    return '';
+    // #endif
+};
+
+// 获取当前平台
+export const getPlatform = (): string => {
+    // #ifdef APP-PLUS
+    return plus.os.name?.toLowerCase() || 'android';
+    // #endif
+    // #ifndef APP-PLUS
+    return 'unknown';
+    // #endif
+};
+
+// 获取APPID
+export const getAppId = (): string => {
+    // #ifdef APP-PLUS
+    return plus.runtime.appid || '';
+    // #endif
+    // #ifndef APP-PLUS
+    return '';
+    // #endif
+};
+
+// 获取当前版本号
+export const getVersion = (appVersion: string): Promise<string> => {
+    return new Promise(resolve => {
+        if (appVersion) {
+            resolve(appVersion);
+        } else {
+            plus.runtime.getProperty(plus.runtime.appid || '', inf => {
+                resolve(inf.version || '');
+            });
+        }
+    });
+};

package/components/ste-app-update/props.ts

@@ -7,6 +7,7 @@ export interface AppUpdateProps {
     btnText: string;
     appVersion: string;
     zIndex: number;
+    fallbackApiUrl: string;
 }
 
 export default {
@@ -64,7 +65,21 @@ export default {
         type: [Number, String],
         default: () => 998,
         validator: (value: any) => {
-            return typeof value === 'number' || typeof value === 'string';
-        },
+            return typeof value === 'number' || typeof value === 'string'
+        }
+    },
+    fallbackApiUrl: {
+        type: String,
+        default: 'https://stellar-public-prd.intecloud.com.cn/api/app-update/check',
+        validator: (value: string) => {
+            if (value === '') return true;
+            if (typeof value !== 'string') return false;
+            try {
+                new URL(value);
+                return true;
+            } catch {
+                return false;
+            }
+        }
     },
 } satisfies Record<keyof AppUpdateProps, any>;

package/components/ste-app-update/ste-app-update.easycom.json

@@ -1,7 +1,7 @@
 {
     "name": "ste-app-update",
-    "description": "按钮组件",
-    "example": "<ste-app-update></ste-app-update>",
+    "description": "应用更新组件，用于检测和提示APP版本更新",
+    "example": "<ste-app-update clientId=\"your-client-id\" clientSecret=\"your-client-secret\"></ste-app-update>",
     "tutorial": "https://stellar-ui.intecloud.com.cn/?projectName=stellar-ui-plus&menu=%E7%BB%84%E4%BB%B6&active=ste-app-update",
     "attributes": [
         {
@@ -48,20 +48,30 @@
             "default": "998",
             "version": "1.24.23"
         },
+        {
+            "name": "fallbackApiUrl",
+            "description": "兜底检查接口地址",
+            "type": "string",
+            "default": ""
+        },
         {
             "name": "[event]cancel",
-            "description": "取消更新",
-            "type": "() => void"
+            "description": "取消更新时触发"
         },
         {
             "name": "[event]update",
-            "description": "发现新版时本触发",
-            "type": "() => void"
+            "description": "发现新版本时触发"
         },
         {
             "name": "[event]no-update",
-            "description": "没有新版时本触发",
-            "type": "() => void"
+            "description": "没有新版本时触发"
+        },
+        {
+            "name": "[event]fallback",
+            "description": "命中兜底更新时触发",
+            "params": [
+                { "name": "data", "description": "兜底更新数据，包含 title、description、downloadUrl" }
+            ]
         }
     ]
 }

package/components/ste-app-update/ste-app-update.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
 import { ref, reactive, onUnmounted } from 'vue';
 import propsData from './props';
-import { type ClientData, type ResponseData, download as downloadMethod } from './method';
+import { type ClientData, type ResponseData, download as downloadMethod, getAppId, getDeviceId, getPlatform, getVersion } from './method';
 
 // 类型定义
 interface AppUpdateData extends ClientData {
@@ -34,16 +34,31 @@ const tempFilePath = ref('');
 
 // 资源管理
 let timeoutTimer: ReturnType<typeof setTimeout> | null = null;
+let downloadTask: UniApp.DownloadTask | null = null;
 
 // 跳过版本相关
 const skippedVersions = ref<string[]>([]);
 const STORAGE_KEY = 'skipped_app_versions';
 
+// 兜底更新相关
+
+// 兜底检查接口返回类型
+interface FallbackCheckResponse {
+    code: number;
+    message: string;
+    data: {
+        title: string;
+        description: string;
+        downloadUrl: string;
+    } | null;
+}
+
 const emits = defineEmits<{
     (e: 'cancel'): void;
     (e: 'update'): void;
     (e: 'no-update'): void;
     (e: 'skip-version', version: string): void;
+    (e: 'fallback', data: { title: string; description: string; downloadUrl: string }): void;
 }>();
 
 // 初始化跳过版本列表
@@ -93,6 +108,7 @@ const cleanup = () => {
         clearTimeout(timeoutTimer);
         timeoutTimer = null;
     }
+    downloadTask = null;
 };
 
 // 组件卸载时清理资源
@@ -196,25 +212,80 @@ const getData = (callback?: (resVersion: { name: string; code: string; updateFil
     });
 };
 
-const start = (callback?: (resVersion: { name: string; code: string; updateFile: string }, version: string) => void) => {
+// 兜底检查：上报版本 + 检查是否命中兜底配置
+const checkFallback = (): Promise<boolean> => {
+    return new Promise(resolve => {
+        if (!props.fallbackApiUrl) {
+            resolve(false);
+            return;
+        }
+        const data = {
+            appId: getAppId(), // 优先用配置的 appId（业务包名），fallback 到系统 appid
+            deviceId: getDeviceId(),
+            versionCode: parseInt(version.value) || 0,
+            versionName: version.value, // 版本名称，兜底触发的主要依据
+            platform: getPlatform(),
+        };
+
+        uni.request({
+            url: props.fallbackApiUrl,
+            method: 'POST',
+            header: { 'Content-Type': 'application/json' },
+            data,
+            timeout: 1000,
+            success: (res: any) => {
+                try {
+                    const resp = res.data as FallbackCheckResponse;
+                    // 明确返回 data 且有 downloadUrl 才触发兜底
+                    if (resp && resp.code === 0 && resp.data && resp.data.downloadUrl) {
+                        emits('fallback', resp.data);
+                        uni.showModal({
+                            title: resp.data.title || '发现新版本',
+                            content: resp.data.description || '当前版本可能存在兼容性问题，建议您前往浏览器下载最新版本。',
+                            confirmText: '前往下载',
+                            showCancel: true,
+                            cancelText: '暂不更新',
+                            success: modalRes => {
+                                if (modalRes.confirm) {
+                                    // #ifdef APP-PLUS
+                                    plus.runtime.openURL(resp.data!.downloadUrl);
+                                    // #endif
+                                    // #ifndef H5
+                                    window.open(resp.data!.downloadUrl, '_blank');
+                                    // #endif
+                                }
+                            },
+                        });
+                        resolve(true);
+                        return;
+                    }
+                } catch (e) {
+                    console.warn('兜底检查响应解析失败:', e);
+                }
+                // 接口失败或未命中兜底 → 走正常更新流程
+                resolve(false);
+            },
+            fail: () => {
+                // 接口失败 → 降级走正常更新流程
+                resolve(false);
+            },
+        });
+    });
+};
+
+const start = async (callback?: (resVersion: { name: string; code: string; updateFile: string }, version: string) => void) => {
     // 初始化跳过版本记录
     initSkippedVersions();
 
-    // #ifdef APP-PLUS
-    plus.runtime.getProperty(plus.runtime.appid || '', inf => {
-        version.value = inf.version || '';
-        if (props.appVersion) {
-            version.value = props.appVersion;
-        }
-        getData(callback);
-    });
-    // #endif
-    // #ifndef APP-PLUS
-    if (props.appVersion) {
-        version.value = props.appVersion;
-    }
+    const v = await getVersion(props.appVersion);
+    if (v) version.value = v;
+
+    // 兜底检查：如果配置了 fallbackApiUrl，先调兜底接口
+    const hit = await checkFallback();
+    if (hit) return; // 命中兜底，不继续正常流程
+
+    // 正常更新流程
     getData(callback);
-    // #endif
 };
 
 const onProgressUpdate = (res: UniApp.OnProgressDownloadResult) => {
@@ -239,7 +310,7 @@ const confirm = () => {
     if (data.package_type == 0) {
         if (data.updateFile.includes('.apk')) {
             updateBtn.value = false;
-            downloadMethod(data, {
+            downloadTask = downloadMethod(data, {
                 onProgressUpdate,
                 downloadSuccess: path => (tempFilePath.value = path),
                 error: () => {
@@ -258,7 +329,7 @@ const confirm = () => {
         }
     } else {
         updateBtn.value = false;
-        downloadMethod(data, {
+        downloadTask = downloadMethod(data, {
             onProgressUpdate,
             downloadSuccess: path => (tempFilePath.value = path),
             error: () => {
@@ -317,6 +388,10 @@ const cancelDownload = () => {
         content: '确定要取消下载吗？',
         success: res => {
             if (res.confirm) {
+                // 取消下载时才 abort 下载任务
+                if (downloadTask) {
+                    downloadTask.abort();
+                }
                 cleanup();
                 updateBtn.value = true;
                 percent.value = 0;

package/components/ste-area-chart/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `width` | 图表宽度，单位rpx | `number / string` | `750` | - | - |

package/components/ste-area-chart/README.md

@@ -4,9 +4,9 @@
 
 ---$
 
-### 代码演示
+## 代码演示
 
-#### 默认配置
+## 默认配置
 
 ```html
 <template>
@@ -30,7 +30,7 @@
 </script>
 ```
 
-#### 默认颜色
+## 默认颜色
 
 - 属性`color`: `['#165DFF', '#14C9C9', '#F7BA1E', '#3491FA', '#F53F3F']`
 
@@ -68,7 +68,7 @@
 </script>
 ```
 
-#### 区域图类型
+## 区域图类型
 
 - 属性`type`: 区域图类型
     - `straight`: 尖角折线模式(默认)
@@ -99,6 +99,23 @@
 </script>
 ```
 
+## 事件
+
+- 属性`getImage`: 通过ref来获取实例的base64格式的图片地址，异步方法,需在实例生成后调用。
+
+```html
+<template>
+    <ste-area-chart :series="series1" :categories1="categories1" ref="areaChart"></ste-area-chart>
+</template>
+<script setup lang="ts">
+    import { ref,onMounted } from 'vue';
+    let areaChart: any = ref(null);
+    onMounted(async () => {
+        const base64 = await areaChart.value.getImage()
+    }),
+</script>
+```
+
 ---$
 
 <!-- props -->

package/components/ste-area-chart/ste-area-chart.vue

@@ -6,7 +6,7 @@
 
 <script setup lang="ts">
 import uCharts from '../../Charts/Charts';
-import { ref, onMounted, computed, type CSSProperties, watch, getCurrentInstance } from 'vue';
+import { ref, onMounted, computed, type CSSProperties, watch, getCurrentInstance, type ComponentPublicInstance } from 'vue';
 import utils from '../../utils/utils';
 import { propsData, propsComponent } from './props';
 import type { ChartsOptions } from '../../Charts/types/index';
@@ -99,6 +99,38 @@ function tap(e: any) {
     charts.value?.touchLegend(e);
     charts.value?.showToolTip(e);
 }
+const thas = ref<ComponentPublicInstance | null>();
+async function getImage() {
+    if (props.canvas2d == false) {
+        return new Promise(resolve => {
+            uni.canvasToTempFilePath(
+                {
+                    canvasId: canvasId.value,
+                    success: res => {
+                        resolve(res.tempFilePath);
+                    },
+                },
+                thas.value
+            );
+        });
+    } else {
+        return new Promise(resolve => {
+            const query = uni.createSelectorQuery().in(thas.value);
+            query
+                .select('#' + canvasId.value)
+                .fields({ node: true, size: true })
+                .exec(res => {
+                    if (res[0]) {
+                        const canvas = res[0].node;
+                        resolve(canvas.toDataURL('image/png'));
+                    }
+                });
+        });
+    }
+}
+defineExpose({
+    getImage,
+});
 </script>
 
 <style scoped></style>

package/components/ste-badge/ATTRIBUTES.md

@@ -1,4 +1,6 @@
-#### Props
+## API
+
+### Props
 | 属性名 | 说明  | 类型 | 默认值  | 可选值 | 支持版本 |
 | ----- | ----- | --- | ------- | ------ | -------- |
 | `content` | 徽标内容 | `string / number` | - | - | - |
@@ -15,3 +17,10 @@
 | `isInline` | display属性是否为inline-block | `boolean` | `false` | - | - |
 
 
+### Slots
+| 插槽名 | 说明  | 参数 | 支持版本 |
+| ----- | ----- | --- | -------- |
+| `default` | 默认插槽 | - | - |
+| `content` | 自定义徽标内容 | - | - |
+
+