uview-plus 3.8.113 → 3.8.117

package/changelog.md

@@ -1,3 +1,59 @@
+## 3.8.117
+fix: 修复瀑布流分发锁死、u-image 置于 u-swiper 内无法滑动、u-list-item 挂载竞态
+
+本版为三个问题的集中修复，均不涉及组件 API 变更。
+
+fix: 修复 u-waterfall 在 App 切换 tabbar 后不再消费新数据（#1056）
+
+App 端切换 tabbar 时，原生层会挂起隐藏页面的 setTimeout，`await sleep()` 永不 resolve，`runDistributionQueue` 的 finally 块无法执行，`distributionRunning` 永久为 true；切回页面后新数据只能入队，永远不会被分发。
+
+- `clear()` 强制重置 `distributionRunning` 与 `distributionPromise`
+- `redistributeData()` 在调用 clear 之前先解锁
+- 新增 `verify:waterfall-lock-reset` 回归校验
+
+fix: 修复 u-image 置于 u-swiper 内导致手势滑动失效（#894）
+
+u-transition 根节点绑定的 `@touchmove="noop"` 会执行 `e.stopPropagation()`，使 touchmove 无法冒泡到父级；u-image 以 u-transition 作为根节点，放进 u-swiper 的 slot 后 swiper 收不到 touchmove，滑动手势失效。该拦截对淡入、滑入等过渡动画本身没有作用，仅会阻断父组件的正常手势，故直接移除。
+
+fix: 修复 u-list-item 在 parent 未初始化时调用 updateOffsetFromChild 报错（#875）
+
+列表数据由后台异步返回、u-list-item 数量随之变化时，`uList.innerScrollTop` 的 watch 可能在 `mounted()` 之前触发；此时 `this.parent` 仍是 `created()` 中赋值的空对象，调用 `this.parent.updateOffsetFromChild` 会抛出 "is not a function"。
+
+- watch 回调中增加守卫，parent 未就绪时直接返回
+- 新增 `verify:list-item-parent-race` 回归校验
+
+## 3.8.116
+fix: 修复组件卸载后查询节点导致 APP 与鸿蒙端报错（#1057）
+
+页面切换时 APP 与鸿蒙端会出现大面积 `Uncaught TypeError: Cannot read properties of undefined (reading '$') at uni-app-view.umd.js`，功能不受影响但日志被淹没，H5 端不出现。
+
+原因是组件卸载后仍在执行的异步回调继续发起节点查询：APP 端 service 层取的是已失效的 `$el.nodeId`，视图层按该 id 查映射表时，对应条目在元素移除时已被删除，读到 undefined 再取 `.$` 即抛错。H5 端直接取 `$el`，没有这层 nodeId 映射，因此不复现。
+
+- 在 `upGetRect` 与 `upCreateIntersectionObserver` 中集中拦截，覆盖全部三十余处调用方，卸载后不再把组件交给原生查询
+- 卸载后 `upGetRect` 返回零尺寸节点信息，`upCreateIntersectionObserver` 返回空观察器，均保持原有调用形态，不需要调用方改写
+- 卸载标记由公共 mixin 的 `beforeUnmount` 同步置位，早于 Vue 内部异步置位的 `isUnmounted`；未套用公共 mixin 的组件退回 Vue 自身标记
+- 守卫置于条件编译之外，确保 app-harmony 端同样生效
+- 新增 `verify:unmounted-node-query` 回归校验，同时断言挂载期间必须正常发起查询、卸载后必须完全不发起，并逐平台校验守卫存在
+
+该问题在 tabs、sticky、subsection、waterfall、index-list 等所有依赖节点测量的组件上成因相同，本次为统一修复。
+
+## 3.8.115
+feat: u-select 遮罩默认可见并支持点击遮罩关闭开关
+
+- overlayOpacity 默认由 0.01 调整为 0.3，遮罩真正可见，仍比 up-overlay 自身的 0.5 更浅
+- overlayOpacity 类型放宽为 String / Number，可直接以普通属性方式传值
+- 展开状态下把触发区抬到遮罩之上，避免下拉面板亮着而它的锚点被压暗
+- 新增 closeOnClickOverlay 属性（默认 true），与 u-popup 命名一致；此前点击遮罩关闭为硬编码行为，现在可显式禁用
+- 遮罩标签统一为 up-overlay，并补充 verify:select-overlay 回归校验
+
+nvue 端对 z-index 支持有限，若被忽略则触发区可能落在遮罩之下，该端建议按需关闭 overlay。
+
+## 3.8.114
+fix: 修复 tabbar 中间按钮圆弧越界（#1052）
+
+- 根据 tabbar 与中间按钮的实际位置计算圆弧裁剪高度
+- 兼容文字、偏移、边框和动画场景，并补充回归校验
+
 ## 3.8.113（2026-08-27）
 fix: 修复启用uniUpRoot，在root组件存在components选项时组件插入错误
 

package/components/u-cascader/u-cascader.vue

@@ -348,7 +348,7 @@
 		overflow: hidden;
 		height: 800rpx;
 
