uview-plus 3.8.119 → 3.8.125

package/changelog.md

@@ -1,3 +1,59 @@
+## 3.8.125
+fix: 修复签名组件在 App 端无法绘制、笔迹画出后闪退的问题
+
+u-signature 在 App 端（APP-PLUS 旧版 canvas）存在无法落笔、笔迹一闪即消失的问题，根因是画布上下文异步就绪未做握手、触摸坐标未换算到画布坐标系、以及每次 draw 都会刷新绘图命令队列导致已画笔迹被清空。
+
+- 修复笔迹画出后立即消失：touchMove 改为「增量线段」绘制（beginPath + moveTo 上一点 + lineTo 当前点 + stroke），并使用 draw(true) 保留已绘制内容，不再每次 draw(false) 清空命令队列
+- 修复 App 端坐标错乱、笔迹落到画布外：getCanvasPoint 优先使用画布相对坐标，缺失时用视口坐标减去画布位置进行换算
+- 修复画布上下文异步就绪时首笔丢失：新增画布 ready / initCanvas 握手，缓存画布位置并在画布就绪后再响应绘制
+- 收尾不再 closePath，避免手写笔迹出现回连直线；撤销回放逻辑保持兼容
+- 覆盖 APP-PLUS / APP-HARMONY / APP-NVUE，微信小程序与 H5 行为保持不变
+
+## 3.8.124
+fix: App 端图标字体默认使用本地字体，新增通用 Vite 插件入口 UpVite
+
+u-icon 的 useAppStaticIconFont 原先写死 false，只有启用 UniUpRoot 的项目才会在构建期被改成 true；未启用 Root 组件的 App 项目仍然走远程 CDN 字体，弱网或离线时图标会丢失。本地字体是随包能力，不该由是否使用 Root 组件决定。
+
+- App / App-nvue 默认优先加载随包分发的 _www/static/app-plus/uview-plus/upicon.ttf
+- App-Vue 在 uni.loadFontFace 失败后回退 config.iconUrl，每个页面只回退一次；App-nvue 因 dom.addRule 没有失败回调，注册前用 plus.io.resolveLocalFileSystemURL 探测字体文件，缺失时回退远程
+- 新增通用 Vite 插件入口 UpVite（libs/vite/index.js），App 本地图标字体是它的第一个 feature；后续组件库新增构建期能力只需在插件内追加，业务项目不需要再改自己的 vite.config
+- UniUpRoot 复用同一份图标字体 feature 并新增 appStaticIconFont: false 选项，只装 Root 插件的项目行为完全不变
+- 不使用 Root 组件的项目单独引入 UpVite() 即可复制字体并移除 App 远程 @font-face
+- 新增 verify:app-local-icon-font 回归校验，覆盖 static 路径、两端兜底、插件复制行为与关闭开关
+- H5 与小程序行为不变，仍使用 config.iconUrl
+
+## 3.8.123
+fix: 修复 u-slider 区间模式 v-model:rangeValue 不生效 (#554)
+
+u-slider 区间模式（isRange）拖动滑块时只抛出 update:modelValue，未抛出 update:rangeValue，导致 v-model:rangeValue 双向绑定无法更新。此外 rangeValue 的 default 为数组字面量，所有实例共用同一引用。
+
+- 拖动结束时正确抛出 update:rangeValue 事件，同时兼容此前监听 update:modelValue 获取区间值的用法
+- 值未变化时跳过事件抛出，避免父级对数组做拷贝或归一化时形成更新回环
+- rangeValue 的 default 改为工厂函数，避免实例间共享数组引用
+- 补充 isRange、rangeValue 及 onUpdate:rangeValue 类型声明
+- 新增 verify:slider-range-value-model 回归校验脚本
+
+## 3.8.122
+fix: 修复 u-row-notice 横向滚动空格丢失
+
+u-row-notice 每 20 个字符切分渲染到独立的 text 标签，若第 21 个字符为空格，会落在第二段行首被 CSS 折叠空白吃掉，导致横向滚动时两个字粘连。现将滚动文本 white-space 改为 pre，在保留原文空格的同时禁止换行，避免行首行尾空白被丢弃，并通过回归校验覆盖分段空格边界场景。
+
+## 3.8.121
+fix: 修复 up-button 真机首次点击后失效
+
+默认 throttleTime 为 0 时直接同步执行点击回调，不再依赖异步 setTimeout 释放全局节流锁，避免真机定时器未释放时后续点击被拦截。新增零延迟连续调用回归校验。
+
+## 3.8.120
+fix(types): 组件类型可直接从包名导入，模板提示补齐 u-/u-- 前缀
+
+本版仅完善 TypeScript 类型与 IDE 模板提示，不改变组件运行时行为和 API。
+
+- `uview-plus` 包入口重新导出 126 个公开组件类型，Props、Slots、Ref 可直接从包名导入，不再依赖 `uview-plus/types/comps/*` 内部路径
+- Ref 类型统一按 `typeof` 导出，避免将源文件中的 const 声明当作类型使用时报 TS2749
+- `GlobalComponents` 同时登记 `up-`、`u-`、`u--` 三种 easycom 前缀，模板中的 `u-button`、`u--button` 写法也能获得组件类型提示
+- 保留一份组件清单，通过模板字面量键改写生成三种前缀，避免清单重复维护
+- 新增 `verify:types-barrel-exports` 回归校验，防止入口类型导出与模板组件登记清单漂移
+
 ## 3.8.119
 fix: 修复 datetime-picker format 兼容性与 tabbar 边框切页丢失
 
@@ -2725,3 +2781,13 @@ fix: #261u-input在直接修改v-model的绑定值时，每隔一次会无法出
 
 - feat: tabbar 新增多种风格预设、动态图标切换与轻量选中动画
 - improvment: tabbar 补充高颜值本地图标示例并优化发布型底栏视觉
+## 3.8.121
+fix: 修复 up-button 真机首次点击后失效
+
+用户反馈 up-button 在网页端正常，但在真机上点击一次后无法再次触发 click 事件。组件默认 throttleTime 为 0，原节流实现仍会先将全局节流标志置为 true，再依赖 setTimeout 回调异步释放；当真机运行环境没有按预期执行该定时回调时，全局标志会一直保持锁定状态，后续所有使用节流的点击都会被拦截。
+
+- throttle 的 wait 小于等于 0 时直接同步执行回调并返回，不再挂起全局锁
+- 保留大于 0 时原有的立即节流与非立即节流行为，API 不变
+- 新增 `verify:button-throttle` 回归校验，覆盖零延迟连续调用场景
+
+## 3.8.120

package/components/u-icon/util.js

@@ -2,7 +2,10 @@ import config from '../../libs/config/config';
 
 const iconFontFamily = 'uicon-iconfont';
 const appIconFontUrl = '_www/static/app-plus/uview-plus/upicon.ttf';
-const useAppStaticIconFont = false;
+// App 端默认优先加载随包分发的本地字体，图标不再依赖 CDN。
+// 项目没有本地字体（未启用本地字体构建插件、或没拷贝 static/app-plus/uview-plus/upicon.ttf）时：
+// App-Vue 在 uni.loadFontFace 失败后回退 config.iconUrl，App-nvue 先探测字体文件是否存在再决定字体地址。
+const useAppStaticIconFont = true;
 
 let params = {
     loaded: false,
@@ -12,6 +15,8 @@ let params = {
 // #ifdef APP-VUE
 const appVueLoadedPages = new WeakSet();
 const appVueLoadingPages = new WeakSet();
+// 本地字体加载失败后回退远程字体，每个页面只回退一次，避免反复请求不存在的本地字体
+const appVueFallbackPages = new WeakSet();
 // #endif
 
 const getCurrentAppVuePage = () => {
@@ -44,7 +49,6 @@ const getAppIconUrl = () => {
     }
     if (typeof plus !== 'undefined' && plus.io && typeof plus.io.convertLocalFileSystemURL === 'function') {
         const iconFontPath = plus.io.convertLocalFileSystemURL(appIconFontUrl);
-        // if (iconFontPath) return iconFontPath;
         return iconFontPath && iconFontPath.startsWith('file://') ? iconFontPath : 'file://' + iconFontPath;
     }
     return appIconFontUrl;
@@ -75,6 +79,69 @@ const markFontLoaded = () => {
     }
 };
 
+// #ifdef APP-NVUE
+const addNvueFontRule = (family, url) => {
+    const domModule = weex.requireModule('dom');
+    domModule.addRule('fontFace', {
+        'fontFamily': family,
+        'src': `url('${url}')`
+    });
+};
+
+// nvue的dom.addRule没有失败回调，注册前先探测本地字体文件是否存在，不存在时回退远程字体
+const registerNvueFontFace = (iconUrl) => {
+    const addFontFace = (url) => {
+        addNvueFontRule(iconFontFamily, url);
+        if (config.customIcon.family) {
+            addNvueFontRule(config.customIcon.family, config.customIcon.url);
+        }
+        markFontLoaded();
+    };
+    if (!useAppStaticIconFont || iconUrl === config.iconUrl) {
+        addFontFace(iconUrl);
+        return;
+    }
+    if (typeof plus === 'undefined' || !plus.io || typeof plus.io.resolveLocalFileSystemURL !== 'function') {
+        addFontFace(iconUrl);
+        return;
+    }
+    const localFontPath = typeof plus.io.convertLocalFileSystemURL === 'function'
+        ? plus.io.convertLocalFileSystemURL(appIconFontUrl)
+        : appIconFontUrl;
+    try {
+        plus.io.resolveLocalFileSystemURL(localFontPath, () => addFontFace(iconUrl), () => addFontFace(config.iconUrl));
+    } catch (e) {
+        addFontFace(iconUrl);
+    }
+};
+// #endif
+
+// #ifdef APP-VUE
+const registerAppVueFontFace = (iconUrl, appVuePage) => {
+    uni.loadFontFace({
+        global: true, // 是否全局生效。微信小程序 '2.10.0'起支持全局生效，需在 app.vue 中调用。
+        family: iconFontFamily,
+        source: 'url("' + iconUrl + '")',
+        success() {
+            appVueLoadingPages.delete(appVuePage);
+            appVueLoadedPages.add(appVuePage);
+            markFontLoaded();
+            // console.log('内置字体图标加载成功');
+        },
+        fail() {
+            // 本地字体缺失时回退远程字体，保证未启用本地字体的老项目仍可显示图标
+            if (iconUrl !== config.iconUrl && !appVueFallbackPages.has(appVuePage)) {
+                appVueFallbackPages.add(appVuePage);
+                registerAppVueFontFace(config.iconUrl, appVuePage);
+                return;
+            }
+            appVueLoadingPages.delete(appVuePage);
+            // console.error('内置字体图标加载出错');
+        }
+    });
+};
+// #endif
+
 // 加载字体方法
 const loadFont = () => {
     // #ifdef APP-VUE
@@ -94,42 +161,27 @@ const loadFont = () => {
     // #ifdef APP-NVUE
     // nvue通过weex的dom模块引入字体，相关文档地址如下：
     // https://weex.apache.org/zh/docs/modules/dom.html#addrule
-    const domModule = weex.requireModule('dom');
-    domModule.addRule('fontFace', {
-        'fontFamily': iconFontFamily,
-        'src': `url('${iconUrl}')`
-    });
-    if (config.customIcon.family) {
-        domModule.addRule('fontFace', {
-            'fontFamily': config.customIcon.family,
-            'src': `url('${config.customIcon.url}')`
-        });
-    }
-    markFontLoaded();
+    registerNvueFontFace(iconUrl);
     // #endif
-    // #ifdef APP-VUE || H5 || MP-WEIXIN || MP-ALIPAY
+    // #ifdef APP-VUE
+    registerAppVueFontFace(iconUrl, appVuePage);
+    // #endif
+    // #ifdef H5 || MP-WEIXIN || MP-ALIPAY
     uni.loadFontFace({
         global: true, // 是否全局生效。微信小程序 '2.10.0'起支持全局生效，需在 app.vue 中调用。
         family: iconFontFamily,
         source: 'url("' + iconUrl + '")',
         success() {
-            // #ifdef APP-VUE
-            appVueLoadingPages.delete(appVuePage);
-            appVueLoadedPages.add(appVuePage);
-            // #endif
             markFontLoaded();
             // console.log('内置字体图标加载成功');
         },
         fail() {
-            // #ifdef APP-VUE
-            appVueLoadingPages.delete(appVuePage);
-            // #endif
-            // #ifndef APP-VUE
             params.loading = false;
-            // #endif
             // console.error('内置字体图标加载出错');
         }
     });
+    // #endif
+    // #ifdef APP-VUE || H5 || MP-WEIXIN || MP-ALIPAY
     if (config.customIcon.family) {
         uni.loadFontFace({
             global: true, // 是否全局生效。微信小程序 '2.10.0'起支持全局生效，需在 app.vue 中调用。
@@ -144,14 +196,6 @@ const loadFont = () => {
         });
     }
     // #endif
-    // #ifdef APP-NVUE
-    // if (this.customFontFamily) {
-    //     domModule.addRule('fontFace', {
-    //         'fontFamily': `${this.customPrefix}-${this.customFontFamily}`,
-    //         'src': `url('${this.customFontUrl}')`
-    //     })
-    // }
-    // #endif
     return true;
 };
 

package/components/u-row-notice/u-row-notice.vue

@@ -127,7 +127,9 @@
 			// 文字内容的样式
 			textStyle() {
 				let style = {}
-				style.whiteSpace = 'nowrap !important'
+				// innerText把文本切分到多个text标签，切分点正好是空格时，nowrap会把它
+				// 当做行首/行尾空白丢弃，所以用pre保留原文空白，pre同样不会换行
+				style.whiteSpace = 'pre !important'
 				style.color = this.color
 				style.fontSize = addUnit(this.fontSize)
 				return style
@@ -312,7 +314,8 @@
 				// 这一句很重要，为了能让滚动左右连接起来
 				padding-left: 100%;
 				word-break: keep-all;
-				white-space: nowrap;
+				// pre而非nowrap：切分后的空格落在text首尾时不能被折叠掉
+				white-space: pre;
 				animation: u-loop-animation 10s linear infinite both;
 				/* #endif */
 				@include flex(row);

package/components/u-signature/u-signature.vue

@@ -10,6 +10,7 @@
 				@touchstart="touchStart" 
 				@touchmove="touchMove" 
 				@touchend="touchEnd"
+				@ready="onCanvasReady"
 				:disable-scroll="true"
 				class="u-signature__canvas"
 				:style="{
@@ -75,6 +76,7 @@
 
 <script>
 	import { t } from '../../libs/i18n'
+	import { upGetRect } from '../../libs/function/index.js'
 	export default {
 		name: 'u-signature',
 		props: {
@@ -132,9 +134,11 @@
 				],
 				showBrushSettings: false,
 				showColorSettings: false,
-				lastPoint: null, // 保存上一个点的坐标
-				canvasInstance: null // 缓存canvas实例
-			}
+			lastPoint: null, // 保存上一个点的坐标
+			canvasInstance: null, // 缓存canvas实例
+			canvasReady: false, // up-canvas 是否已完成初始化（APP/NVUE 需异步）
+			canvasRect: { left: 0, top: 0 } // 画布在视口中的位置，用于坐标换算
+		}
 		},
 		computed: {
 			resolvedBgColor() {
@@ -150,10 +154,9 @@
 			}
 		},
 		mounted() {
-			// 初始化时获取canvas实例
+			// 等待 up-canvas 完成初始化（APP / NVUE 画布上下文需异步就绪）
 			this.$nextTick(() => {
-				this.getCanvasInstance();
-				this.clearCanvas();
+				this.initCanvasInstance();
 			});
 		},
 		watch: {
@@ -192,110 +195,168 @@
 			},
 			
 			// 获取签名画布实例
-			getCanvasInstance() {
-				if (this.canvasInstance) {
-					return this.canvasInstance;
+		getCanvasInstance() {
+			if (this.canvasInstance) {
+				return this.canvasInstance;
+			}
+			
+			const canvasRef = this.$refs.signatureCanvas;
+			if (canvasRef) {
+				this.canvasInstance = canvasRef;
+				// 实例已就绪则同步标记，避免首笔被 touchStart 拦截
+				if (canvasRef.ctx) {
+					this.canvasReady = true;
 				}
-				
-				const canvasRef = this.$refs.signatureCanvas;
-				if (canvasRef) {
-					this.canvasInstance = canvasRef;
-					return canvasRef;
+				return canvasRef;
+			}
+			return null;
+		},
+
+		// 主动等待 up-canvas 完成初始化（部分平台画布上下文为异步）
+		async initCanvasInstance() {
+			const ref = this.getCanvasInstance();
+			if (!ref) return;
+			if (typeof ref.initCanvas === 'function') {
+				try {
+					const ok = await ref.initCanvas(true);
+					if (ok) {
+						this.onCanvasReady();
+						return;
+					}
+				} catch (e) {
+					// 忽略，等待 @ready 兜底
 				}
-				return null;
-			},
+			}
+			// 若 initCanvas 暂未就绪，up-canvas 的 @ready 事件会触发 onCanvasReady
+		},
+
+		// up-canvas 初始化完成回调（@ready 或 initCanvas 成功后触发）
+		onCanvasReady() {
+			if (this.canvasReady) return;
+			this.canvasReady = true;
+			this.getCanvasInstance();
+			this.refreshCanvasRect();
+			this.clearCanvas();
+		},
+
+		// 缓存画布在视口中的位置，用于将视口坐标换算为画布坐标
+		refreshCanvasRect() {
+			if (typeof upGetRect !== 'function') return;
+			upGetRect('#' + this.canvasId, false, this)
+				.then((rect) => {
+					if (rect && (rect.left || rect.top || rect.width)) {
+						this.canvasRect = {
+							left: rect.left || 0,
+							top: rect.top || 0
+						};
+					}
+				})
+				.catch(() => {});
+		},
 			
-			touchStart(e) {
-				if (!this.canvasInstance || !this.canvasInstance.ctx) {
-					this.getCanvasInstance();
+		touchStart(e) {
+			if (!this.canvasReady || !this.canvasInstance || !this.canvasInstance.ctx) {
+				// 画布尚未就绪：尝试初始化一次，待 @ready 后下一次触摸即可绘制
+				this.getCanvasInstance();
+				if (this.canvasInstance && typeof this.canvasInstance.initCanvas === 'function') {
+					this.canvasInstance.initCanvas(true)
+						.then(() => {
+							this.canvasReady = true;
+							this.refreshCanvasRect();
+						})
+						.catch(() => {});
 				}
-				
-				if (!this.canvasInstance || !this.canvasInstance.ctx) return;
-				
-				this.isDrawing = true;
-				this.isEmpty = false;
-				this.currentPath = [];
-				
-				const { x, y } = this.getCanvasPoint(e);
-				
-				// 设置线条样式
-				this.canvasInstance.setLineStyle(this.lineColor, this.lineWidth);
-				
-				// 开始路径
-				this.canvasInstance.beginPath();
-				this.canvasInstance.moveTo(x, y);
-				
-				// 记录起始点
-				this.currentPath.push({
-					x,
-					y,
-					type: 'start',
-					color: this.lineColor,
-					width: this.lineWidth
-				});
-				
-				// 保存上一个点
-				this.lastPoint = { x, y };
-				
-				// 阻止默认事件以提高性能
-				e.preventDefault();
-			},
+				return;
+			}
 			
-			touchMove(e) {
-				if (!this.isDrawing || !this.canvasInstance || !this.canvasInstance.ctx) return;
-				
-				// 阻止默认事件以提高性能
-				e.preventDefault();
-				
-				const { x, y } = this.getCanvasPoint(e);
-				
-				// 从上一个点画线到当前点
-				this.canvasInstance.lineTo(x, y);
-				this.canvasInstance.stroke(); // 实时绘制当前线段
-				this.currentPath.push({
-					x,
-					y,
-					type: 'move'
-				});
-				this.canvasInstance.draw(false);
-				
-				// 更新上一个点
-				this.lastPoint = { x, y };
-			},
+			this.isDrawing = true;
+			this.isEmpty = false;
+			this.currentPath = [];
 			
-			touchEnd(e) {
-				if (!this.isDrawing || !this.canvasInstance || !this.canvasInstance.ctx) return;
-				
-				this.isDrawing = false;
-				this.canvasInstance.closePath();
-				this.lastPoint = null;
-				
-				// 将当前路径加入栈中用于回退
-				if (this.currentPath.length > 0) {
-					this.pathStack.push([...this.currentPath]);
-				}
-				
-				// 最后统一执行一次绘制
-				this.canvasInstance.draw(true);
-			},
+			const { x, y } = this.getCanvasPoint(e);
 			
-			// 同步获取canvas坐标点（兼容处理）
-			getCanvasPoint(e) {
-				// #ifdef MP-WEIXIN
-				const touch = e.touches && e.touches[0] ? e.touches[0] : e.mp.touches[0];
-				// #endif
-				// #ifndef MP-WEIXIN
-				const touch = e.touches[0];
-				// #endif
-				
-				// 计算相对于canvas的坐标
-				// 由于无法直接获取canvas位置，这里简化处理
-				// 实际应用中可能需要通过uni.createSelectorQuery获取canvas位置
-				return {
-					x: touch.x,
-					y: touch.y
-				};
-			},
+			// 设置线条样式（每次起笔确保样式生效，兼容旧版 canvas 的 draw 后状态重置）
+			this.canvasInstance.setLineStyle(this.lineColor, this.lineWidth);
+			
+			// 仅记录起点，真正的绘制在 touchMove 中以“增量线段”方式完成
+			this.lastPoint = { x, y };
+			this.currentPath.push({
+				x,
+				y,
+				type: 'start',
+				color: this.lineColor,
+				width: this.lineWidth
+			});
+			
+			e.preventDefault();
+		},
+			
+		touchMove(e) {
+			if (!this.isDrawing || !this.canvasInstance || !this.canvasInstance.ctx) return;
+			
+			e.preventDefault();
+			
+			const { x, y } = this.getCanvasPoint(e);
+			
+			// 增量绘制：以上一个点为起点画到当前点。
+			// 旧版 canvas（APP-PLUS）每次 draw 会刷新命令队列，必须以“单段”方式绘制；
+			// 2D canvas 亦适用（draw 为 no-op，stroke 即时生效并保留已有像素）。
+			this.canvasInstance.setLineStyle(this.lineColor, this.lineWidth);
+			this.canvasInstance.beginPath();
+			this.canvasInstance.moveTo(this.lastPoint.x, this.lastPoint.y);
+			this.canvasInstance.lineTo(x, y);
+			this.canvasInstance.stroke();
+			this.canvasInstance.draw(true); // reserve：保留已绘制内容，避免笔迹闪退
+			
+			this.currentPath.push({
+				x,
+				y,
+				type: 'move'
+			});
+			this.lastPoint = { x, y };
+		},
+		
+		touchEnd(e) {
+			if (!this.isDrawing || !this.canvasInstance || !this.canvasInstance.ctx) return;
+			
+			this.isDrawing = false;
+			this.lastPoint = null;
+			
+			// 将当前路径加入栈中用于回退
+			if (this.currentPath.length > 0) {
+				this.pathStack.push([...this.currentPath]);
+			}
+			
+			// 收尾绘制（保留已有内容）
+			this.canvasInstance.draw(true);
+		},
+			
+		// 同步获取canvas坐标点（兼容各平台）
+		getCanvasPoint(e) {
+			const touch =
+				(e.touches && e.touches[0]) ||
+				(e.changedTouches && e.changedTouches[0]) ||
+				null;
+			if (!touch) return { x: 0, y: 0 };
+
+			// 2D canvas（MP/H5）与 NVUE webview 会在事件上直接挂载画布相对坐标
+			if (typeof touch.x === 'number' && typeof touch.y === 'number') {
+				return { x: touch.x, y: touch.y };
+			}
+
+			// 旧版 canvas（如 APP-PLUS）的 touch 仅提供视口坐标，需减去画布位置
+			const rect = this.canvasRect || { left: 0, top: 0 };
+			const clientX = touch.clientX !== undefined
+				? touch.clientX
+				: (touch.pageX !== undefined ? touch.pageX : 0);
+			const clientY = touch.clientY !== undefined
+				? touch.clientY
+				: (touch.pageY !== undefined ? touch.pageY : 0);
+			return {
+				x: clientX - rect.left,
+				y: clientY - rect.top
+			};
+		},
 			
 			// 选择颜色
 			selectColor(color) {

package/components/u-slider/props.js

@@ -42,7 +42,8 @@ export const props = defineMixin({
         // 双滑块时值
         rangeValue: {
             type: [Array],
-            default: [0, 0]
+            // 必须用工厂函数，否则所有实例共用同一个数组
+            default: () => [0, 0]
         },
         // 滑块右侧已选择部分的背景色
         activeColor: {

package/components/u-slider/u-slider.vue

@@ -126,7 +126,7 @@
 	export default {
 		name: 'u-slider',
 		mixins: [mpMixin, mixin, props],
-		emits: ["start", "changing", "change", "update:modelValue"],
+		emits: ["start", "changing", "change", "update:modelValue", "update:rangeValue"],
 		data() {
 			return {
 				startX: 0,
@@ -462,8 +462,14 @@
 				}
 				// 修改value值
 				if (this.isRange) {
-					this.rangeValue[index] = valueFormat;
-					this.$emit("update:modelValue", this.rangeValue);
+					// 值没有变化时不再抛出事件，避免父级对数组做拷贝或归一化时形成更新回环
+					if (this.rangeValue[index] !== valueFormat) {
+						this.rangeValue[index] = valueFormat;
+						// 区间模式由rangeValue双向绑定，必须抛出update:rangeValue，v-model:rangeValue才能生效
+						this.$emit("update:rangeValue", this.rangeValue);
+						// 兼容此前监听update:modelValue获取区间值的用法
+						this.$emit("update:modelValue", this.rangeValue);
+					}
 				} else {
 					// #ifdef VUE3
 					this.$emit("update:modelValue", valueFormat);

package/libs/function/throttle.js

@@ -8,8 +8,12 @@ let flag;
  * @param {Boolean} immediate 是否立即执行
  * @return null
  */
-export function throttle(func, wait = 500, immediate = true) {
-    if (immediate) {
+export function throttle(func, wait = 500, immediate = true) {
+    if (wait <= 0) {
+        typeof func === 'function' && func()
+        return
+    }
+    if (immediate) {
         if (!flag) {
             flag = true
             // 如果是立即执行，则在wait毫秒内开始时执行