uview-plus 3.8.120 → 3.8.125

package/changelog.md

@@ -1,3 +1,48 @@
+## 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-- 前缀
 
@@ -2736,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毫秒内开始时执行

package/libs/root/index.js

@@ -1,21 +1,17 @@
 import { dirname, relative, resolve } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import process from 'node:process'
-import { copyFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from 'node:fs'
+import { existsSync, mkdirSync, statSync, writeFileSync } from 'node:fs'
 
 import { createFilter, normalizePath } from 'vite'
 
 import { transformNvuePage, transformPage } from './page.js'
 import { rebuildUpApp, registerUpApp } from './root.js'
 import { loadPagesJson, normalizePlatformPath, toArray } from './utils.js'
+import { createAppIconFontFeature } from '../vite/app-icon-font.js'
+import { detectProjectRoot } from '../vite/utils.js'
 
 const rootLibPath = normalizePath(dirname(fileURLToPath(import.meta.url)))
-const appStaticIconFontRelativePath = 'static/app-plus/uview-plus/upicon.ttf'
-const appStaticIconFontFlag = 'const useAppStaticIconFont = false;'
-const appStaticIconFontEnabledFlag = 'const useAppStaticIconFont = true;'
-const appRemoteIconFontCondition = /\/\*\s*#ifdef\s+APP\s+\|\|\s+(MP-QQ\s+\|\|\s+MP-TOUTIAO\s+\|\|\s+MP-BAIDU\s+\|\|\s+MP-KUAISHOU\s+\|\|\s+MP-XHS)\s*\*\//
-const appCompiledRemoteIconFontFace = /[ \t]*(?:\/\/[^\n]*\n[ \t]*)?@font-face\s*\{[^{}]*font-family:\s*['"]?uicon-iconfont['"]?;?[^{}]*at\.alicdn\.com\/t\/font_2225171[^{}]*\}\s*/
-const appCompiledRemoteIconFontFaceGlobal = /[ \t]*(?:\/\/[^\n]*\n[ \t]*)?@font-face\s*\{[^{}]*font-family:\s*['"]?uicon-iconfont['"]?;?[^{}]*at\.alicdn\.com\/t\/font_2225171[^{}]*\}\s*/g
 
 export default function UniUpRoot(options = {}) {
   const rootOptions = {
@@ -28,41 +24,12 @@ export default function UniUpRoot(options = {}) {
   }
   const rootFileName = String(rootOptions.rootFileName || 'App.up').replace(/\.vue$/i, '')
 
-  const detectProjectRoot = () => {
-    const cwd = normalizePath(process.env.INIT_CWD || process.cwd())
-    const envInputDir = process.env.UNI_INPUT_DIR ? normalizePath(process.env.UNI_INPUT_DIR) : ''
-    const cliRootPath = normalizePath(resolve(cwd, 'src'))
-    const hbuilderRootPath = cwd
-
-    const isPageRoot = (path) => existsSync(resolve(path, 'pages.json'))
-
-    if (envInputDir && isPageRoot(envInputDir)) {
-      const projectType = envInputDir.endsWith('/src') ? 'cli' : 'hbuilder'
-      return { rootPath: envInputDir, projectType }
-    }
-
-    if (isPageRoot(cliRootPath)) {
-      return { rootPath: cliRootPath, projectType: 'cli' }
-    }
-
-    if (isPageRoot(hbuilderRootPath)) {
-      return { rootPath: hbuilderRootPath, projectType: 'hbuilder' }
-    }
-
-    return {
-      rootPath: envInputDir || cliRootPath,
-      projectType: envInputDir && !envInputDir.endsWith('/src') ? 'hbuilder' : 'cli',
-    }
-  }
-
   const projectInfo = detectProjectRoot()
   const rootPath = normalizePath(projectInfo.rootPath)
+  // App 本地图标字体与 Root 组件无关，这里复用 UniUp 的同一个 feature，保持老项目行为不变
+  const appIconFont = createAppIconFontFeature({ enabled: rootOptions.appStaticIconFont !== false })
   const appUpPath = normalizePath(resolve(rootPath, `${rootFileName}.vue`))
   const rootToastHostPath = normalizePath(resolve(rootLibPath, 'root-toast-host.vue'))
-  const iconFontSourcePath = normalizePath(resolve(rootLibPath, '../../components/u-icon/upicon.ttf'))
-  const appStaticIconFontPath = normalizePath(resolve(rootPath, appStaticIconFontRelativePath))
-  const uIconUtilPath = normalizePath(resolve(rootPath, 'uni_modules/uview-plus/components/u-icon/util.js'))
-  const uIconVuePath = normalizePath(resolve(rootPath, 'uni_modules/uview-plus/components/u-icon/u-icon.vue'))
   const themeRuntimePath = normalizePath(resolve(rootPath, 'uni_modules/uview-plus/libs/theme/runtime.js'))
   const pagesPath = normalizePath(resolve(rootPath, 'pages.json'))
   const excludedPaths = toArray(rootOptions.excludePages)
@@ -99,51 +66,6 @@ export default function UniUpRoot(options = {}) {
     writeFileSync(appUpPath, defaultRootSfc, 'utf-8')
   }
 
-  const shouldCopyFile = (sourcePath, targetPath) => {
-    if (!existsSync(targetPath)) return true
-    if (statSync(sourcePath).size !== statSync(targetPath).size) return true
-    return !readFileSync(sourcePath).equals(readFileSync(targetPath))
-  }
-
-  const ensureAppStaticIconFont = () => {
-    if (process.env.UNI_PLATFORM !== 'app') return
-    if (!existsSync(iconFontSourcePath)) {
-      throw new Error(`uview-plus built-in icon font is missing: ${iconFontSourcePath}`)
-    }
-
-    mkdirSync(dirname(appStaticIconFontPath), { recursive: true })
-    if (shouldCopyFile(iconFontSourcePath, appStaticIconFontPath)) {
-      copyFileSync(iconFontSourcePath, appStaticIconFontPath)
-    }
-  }
-
-  const removeAppCompiledRemoteIconFontFace = (code) => code.replace(appCompiledRemoteIconFontFaceGlobal, '')
-
-  const transformAppStaticIconFont = (code, cleanId) => {
-    if (process.env.UNI_PLATFORM !== 'app') return null
-    if (cleanId === uIconUtilPath && code.includes(appStaticIconFontFlag)) {
-      return code.replace(appStaticIconFontFlag, appStaticIconFontEnabledFlag)
-    }
-    if (cleanId === uIconVuePath && appRemoteIconFontCondition.test(code)) {
-      return code.replace(appRemoteIconFontCondition, '/* #ifdef $1 */')
-    }
-    if (cleanId === uIconVuePath && appCompiledRemoteIconFontFace.test(code)) {
-      return removeAppCompiledRemoteIconFontFace(code)
-    }
-    return null
-  }
-
-  const removeAppRemoteIconFontFaceFromCssAssets = (bundle) => {
-    if (process.env.UNI_PLATFORM !== 'app') return
-    Object.values(bundle).forEach((asset) => {
-      if (asset.type !== 'asset') return
-      if (!asset.fileName.endsWith('.css')) return
-      if (typeof asset.source !== 'string') return
-      if (!appCompiledRemoteIconFontFace.test(asset.source)) return
-      asset.source = removeAppCompiledRemoteIconFontFace(asset.source)
-    })
-  }
-
   const refreshPagesJson = () => {
     if (!existsSync(pagesPath)) return
     const mtimeMs = statSync(pagesPath).mtimeMs
@@ -164,7 +86,7 @@ export default function UniUpRoot(options = {}) {
       }
     },
     buildStart() {
-      ensureAppStaticIconFont()
+      appIconFont.ensure()
       ensureRootFile()
       refreshPagesJson()
     },
@@ -173,7 +95,7 @@ export default function UniUpRoot(options = {}) {
       const isSfcBlock = id.includes('?')
       const cleanId = normalizePath(id.split('?')[0])
 
-      const iconFontCode = transformAppStaticIconFont(code, cleanId)
+      const iconFontCode = appIconFont.transform(code, cleanId)
       if (iconFontCode) {
         return {
           code: iconFontCode,
@@ -218,7 +140,7 @@ export default function UniUpRoot(options = {}) {
       return null
     },
     generateBundle(_, bundle) {
-      removeAppRemoteIconFontFaceFromCssAssets(bundle)
+      appIconFont.generateBundle(bundle)
     },
   }
 }

package/libs/vite/app-icon-font.js

@@ -0,0 +1,93 @@
+import { dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { copyFileSync, existsSync, mkdirSync, readFileSync, statSync } from 'node:fs'
+
+import { detectProjectRoot, isAppPlatform, normalizePath, toCleanId } from './utils.js'
+
+const featurePath = normalizePath(dirname(fileURLToPath(import.meta.url)))
+export const appStaticIconFontRelativePath = 'static/app-plus/uview-plus/upicon.ttf'
+// 源码默认 App 端优先本地字体，只有在显式关闭本地字体时才切回 config.iconUrl
+// 不带分号，兼容有/无分号两种代码风格
+const appStaticIconFontFlag = 'const useAppStaticIconFont = true'
+const appStaticIconFontDisabledFlag = 'const useAppStaticIconFont = false'
+const appRemoteIconFontCondition = /\/\*\s*#ifdef\s+APP\s+\|\|\s+(MP-QQ\s+\|\|\s+MP-TOUTIAO\s+\|\|\s+MP-BAIDU\s+\|\|\s+MP-KUAISHOU\s+\|\|\s+MP-XHS)\s*\*\//
+const appCompiledRemoteIconFontFace = /[ \t]*(?:\/\/[^\n]*\n[ \t]*)?@font-face\s*\{[^{}]*font-family:\s*['"]?uicon-iconfont['"]?;?[^{}]*at\.alicdn\.com\/t\/font_2225171[^{}]*\}\s*/
+const appCompiledRemoteIconFontFaceGlobal = /[ \t]*(?:\/\/[^\n]*\n[ \t]*)?@font-face\s*\{[^{}]*font-family:\s*['"]?uicon-iconfont['"]?;?[^{}]*at\.alicdn\.com\/t\/font_2225171[^{}]*\}\s*/g
+
+/**
+ * App 本地图标字体能力（UniUp 的一个 feature）。
+ *
+ * 与 Root 组件无关：App / App-nvue 默认优先加载随包分发的 static 字体，
+ * 但字体文件必须由构建插件复制到应用 static 目录，本 feature 负责这件事，
+ * 并在 App 构建时移除远程 CSS 字体，避免本地字体与远程字体同时加载。
+ */
+export function createAppIconFontFeature(options = {}) {
+  const enabled = options.enabled !== false
+  const projectInfo = detectProjectRoot()
+  const rootPath = normalizePath(projectInfo.rootPath)
+  const iconFontSourcePath = normalizePath(resolve(featurePath, '../../components/u-icon/upicon.ttf'))
+  const appStaticIconFontPath = normalizePath(resolve(rootPath, appStaticIconFontRelativePath))
+  const uIconUtilPath = normalizePath(resolve(rootPath, 'uni_modules/uview-plus/components/u-icon/util.js'))
+  const uIconVuePath = normalizePath(resolve(rootPath, 'uni_modules/uview-plus/components/u-icon/u-icon.vue'))
+
+  const shouldCopyFile = (sourcePath, targetPath) => {
+    if (!existsSync(targetPath)) return true
+    if (statSync(sourcePath).size !== statSync(targetPath).size) return true
+    return !readFileSync(sourcePath).equals(readFileSync(targetPath))
+  }
+
+  const removeAppCompiledRemoteIconFontFace = (code) => code.replace(appCompiledRemoteIconFontFaceGlobal, '')
+
+  const ensure = () => {
+    if (!enabled) return
+    if (!isAppPlatform()) return
+    if (!existsSync(iconFontSourcePath)) {
+      throw new Error(`uview-plus built-in icon font is missing: ${iconFontSourcePath}`)
+    }
+
+    mkdirSync(dirname(appStaticIconFontPath), { recursive: true })
+    if (shouldCopyFile(iconFontSourcePath, appStaticIconFontPath)) {
+      copyFileSync(iconFontSourcePath, appStaticIconFontPath)
+    }
+  }
+
+  const transform = (code, id) => {
+    if (!isAppPlatform()) return null
+    const cleanId = toCleanId(id)
+    if (!enabled) {
+      if (cleanId === uIconUtilPath && code.includes(appStaticIconFontFlag)) {
+        return code.replace(appStaticIconFontFlag, appStaticIconFontDisabledFlag)
+      }
+      return null
+    }
+    if (cleanId === uIconVuePath && appRemoteIconFontCondition.test(code)) {
+      return code.replace(appRemoteIconFontCondition, '/* #ifdef $1 */')
+    }
+    if (cleanId === uIconVuePath && appCompiledRemoteIconFontFace.test(code)) {
+      return removeAppCompiledRemoteIconFontFace(code)
+    }
+    return null
+  }
+
+  const generateBundle = (bundle) => {
+    if (!enabled) return
+    if (!isAppPlatform()) return
+    Object.values(bundle).forEach((asset) => {
+      if (asset.type !== 'asset') return
+      if (!asset.fileName.endsWith('.css')) return
+      if (typeof asset.source !== 'string') return
+      if (!appCompiledRemoteIconFontFace.test(asset.source)) return
+      asset.source = removeAppCompiledRemoteIconFontFace(asset.source)
+    })
+  }
+
+  return {
+    name: 'app-icon-font',
+    enabled,
+    rootPath,
+    appStaticIconFontPath,
+    ensure,
+    transform,
+    generateBundle,
+  }
+}

package/libs/vite/index.js

@@ -0,0 +1,50 @@
+import { createAppIconFontFeature } from './app-icon-font.js'
+
+/**
+ * uview-plus 通用 Vite 插件（统一入口）。
+ *
+ * 设计约定：
+ * - 用户只需要在 vite.config 里注册一次 `UpVite()`，之后组件库新增任何构建期能力
+ *   都在这里追加 feature，用户不需要改自己的配置。
+ * - 每个 feature 是一个对象，按需实现以下钩子（都可选）：
+ *     { name, ensure(), transform(code, id), generateBundle(bundle) }
+ *   `ensure()` 对应 buildStart，`transform` 返回改写后的源码字符串或 null。
+ *
+ * 用法：
+ *   import UpVite from 'uview-plus/libs/vite/index.js'
+ *   export default defineConfig({ plugins: [UpVite(), uni()] })
+ */
+export function createUpViteFeatures(options = {}) {
+  return [
+    // App 端本地图标字体：把内置 upicon.ttf 复制到 static 并移除 App 远程 @font-face
+    createAppIconFontFeature({ enabled: options.appStaticIconFont !== false }),
+    // 后续新增构建期能力在此追加，保持对用户的配置零改动
+  ]
+}
+
+export default function UpVite(options = {}) {
+  const features = createUpViteFeatures(options)
+
+  return {
+    name: 'vite-plugin-up-vite',
+    enforce: 'pre',
+    buildStart() {
+      features.forEach(feature => feature.ensure?.())
+    },
+    transform(code, id) {
+      for (const feature of features) {
+        const transformed = feature.transform?.(code, id)
+        if (transformed) {
+          return {
+            code: transformed,
+            map: null,
+          }
+        }
+      }
+      return null
+    },
+    generateBundle(_, bundle) {
+      features.forEach(feature => feature.generateBundle?.(bundle))
+    },
+  }
+}

package/libs/vite/utils.js

@@ -0,0 +1,48 @@
+import { existsSync } from 'node:fs'
+import { resolve } from 'node:path'
+import process from 'node:process'
+
+/**
+ * 统一为正斜杠路径。
+ *
+ * 这里刻意不 import vite 的 normalizePath —— 让 libs/vite 目录保持自包含，
+ * 宿主项目不一定装了 vite 包（HBuilderX 项目走 HBuilderX 内置构建）。
+ */
+export const normalizePath = (path) => {
+  if (!path) return ''
+  return String(path).replace(/\\/g, '/')
+}
+
+/**
+ * 识别宿主项目根目录，同时兼容 CLI 项目与 HBuilderX 项目。
+ */
+export function detectProjectRoot() {
+  const cwd = normalizePath(process.env.INIT_CWD || process.cwd())
+  const envInputDir = process.env.UNI_INPUT_DIR ? normalizePath(process.env.UNI_INPUT_DIR) : ''
+  const cliRootPath = normalizePath(resolve(cwd, 'src'))
+  const hbuilderRootPath = cwd
+
+  const isPageRoot = (path) => existsSync(resolve(path, 'pages.json'))
+
+  if (envInputDir && isPageRoot(envInputDir)) {
+    const projectType = envInputDir.endsWith('/src') ? 'cli' : 'hbuilder'
+    return { rootPath: envInputDir, projectType }
+  }
+
+  if (isPageRoot(cliRootPath)) {
+    return { rootPath: cliRootPath, projectType: 'cli' }
+  }
+
+  if (isPageRoot(hbuilderRootPath)) {
+    return { rootPath: hbuilderRootPath, projectType: 'hbuilder' }
+  }
+
+  return {
+    rootPath: envInputDir || cliRootPath,
+    projectType: envInputDir && !envInputDir.endsWith('/src') ? 'hbuilder' : 'cli',
+  }
+}
+
+export const isAppPlatform = () => process.env.UNI_PLATFORM === 'app'
+
+export const toCleanId = (id) => normalizePath(String(id).split('?')[0])

package/package.json

@@ -2,7 +2,7 @@
   "id": "uview-plus",
   "name": "uview-plus",
   "displayName": "零云®uview-plus3.0重磅发布，全面的Vue3鸿蒙跨端移动组件库，组件丰富维护更新稳定。",
-  "version": "3.8.120",
+  "version": "3.8.125",
   "description": "零云®uview-plus已兼容vue3支持多语言，120+全面的组件和便捷的工具会让您信手拈来。近期新增拖动排序、条码、图片裁剪、下拉刷新、虚拟列表、签名、Markdown等。",
   "keywords": [
     "uview",

package/types/comps/slider.d.ts

@@ -51,6 +51,21 @@ declare interface SliderProps {
    * 滑块按钮自定义样式
    */
   blockStyle?: unknown
+  /**
+   * 是否区间模式（双滑块）
+   * @default false
+   */
+  isRange?: boolean
+  /**
+   * 区间模式下的取值，支持 v-model:rangeValue 双向绑定
+   * @default [0, 0]
+   */
+  rangeValue?: (string | number)[]
+  /**
+   * 区间模式下更新 v-model:rangeValue
+   * @param value 当前区间值
+   */
+  "onUpdate:rangeValue"?: (value: (string | number)[]) => any
   /**
    * 更新v-model的
    * @param value 当前值