-		>view {
+		>.u-flex {
 			width: 150%;
 			transition: transform 0.3s ease-in-out 0s;
 			transform: translateX(0);

package/components/u-cropper/u-cropper.vue

@@ -7,25 +7,25 @@
 		<view class="oper-wrapper" :style="{ display: styleDisplay }">
 			<view class="oper">
 				<view class="btn-wrapper" v-if="showOper">
-					<view @click="select" hover-class="hover" :style="{ width: btnWidth }">
+					<view class="u-cropper__action" @click="select" hover-class="hover" :style="{ width: btnWidth }">
 						<text>{{ t("up.common.re-select") }}</text>
 					</view>
-					<view @click="close" hover-class="hover" :style="{ width: btnWidth }">
+					<view class="u-cropper__action" @click="close" hover-class="hover" :style="{ width: btnWidth }">
 						<text>{{ t("up.common.close") }}</text>
 					</view>
-					<view @click="rotate" hover-class="hover" :style="{ width: btnWidth, display: btnDsp }">
+					<view class="u-cropper__action" @click="rotate" hover-class="hover" :style="{ width: btnWidth, display: btnDsp }">
 						<text>{{ t("up.common.rotate") }}</text>
 					</view>
-					<view @click="preview" hover-class="hover" :style="{ width: btnWidth }">
+					<view class="u-cropper__action" @click="preview" hover-class="hover" :style="{ width: btnWidth }">
 						<text>{{ t("up.common.preview") }}</text>
 					</view>
-					<view @click="confirm" hover-class="hover" :style="{ width: btnWidth }">
+					<view class="u-cropper__action" @click="confirm" hover-class="hover" :style="{ width: btnWidth }">
 						<text>{{ t("up.common.confirm") }}</text>
 					</view>
 				</view>
 				<view class="clr-wrapper" v-else>
 					<slider class="my-slider" @change="colorChange" block-size="25" value="0" min="-100" max="100" activeColor="red" backgroundColor="green" block-color="grey" show-value></slider>
-					<view @click="prvUpload" hover-class="hover" :style="{ width: btnWidth }">
+					<view class="u-cropper__action" @click="prvUpload" hover-class="hover" :style="{ width: btnWidth }">
 						<text>{{ t("up.common.confirm") }}</text>
 					</view>
 				</view>
@@ -1267,7 +1267,7 @@
 			justify-content: space-between;
 		}
 
-		.btn-wrapper view {
+		.btn-wrapper .u-cropper__action {
 			display: flex;
 			align-items: center;
 			justify-content: center;
@@ -1288,7 +1288,7 @@
 			flex-grow: 1;
 		}
 
-		.clr-wrapper view {
+		.clr-wrapper .u-cropper__action {
 			display: flex;
 			align-items: center;
 			justify-content: center;

package/components/u-float-button/u-float-button.vue

@@ -159,7 +159,7 @@ export default {
         bottom: 0px;
         display: flex;
         flex-direction: column;
-        >view {
+        >.u-float-button__item {
             margin: 5px 0px;
         }
     }

package/components/u-goods-sku/u-goods-sku.vue

@@ -16,7 +16,7 @@
                 <view class="up-goods-sku__header">
                     <slot name="header">
                         <view class="up-goods-sku__header__image">
-                            <image :src="goodsInfo.image || goodsInfo.picture" mode="aspectFill"></image>
+                            <image class="up-goods-sku__header__image-element" :src="goodsInfo.image || goodsInfo.picture" mode="aspectFill"></image>
                         </view>
                         <view class="up-goods-sku__header__info">
                             <view class="up-goods-sku__header__info__price">
@@ -333,7 +333,7 @@
 				overflow: hidden;
 				margin-right: 20rpx;
 				
-				image {
+				&-element {
 					width: 100%;
 					height: 100%;
 				}

package/components/u-list-item/u-list-item.vue

@@ -49,6 +49,10 @@
 		watch: {
 			// #ifndef APP-NVUE
 			'uList.innerScrollTop'(n) {
+				// 确保parent已正确初始化，避免在mounted之前触发watch导致报错
+				if (!this.parent || !this.parent.updateOffsetFromChild) {
+					return
+				}
 				const preLoadScreen = this.uList.preLoadScreen
 				const windowHeight = this.sys.windowHeight
 				if(n <= windowHeight * preLoadScreen) {

package/components/u-navbar/theme-vars.scss

@@ -1,3 +1,16 @@
+/* #ifdef MP-WEIXIN */
+:host {
+	--up-navbar-bg-color: #ffffff;
+}
+
+@media (prefers-color-scheme: dark) {
+	:host {
+		--up-navbar-bg-color: #1c1c1e;
+	}
+}
+/* #endif */
+
+/* #ifndef MP-WEIXIN */
 :root,
 page,
 body {
@@ -24,3 +37,4 @@ body {
 	--up-navbar-bg-color: #1c1c1e;
 	--up-navbar-glass-bg-color: rgba(28, 28, 30, 0.82);
 }
+/* #endif */

package/components/u-notice-bar/theme-vars.scss

@@ -1,3 +1,18 @@
+/* #ifdef MP-WEIXIN */
+:host {
+	--up-notice-bar-color: #f9ae3d;
+	--up-notice-bar-bg-color: #fdf6ec;
+}
+
+@media (prefers-color-scheme: dark) {
+	:host {
+		--up-notice-bar-color: #f9ae3d;
+		--up-notice-bar-bg-color: #3d2f1b;
+	}
+}
+/* #endif */
+
+/* #ifndef MP-WEIXIN */
 :root,
 page,
 body {
@@ -23,3 +38,4 @@ body {
 	--up-notice-bar-color: #f9ae3d;
 	--up-notice-bar-bg-color: #3d2f1b;
 }
+/* #endif */

package/components/u-parse/node/node.vue

@@ -53,14 +53,14 @@
       <!-- #endif -->
       <view v-else-if="(n.name==='table'&&n.c)||n.name==='li'" :id="n.attrs.id" :class="'_'+n.name+' '+n.attrs.class" :style="n.attrs.style">
         <node v-if="n.name==='li'" :childs="n.children" :opts="opts" />
-        <view v-else v-for="(tbody, x) in n.children" v-bind:key="x" :class="'_'+tbody.name+' '+tbody.attrs.class" :style="tbody.attrs.style">
+        <view v-else v-for="(tbody, x) in (n && n.children || [])" v-bind:key="x" :class="'_'+tbody.name+' '+tbody.attrs.class" :style="tbody.attrs.style">
           <node v-if="tbody.name==='td'||tbody.name==='th'" :childs="tbody.children" :opts="opts" />
-          <block v-else v-for="(tr, y) in tbody.children" v-bind:key="y">
+          <block v-else v-for="(tr, y) in (tbody && tbody.children || [])" v-bind:key="y">
             <view v-if="tr.name==='td'||tr.name==='th'" :class="'_'+tr.name+' '+tr.attrs.class" :style="tr.attrs.style">
               <node :childs="tr.children" :opts="opts" />
             </view>
             <view v-else :class="'_'+tr.name+' '+tr.attrs.class" :style="tr.attrs.style">
-              <view v-for="(td, z) in tr.children" v-bind:key="z" :class="'_'+td.name+' '+td.attrs.class" :style="td.attrs.style">
+              <view v-for="(td, z) in (tr && tr.children || [])" v-bind:key="z" :class="'_'+td.name+' '+td.attrs.class" :style="td.attrs.style">
                 <node :childs="td.children" :opts="opts" />
               </view>
             </view>
@@ -70,7 +70,7 @@
       <!-- insert -->
       <!-- 富文本 -->
       <!-- #ifdef H5 || ((MP-WEIXIN || MP-QQ || APP-PLUS || MP-360) && VUE2) -->
-      <rich-text v-else-if="!n.c&&!handler.isInline(n.name, n.attrs.style)" :id="n.attrs.id" :style="n.f" :user-select="opts[4]" :nodes="[n]" />
+      <rich-text v-else-if="!n.c&&!isInlineTag(n.name, n.attrs.style)" :id="n.attrs.id" :style="n.f" :user-select="opts[4]" :nodes="[n]" />
       <!-- #endif -->
       <!-- #ifndef H5 || ((MP-WEIXIN || MP-QQ || APP-PLUS || MP-360) && VUE2) -->
       <rich-text v-else-if="!n.c" :id="n.attrs.id" :style="'display:inline;'+n.f" :preview="false" :selectable="opts[4]" :user-select="opts[4]" :nodes="[n]" />
@@ -185,6 +185,25 @@ export default {
     // #ifdef MP-WEIXIN
     toJSON () { return this },
     // #endif
+    isInlineTag (tagName, style) {
+      return {
+        abbr: true,
+        b: true,
+        big: true,
+        code: true,
+        del: true,
+        em: true,
+        i: true,
+        ins: true,
+        label: true,
+        q: true,
+        small: true,
+        span: true,
+        strong: true,
+        sub: true,
+        sup: true
+      }[tagName] || (style || '').indexOf('display:inline') !== -1
+    },
     /**
      * @description 规范化链接地址
      * @param {any} href

package/components/u-select/u-select.vue

@@ -1,7 +1,7 @@
 <template>
 	<view class="u-select">
 		<view :class="['u-select__content', disabled && 'disabled']">
-			<view :class="['u-select__label', border && 'u-select__label--border']" :style="selectLabelStyle" @click="openSelect">
+			<view :class="['u-select__label', border && 'u-select__label--border']" :style="selectLabelStyle" @click="labelClick">
 				<slot name="text" :currentLabel="currentLabel">
 					<text class="u-select__text" :style="{ color: resolvedTextColor }" v-if="showOptionsLabel">
 						{{ currentLabel }}
@@ -14,8 +14,8 @@
 					<up-icon name="arrow-down" :size="iconSize" :color="resolvedIconColor"></up-icon>
 				</slot>
 			</view>
-			<u-overlay :show="isOpen" @click="overlayClick" v-if="overlay" :zIndex="zIndex" :duration="duration + 50"
-				:customStyle="overlayStyle" :opacity="overlayOpacity" @touchmove.stop.prevent="noop"></u-overlay>
+			<up-overlay :show="isOpen" @click="overlayClick" v-if="overlay" :zIndex="zIndex" :duration="duration + 50"
+				:customStyle="overlayStyle" :opacity="overlayOpacity" @touchmove.stop.prevent="noop"></up-overlay>
 			<view class="u-select__options__wrap" :style="optionsWrapStyle">
 				<view class="u-select__options" :style="optionsStyle" v-if="isOpen">
 					<slot name="options">
@@ -59,8 +59,8 @@
 				default: true
 			},
 			overlayOpacity: {
-				type: Number,
-				default: 0.01
+				type: [String, Number],
+				default: 0.3
 			},
 			overlayStyle: {
 				type: Object,
@@ -68,6 +68,11 @@
 					return {}
 				}
 			},
+			// 点击遮罩是否关闭下拉面板
+			closeOnClickOverlay: {
+				type: Boolean,
+				default: true
+			},
 			duration: {
 				type: Number,
 				default: 300
@@ -157,11 +162,17 @@
 				return this.optionsWidth;
 			},
 			selectLabelStyle() {
-				if (!this.border) return {};
-				return {
-					borderColor: this.upThemeVar('--up-border-color', '#dadbde'),
-					backgroundColor: this.upThemeVar('--up-card-bg-color', '#ffffff')
-				};
+				const style = {};
+				if (this.border) {
+					style.borderColor = this.upThemeVar('--up-border-color', '#dadbde');
+					style.backgroundColor = this.upThemeVar('--up-card-bg-color', '#ffffff');
+				}
+				// 遮罩可见时把触发区抬到遮罩之上，避免下拉面板亮着而它的锚点被压暗
+				if (this.isOpen && this.overlay) {
+					style.position = 'relative';
+					style.zIndex = this.zIndex + 1;
+				}
+				return style;
 			},
 			optionsWrapStyle() {
 				const style = {
@@ -195,6 +206,14 @@
 			}
 		},
 		methods: {
+			labelClick() {
+				// 触发区被抬到遮罩之上后，遮罩不再代收这次点击，需要自己处理收起
+				if (this.isOpen) {
+					this.closeSelect();
+					return;
+				}
+				this.openSelect();
+			},
 			openSelect() {
 				if (this.disabled) return;
 				this.isOpen = true;
@@ -208,7 +227,8 @@
 				this.isOpen = false;
 			},
 			overlayClick() {
-				this.isOpen = false;
+				if (!this.closeOnClickOverlay) return;
+				this.closeSelect();
 			},
 			selectItem(item) {
 				this.isOpen = false;

package/components/u-subsection/theme-vars.scss

@@ -1,3 +1,26 @@
+/* #ifdef MP-WEIXIN */
+:host {
+	--up-subsection-bg-color: #eeeeef;
+	--up-subsection-bar-color: #ffffff;
+	--up-subsection-inactive-color: #303133;
+	--up-subsection-disabled-text-color: #c8c9cc;
+	--up-subsection-disabled-border-color: #d4d4d4;
+	--up-subsection-disabled-bar-color: #f5f5f5;
+}
+
+@media (prefers-color-scheme: dark) {
+	:host {
+		--up-subsection-bg-color: #2b2c30;
+		--up-subsection-bar-color: #3a3b40;
+		--up-subsection-inactive-color: #d1d5db;
+		--up-subsection-disabled-text-color: #6b7280;
+		--up-subsection-disabled-border-color: #3a3a3c;
+		--up-subsection-disabled-bar-color: #3a3a3c;
+	}
+}
+/* #endif */
+
+/* #ifndef MP-WEIXIN */
 :root,
 page,
 body {
@@ -39,3 +62,4 @@ body {
 	--up-subsection-disabled-border-color: #3a3a3c;
 	--up-subsection-disabled-bar-color: #3a3a3c;
 }
+/* #endif */

package/components/u-switch/theme-vars.scss

@@ -1,3 +1,26 @@
+/* #ifdef MP-WEIXIN */
+:host {
+	--up-switch-active-color: #3c9cff;
+	--up-switch-inactive-color: #ffffff;
+	--up-switch-dot-active-color: #ffffff;
+	--up-switch-dot-inactive-color: #ffffff;
+	--up-switch-loading-inactive-color: #aaabad;
+	--up-switch-border-color: rgba(0, 0, 0, 0.12);
+}
+
+@media (prefers-color-scheme: dark) {
+	:host {
+		--up-switch-active-color: #3c9cff;
+		--up-switch-inactive-color: #3a3a3c;
+		--up-switch-dot-active-color: #ffffff;
+		--up-switch-dot-inactive-color: #d1d5db;
+		--up-switch-loading-inactive-color: #9ca3af;
+		--up-switch-border-color: #4b5563;
+	}
+}
+/* #endif */
+
+/* #ifndef MP-WEIXIN */
 :root,
 page,
 body {
@@ -39,3 +62,4 @@ body {
 	--up-switch-loading-inactive-color: #9ca3af;
 	--up-switch-border-color: #4b5563;
 }
+/* #endif */

package/components/u-tabbar/u-tabbar.vue

@@ -99,9 +99,14 @@
 					this.itemShape,
 					this.iconScale,
 					this.textMode,
-					this.borderColor
+					this.borderColor,
+					this.border,
+					this.customStyle
 				]
 			},
+			midButtonBorderTopOffset() {
+				return this.border ? 0.25 : 0
+			},
 			updatePlaceholder() {
 				return [this.fixed, this.placeholder]
 			}

package/components/u-tabbar-item/midButtonGeometry.js

@@ -0,0 +1,19 @@
+const MID_BUTTON_SIZE = 64
+
+export function clampMidButtonBorderClipHeight(value) {
+	const height = Number(value)
+	if (!Number.isFinite(height)) return 0
+	return Math.min(Math.max(height, 0), MID_BUTTON_SIZE)
+}
+
+export function calculateMidButtonBorderClipHeight({
+	contentTop,
+	circleTop,
+	borderTopOffset = 0
+}) {
+	const targetTop = Number(contentTop)
+	const currentTop = Number(circleTop)
+	const borderOffset = Number(borderTopOffset)
+	if (![targetTop, currentTop, borderOffset].every(Number.isFinite)) return 0
+	return clampMidButtonBorderClipHeight(targetTop + borderOffset - currentTop)
+}

package/components/u-tabbar-item/u-tabbar-item.vue

@@ -8,38 +8,41 @@
 		<view class="u-tabbar-item__content" :class="contentClassNames">
 			<view class="u-tabbar-item__bubble" :class="bubbleClassNames">
 				<view
+					ref="u-tabbar-item__icon--mid-button"
 					class="u-tabbar-item__icon"
 					:class="iconClassNames"
 				>
-					<view v-if="isMidButton" class="u-tabbar-item__mid-button-border">
+					<view v-if="isMidButton" class="u-tabbar-item__mid-button-border" :style="midButtonBorderStyle">
 						<view class="u-tabbar-item__mid-button-border-circle" :style="midButtonBorderCircleStyle"></view>
 					</view>
 					<view v-if="isMidButton" class="u-tabbar-item__mid-button-inner"></view>
-					<up-icon
-						v-if="resolvedIconName"
-						:name="resolvedIconName"
-						:color="isMidButton ? resolvedMidButtonIconColor : (isActive ? resolvedActiveColor : resolvedInactiveColor)"
-						:size="isMidButton ? midButtonIconSize : 24"
-						:customStyle="midButtonIconStyle"
-					></up-icon>
-					<template v-else>
-						<slot
-							v-if="isActive"
-							name="active-icon"
-						/>
-						<slot
-							v-else
-							name="inactive-icon"
-						/>
-					</template>
-					<u-badge
-						absolute
-						:offset="[0, dot ? '34rpx' : badge > 9 ? '14rpx' : '20rpx']"
-						:customStyle="badgeStyle"
-						:isDot="dot"
-						:value="badge || (dot ? 1 : null)"
-						:show="dot || badge > 0"
-					></u-badge>
+					<view class="u-tabbar-item__icon-content" :class="iconContentClassNames">
+						<up-icon
+							v-if="resolvedIconName"
+							:name="resolvedIconName"
+							:color="isMidButton ? resolvedMidButtonIconColor : (isActive ? resolvedActiveColor : resolvedInactiveColor)"
+							:size="isMidButton ? midButtonIconSize : 24"
+							:customStyle="midButtonIconStyle"
+						></up-icon>
+						<template v-else>
+							<slot
+								v-if="isActive"
+								name="active-icon"
+							/>
+							<slot
+								v-else
+								name="inactive-icon"
+							/>
+						</template>
+						<u-badge
+							absolute
+							:offset="[0, dot ? '34rpx' : badge > 9 ? '14rpx' : '20rpx']"
+							:customStyle="badgeStyle"
+							:isDot="dot"
+							:value="badge || (dot ? 1 : null)"
+							:show="dot || badge > 0"
+						></u-badge>
+					</view>
 				</view>
 
 				<slot name="text">
@@ -62,7 +65,8 @@
 	import { props } from './props';
 	import { mpMixin } from '../../libs/mixin/mpMixin';
 	import { mixin } from '../../libs/mixin/mixin';
-	import { addStyle, error } from '../../libs/function/index';
+	import { addStyle, error, sleep } from '../../libs/function/index';
+	import { calculateMidButtonBorderClipHeight } from './midButtonGeometry';
 	/**
 	 * TabbarItem 底部导航栏子组件
 	 * @description 此组件提供了自定义tabbar的能力。
@@ -73,6 +77,13 @@
 	 * @property {Boolean}			dot			是否显示圆点，将会覆盖badge参数（默认 false ）
 	 * @property {String}			text		描述文本
 	 * @property {Object | String}	badgeStyle	控制徽标的位置，对象或者字符串形式，可以设置top和right属性（默认 'top: 6px;right:2px;' ）
+	 * @property {String}			mode		模式，默认普通模式，midButton中间按钮模式
+	 * @property {String}			midButtonBgColor	中间按钮背景色
+	 * @property {String}			midButtonIconColor	中间按钮图标颜色
+	 * @property {String | Number}	midButtonIconSize	中间按钮图标大小（默认 26 ）
+	 * @property {String}			midButtonBoxShadow	中间按钮外层阴影
+	 * @property {String}			midButtonInnerBoxShadow	中间按钮内层阴影
+	 * @property {String | Number}	midButtonOffsetY	中间按钮垂直偏移，负值为上移（默认 -10 ）
 	 * @property {Object}			customStyle	定义需要用到的外部样式
 	 * 
 	 * @example <u-tabbar :value="value2" :placeholder="false" @change="name => value2 = name" :fixed="false" :safeAreaInsetBottom="false"><u-tabbar-item text="首页" icon="home" dot ></u-tabbar-item></u-tabbar>
@@ -83,6 +94,7 @@
 		data() {
 			return {
 				isActive: false, // 是否处于激活状态
+				midButtonBorderClipHeightValue: 0,
 				parentData: {
 					value: null,
 					activeColor: '',
@@ -94,7 +106,9 @@
 					itemShape: 'default',
 					iconScale: 1.1,
 					textMode: 'always',
-					borderColor: ''
+					borderColor: '',
+					border: true,
+					midButtonBorderTopOffset: 0.25
 				}
 			}
 		},
@@ -154,9 +168,12 @@
 				return `${this.resolvedMidButtonOffsetY}px`
 			},
 			midButtonBorderClipHeight() {
-				const clipBaseHeight = this.hasMidButtonText ? 15.5 : 7
-				const clipHeight = clipBaseHeight - this.resolvedMidButtonOffsetY
-				return `${Math.min(Math.max(clipHeight, 0), 64)}px`
+				return `${this.midButtonBorderClipHeightValue}px`
+			},
+			midButtonBorderStyle() {
+				return {
+					height: this.midButtonBorderClipHeight
+				}
 			},
 			midButtonBorderCircleStyle() {
 				return this.isMidButton && this.parentData.borderColor
@@ -180,7 +197,15 @@
 				return [
 					this.isMidButton ? 'u-tabbar-item__icon--mid-button' : '',
 					`u-tabbar-item__icon--${this.resolvedStyleType}`,
-					this.isActive && this.resolvedAnimationType !== 'none' ? `u-tabbar-item__icon--anim-${this.resolvedAnimationType}` : ''
+					this.isActive && this.resolvedAnimationType !== 'none' && !this.isMidButton ? `u-tabbar-item__icon--anim-${this.resolvedAnimationType}` : ''
+				]
+			},
+			iconContentClassNames() {
+				return [
+					this.isMidButton ? 'u-tabbar-item__icon-content--mid-button' : '',
+					this.isMidButton && this.isActive && this.resolvedAnimationType !== 'none'
+						? `u-tabbar-item__icon-content--anim-${this.resolvedAnimationType}`
+						: ''
 				]
 			},
 			contentClassNames() {
@@ -213,6 +238,20 @@
 		created() {
 			this.init()
 		},
+		mounted() {
+			this.scheduleMidButtonBorderMeasure()
+		},
+		watch: {
+			mode() {
+				this.scheduleMidButtonBorderMeasure()
+			},
+			text() {
+				this.scheduleMidButtonBorderMeasure()
+			},
+			midButtonOffsetY() {
+				this.scheduleMidButtonBorderMeasure()
+			}
+		},
 		emits: ["click", "change"],
 		methods: {
 			addStyle,
@@ -235,6 +274,28 @@
 			updateFromParent() {
 				// 重新初始化
 				this.init()
+				this.scheduleMidButtonBorderMeasure()
+			},
+			scheduleMidButtonBorderMeasure() {
+				if (!this.isMidButton) return
+				this.$nextTick(() => this.updateMidButtonBorderClip())
+			},
+			async updateMidButtonBorderClip() {
+				if (!this.isMidButton || !this.parent) return
+				await sleep(20)
+				const [contentRect, circleRect] = await Promise.all([
+					this.parent.$uGetRect('.u-tabbar__content'),
+					this.$uGetRect('.u-tabbar-item__icon--mid-button')
+				])
+				if ([contentRect, circleRect].some(rect => !rect || !Number.isFinite(rect.top) || rect.height <= 0)) return
+				const clipHeight = calculateMidButtonBorderClipHeight({
+					contentTop: contentRect.top,
+					circleTop: circleRect.top,
+					borderTopOffset: this.parentData.border ? this.parentData.midButtonBorderTopOffset : 0
+				})
+				if (clipHeight !== this.midButtonBorderClipHeightValue) {
+					this.midButtonBorderClipHeightValue = clipHeight
+				}
 			},
 			clickHandler() {
 				this.$nextTick(() => {
@@ -281,6 +342,19 @@
 				width: 100%;
 			}
 
+			&-content {
+				@include flex;
+				align-items: center;
+				justify-content: center;
+
+				&--mid-button {
+					position: relative;
+					z-index: 2;
+					width: 100%;
+					height: 100%;
+				}
+			}
+
 			&--anim-scale {
 				transform: scale(var(--up-tabbar-icon-scale, 1.1));
 			}
@@ -402,7 +476,7 @@
 		transform: none;
 	}
 
-	.u-tabbar-item--lift.u-tabbar-item--active .u-tabbar-item__icon {
+	.u-tabbar-item--lift.u-tabbar-item--active .u-tabbar-item__icon:not(.u-tabbar-item__icon--mid-button) {
 		transform: translateY(-6rpx) scale(1.04);
 	}
 
@@ -439,7 +513,7 @@
 		left: 0;
 		top: 0;
 		width: 64px;
-		height: v-bind('midButtonBorderClipHeight');
+		height: 0;
 		box-sizing: border-box;
 		background: transparent;
 		overflow: hidden;
@@ -447,15 +521,17 @@
 		z-index: 0;
 	}
 
-	/* #ifdef APP-NVUE */
-	.u-tabbar-item__mid-button-border {
-		height: 15.5px;
+	.u-tabbar-item__icon-content--anim-scale {
+		transform: scale(var(--up-tabbar-icon-scale, 1.1));
 	}
 
-	.u-tabbar-item--mid-button-no-text .u-tabbar-item__mid-button-border {
-		height: 7px;
+	.u-tabbar-item__icon-content--anim-lift {
+		transform: translateY(-6rpx) scale(var(--up-tabbar-icon-scale, 1.08));
+	}
+
+	.u-tabbar-item__icon-content--anim-swing {
+		transform: rotate(-10deg) scale(var(--up-tabbar-icon-scale, 1.08));
 	}
-	/* #endif */
 
 	.u-tabbar-item__mid-button-border-circle {
 		width: 64px;
@@ -497,7 +573,8 @@
 		transform: translateY(-4rpx);
 	}
 
-	.u-tabbar-item--anim-pulse .u-tabbar-item__icon {
+	.u-tabbar-item--anim-pulse .u-tabbar-item__icon:not(.u-tabbar-item__icon--mid-button),
+	.u-tabbar-item__icon-content--anim-pulse {
 		animation: u-tabbar-item-pulse 1.4s ease-in-out infinite;
 	}
 

package/components/u-tag/theme-vars.scss

@@ -1,3 +1,16 @@
+/* #ifdef MP-WEIXIN */
+:host {
+	--up-tag-close-bg-color: #c8c9cc;
+}
+
+@media (prefers-color-scheme: dark) {
+	:host {
+		--up-tag-close-bg-color: #4b5563;
+	}
+}
+/* #endif */
+
+/* #ifndef MP-WEIXIN */
 :root,
 page,
 body {
@@ -19,3 +32,4 @@ body {
 [data-up-theme='dark'] {
 	--up-tag-close-bg-color: #4b5563;
 }
+/* #endif */

package/components/u-transition/u-transition.vue

@@ -6,7 +6,6 @@
 		@tap="clickHandler"
 		:class="classes"
 		:style="[mergeStyle]"
-		@touchmove="noop"
 	>
 		<slot />
 	</view>

package/components/u-waterfall/u-waterfall.vue

@@ -92,14 +92,14 @@
             return {
                 columnList: [[]], // 存储每列的数据
                 children: [],
-                // 用于标记是否已经初始化
-                initialized: false,
-                windowWidth: 375,
-                windowHeight: 0,
-                distributionQueue: [],
-                distributionRunning: false,
-                distributionPromise: null,
-                distributionGeneration: 0
+                // 用于标记是否已经初始化
+                initialized: false,
+                windowWidth: 375,
+                windowHeight: 0,
+                distributionQueue: [],
+                distributionRunning: false,
+                distributionPromise: null,
+                distributionGeneration: 0
             }
         },
         watch: {
@@ -111,27 +111,27 @@
                         if (this.columnList.length == 1) {
                             this.initColumnList()
                         }
-                        if (!this.isPureAppend(nVal, oVal)) {
-                            this.redistributeData(nVal);
-                            return;
-                        }
-                        // 取差值，即这一次数组变化新增的部分
-                        const startIndex = Array.isArray(oVal) && oVal.length > 0 ? oVal.length : 0;
-                        // 纯追加时只将新增数据加入共享分配队列
-                        this.handleData(nVal.slice(startIndex));
+                        if (!this.isPureAppend(nVal, oVal)) {
+                            this.redistributeData(nVal);
+                            return;
+                        }
+                        // 取差值，即这一次数组变化新增的部分
+                        const startIndex = Array.isArray(oVal) && oVal.length > 0 ? oVal.length : 0;
+                        // 纯追加时只将新增数据加入共享分配队列
+                        this.handleData(nVal.slice(startIndex));
                     }
                 },
                 immediate: true
             },
-            columns: {
-                handler() {
-                    // 重新分配数据
-                    if (this.copyFlowList.length > 0) {
-                        this.redistributeData(this.copyFlowList);
-                    } else {
-                        this.clear(false);
-                    }
-                },
+            columns: {
+                handler() {
+                    // 重新分配数据
+                    if (this.copyFlowList.length > 0) {
+                        this.redistributeData(this.copyFlowList);
+                    } else {
+                        this.clear(false);
+                    }
+                },
                 immediate: false
             }
         },
@@ -219,144 +219,150 @@
                     const newColumnsCount = this.getColumnsCount();
                     const oldColumnsCount = this.columnList.length;
                     
-                    // 只有列数发生变化时才重新分配数据
-                    if (newColumnsCount !== oldColumnsCount) {
-                        this.redistributeData(this.copyFlowList);
-                    }
-                }, 300);
-            },
-
-            // 重新分配所有数据
-            redistributeData(data = this.copyFlowList) {
-                this.clear(false);
-                // 保存所有数据
-                const allData = this.cloneData(data || []);
-                // 重新分配数据
-                return this.handleData(allData);
-            },
-
-            // 判断新数据是否只在原数组末尾追加
-            isPureAppend(newData, oldData) {
-                if (!Array.isArray(oldData) || oldData.length === 0) return true;
-                if (!Array.isArray(newData) || newData.length < oldData.length) return false;
-                return oldData.every((item, index) => {
-                    return JSON.stringify(item) === JSON.stringify(newData[index]);
-                });
-            },
-
-            // 将新增数据加入共享队列，确保只有一个分配循环运行
-            handleData(newData) {
-                if (!newData || newData.length === 0) {
-                    return this.distributionPromise || Promise.resolve();
-                }
-                this.distributionQueue.push({
-                    generation: this.distributionGeneration,
-                    data: this.cloneData(newData)
-                });
-                if (!this.distributionRunning) {
-                    this.distributionPromise = this.runDistributionQueue();
-                }
-                return this.distributionPromise;
-            },
-
-            // 串行消费所有待分配数据
-            async runDistributionQueue() {
-                if (this.distributionRunning) return;
-                this.distributionRunning = true;
-                try {
-                    while (this.distributionQueue.length > 0) {
-                        const task = this.distributionQueue.shift();
-                        if (task.generation !== this.distributionGeneration) continue;
-                        await this.distributeData(task.data, task.generation);
-                    }
-                } finally {
-                    this.distributionRunning = false;
-                    this.distributionPromise = null;
-                    if (this.distributionQueue.length > 0) {
-                        this.distributionPromise = this.runDistributionQueue();
-                    }
-                }
-            },
-
-            // 逐项测量并分配数据，代数变化时立即退出
-            async distributeData(newData, generation) {
-                let columnHeights = new Array(this.columnList.length).fill(0);
-                for (const item of newData) {
-                    if (generation !== this.distributionGeneration) return;
-                    columnHeights = await this.getColumnHeights();
-                    if (generation !== this.distributionGeneration) return;
-
-                    const minHeightIndex = this.getMinHeightColumnIndex(columnHeights);
-                    this.columnList[minHeightIndex].push(item);
-
-                    await sleep(this.addTime);
-                    if (generation !== this.distributionGeneration) return;
-                    await this.$nextTick();
-                    if (generation !== this.distributionGeneration) return;
-                    try {
-                        const rect = await this.$uGetRect(`#u-column-${minHeightIndex}`);
-                        if (generation !== this.distributionGeneration) return;
-                        if (rect.height) {
-                            columnHeights[minHeightIndex] = rect.height;
-                            this.$emit('after-add-one', {
-                                ...item,
-                                height: rect.height
-                            });
-                        }
-                    } catch (e) {
-                        // 获取不到列高时，下一个元素会重新测量所有列
-                    }
-                }
-                if (generation !== this.distributionGeneration) return;
-                this.$emit('after-add-all', {
-                    columnHeights: columnHeights,
-                    newData: newData
-                });
-            },
-
-            // 获取当前所有列的真实高度
-            async getColumnHeights() {
-                const columnHeights = new Array(this.columnList.length).fill(0);
-                for (let i = 0; i < this.columnList.length; i++) {
-                    try {
-                        const rect = await this.$uGetRect(`#u-column-${i}`);
-                        columnHeights[i] = rect.height || 0;
-                    } catch (e) {
-                        columnHeights[i] = 0;
-                    }
-                }
-                return columnHeights;
-            },
-
-            // 获取最短列；高度相同或暂不可测时按列数据量打散，避免全部落到第一列
-            getMinHeightColumnIndex(columnHeights) {
-                let minIndex = 0;
-                for (let i = 1; i < columnHeights.length; i++) {
-                    const currentHeight = Number(columnHeights[i]) || 0;
-                    const minHeight = Number(columnHeights[minIndex]) || 0;
-                    if (currentHeight < minHeight) {
-                        minIndex = i;
-                    } else if (currentHeight === minHeight) {
-                        const currentLength = this.columnList[i] ? this.columnList[i].length : 0;
-                        const minLength = this.columnList[minIndex] ? this.columnList[minIndex].length : 0;
-                        if (currentLength < minLength) {
-                            minIndex = i;
-                        }
-                    }
-                }
-                return minIndex;
-            },
-
-            // 复制而不是引用对象和数组
-            cloneData(data) {
-                return JSON.parse(JSON.stringify(data));
+                    // 只有列数发生变化时才重新分配数据
+                    if (newColumnsCount !== oldColumnsCount) {
+                        this.redistributeData(this.copyFlowList);
+                    }
+                }, 300);
+            },
+
+            // 重新分配所有数据
+            redistributeData(data = this.copyFlowList) {
+                // 强制重置锁状态，确保能重新开始分配
+                this.distributionRunning = false;
+                this.distributionPromise = null;
+                this.clear(false);
+                // 保存所有数据
+                const allData = this.cloneData(data || []);
+                // 重新分配数据
+                return this.handleData(allData);
+            },
+
+            // 判断新数据是否只在原数组末尾追加
+            isPureAppend(newData, oldData) {
+                if (!Array.isArray(oldData) || oldData.length === 0) return true;
+                if (!Array.isArray(newData) || newData.length < oldData.length) return false;
+                return oldData.every((item, index) => {
+                    return JSON.stringify(item) === JSON.stringify(newData[index]);
+                });
+            },
+
+            // 将新增数据加入共享队列，确保只有一个分配循环运行
+            handleData(newData) {
+                if (!newData || newData.length === 0) {
+                    return this.distributionPromise || Promise.resolve();
+                }
+                this.distributionQueue.push({
+                    generation: this.distributionGeneration,
+                    data: this.cloneData(newData)
+                });
+                if (!this.distributionRunning) {
+                    this.distributionPromise = this.runDistributionQueue();
+                }
+                return this.distributionPromise;
+            },
+
+            // 串行消费所有待分配数据
+            async runDistributionQueue() {
+                if (this.distributionRunning) return;
+                this.distributionRunning = true;
+                try {
+                    while (this.distributionQueue.length > 0) {
+                        const task = this.distributionQueue.shift();
+                        if (task.generation !== this.distributionGeneration) continue;
+                        await this.distributeData(task.data, task.generation);
+                    }
+                } finally {
+                    this.distributionRunning = false;
+                    this.distributionPromise = null;
+                    if (this.distributionQueue.length > 0) {
+                        this.distributionPromise = this.runDistributionQueue();
+                    }
+                }
+            },
+
+            // 逐项测量并分配数据，代数变化时立即退出
+            async distributeData(newData, generation) {
+                let columnHeights = new Array(this.columnList.length).fill(0);
+                for (const item of newData) {
+                    if (generation !== this.distributionGeneration) return;
+                    columnHeights = await this.getColumnHeights();
+                    if (generation !== this.distributionGeneration) return;
+
+                    const minHeightIndex = this.getMinHeightColumnIndex(columnHeights);
+                    this.columnList[minHeightIndex].push(item);
+
+                    await sleep(this.addTime);
+                    if (generation !== this.distributionGeneration) return;
+                    await this.$nextTick();
+                    if (generation !== this.distributionGeneration) return;
+                    try {
+                        const rect = await this.$uGetRect(`#u-column-${minHeightIndex}`);
+                        if (generation !== this.distributionGeneration) return;
+                        if (rect.height) {
+                            columnHeights[minHeightIndex] = rect.height;
+                            this.$emit('after-add-one', {
+                                ...item,
+                                height: rect.height
+                            });
+                        }
+                    } catch (e) {
+                        // 获取不到列高时，下一个元素会重新测量所有列
+                    }
+                }
+                if (generation !== this.distributionGeneration) return;
+                this.$emit('after-add-all', {
+                    columnHeights: columnHeights,
+                    newData: newData
+                });
+            },
+
+            // 获取当前所有列的真实高度
+            async getColumnHeights() {
+                const columnHeights = new Array(this.columnList.length).fill(0);
+                for (let i = 0; i < this.columnList.length; i++) {
+                    try {
+                        const rect = await this.$uGetRect(`#u-column-${i}`);
+                        columnHeights[i] = rect.height || 0;
+                    } catch (e) {
+                        columnHeights[i] = 0;
+                    }
+                }
+                return columnHeights;
+            },
+
+            // 获取最短列；高度相同或暂不可测时按列数据量打散，避免全部落到第一列
+            getMinHeightColumnIndex(columnHeights) {
+                let minIndex = 0;
+                for (let i = 1; i < columnHeights.length; i++) {
+                    const currentHeight = Number(columnHeights[i]) || 0;
+                    const minHeight = Number(columnHeights[minIndex]) || 0;
+                    if (currentHeight < minHeight) {
+                        minIndex = i;
+                    } else if (currentHeight === minHeight) {
+                        const currentLength = this.columnList[i] ? this.columnList[i].length : 0;
+                        const minLength = this.columnList[minIndex] ? this.columnList[minIndex].length : 0;
+                        if (currentLength < minLength) {
+                            minIndex = i;
+                        }
+                    }
+                }
+                return minIndex;
+            },
+
+            // 复制而不是引用对象和数组
+            cloneData(data) {
+                return JSON.parse(JSON.stringify(data));
             },
             
-            // 清空数据列表
-            clear(bak = true) {
-                this.distributionGeneration += 1;
-                this.distributionQueue.splice(0);
-                this.initColumnList();
+            // 清空数据列表
+            clear(bak = true) {
+                this.distributionGeneration += 1;
+                this.distributionQueue.splice(0);
+                // 强制重置分配锁状态，避免页面隐藏导致的永久锁死
+                this.distributionRunning = false;
+                this.distributionPromise = null;
+                this.initColumnList();
                 // 同时清除父组件列表中的数据
                 if (bak) {
                     // #ifdef VUE2
@@ -465,4 +471,4 @@
         max-width: 100%;
         /* #endif */
     }
-</style>
+</style>

package/libs/function/index.js

@@ -17,6 +17,20 @@ function emptyNodeInfo() {
 	}
 }
 
+// 组件卸载后仍把它交给原生查询，APP 端会拿已失效的 nodeId 去查视图层映射表，
+// 读到 undefined 再取 .$ 就抛 Cannot read properties of undefined (reading '$')
+function isCompUnmounted(comp) {
+	if (!comp) {
+		return false
+	}
+	// 公共 mixin 的 beforeUnmount 里同步置位
+	if (comp.__upUnmounted) {
+		return true
+	}
+	// 未应用公共 mixin 时退回 Vue 自身标记：公开实例挂在 $ 上，内部实例直接持有
+	return !!(comp.$ ? comp.$.isUnmounted : comp.isUnmounted)
+}
+
 // #ifdef APP-NVUE
 const dom = (typeof uni !== 'undefined' && uni && typeof uni.requireNativePlugin === 'function')
 	? uni.requireNativePlugin('dom')
@@ -37,6 +51,10 @@ function getNvueRect(ref) {
 
 // 查询节点信息
 export function upGetRect(selector, all = false, comp = null) {
+	// 判定必须放在条件编译之外，否则 app-harmony 上整段会被裁掉
+	if (isCompUnmounted(comp)) {
+		return Promise.resolve(all ? [] : emptyNodeInfo())
+	}
 	return new Promise((resolve) => {
 		// #ifndef APP-NVUE
 		const query = uni.createSelectorQuery()
@@ -70,6 +88,17 @@ export function upGetRect(selector, all = false, comp = null) {
 	})
 }
 
+// 卸载后替代真实观察器，保持链式调用不报错
+function noopIntersectionObserver() {
+	const observer = {
+		relativeTo: () => observer,
+		relativeToViewport: () => observer,
+		observe: () => {},
+		disconnect: () => {}
+	}
+	return observer
+}
+
 // 创建交叉观察器
 // 小程序端 uni.createIntersectionObserver(vm) 会把 Vue 实例代理直接透传给原生 API，
 // 原生内部的 Object.keys(vm) 会触发告警：
@@ -77,6 +106,10 @@ export function upGetRect(selector, all = false, comp = null) {
 // （uni-app 只给 createSelectorQuery 做了 $scope 解包，没给 createIntersectionObserver 做）
 // 组件实例上的同名方法内部使用 $scope（原生组件实例），不会把代理外泄，因此优先使用
 export function upCreateIntersectionObserver(comp, options) {
+	// 和 upGetRect 同理：APP 端 addIntersectionObserver 也走 window.__$__(id).$ 查表
+	if (isCompUnmounted(comp)) {
+		return noopIntersectionObserver()
+	}
 	// 各家小程序与 H5 都在组件实例上暴露了该方法，内部已完成实例解包
 	if (comp && typeof comp.createIntersectionObserver === 'function') {
 		return options ? comp.createIntersectionObserver(options) : comp.createIntersectionObserver()

package/libs/mixin/mixin.js

@@ -251,6 +251,9 @@ export const mixin = defineMixin({
         uni.$emit('uOnReachBottom')
 	},
 	beforeUnmount() {
+        // mixin 的钩子先于组件自身钩子同步执行，比 Vue 内部的 $.isUnmounted
+        // （在 post-render 队列里异步置位）更早，异步回调据此拦截节点查询
+        this.__upUnmounted = true
         // 判断当前页面是否存在parent和chldren，一般在checkbox和checkbox-group父子联动的场景会有此情况
         // 组件销毁时，移除子组件在父组件children数组中的实例，释放资源，避免数据混乱
         if (this.parent && test.array(this.parent.children)) {

package/package.json

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