HarmonyOS鸿蒙Next中底部导航栏失效/迷你栏错位

Bug 分享：HdsTabs IMMERSIVE 材质底部导航栏失效/迷你栏错位

表现如下：配置悬浮hdstabs，开启或者不开启迷你栏的情况下，启动应用没有问题，切换成窗口可能有问题可能没问题，再放大窗口后，导航栏变成透明，迷你栏向下偏移错位，你们可以查看下已开发的有没有出现这个问题，解决方法如下（AI总结）：

现象

HdsTabs 配置了 systemMaterialEffect: IMMERSIVE，但底部导航栏不显示沉浸光感效果（看起来像透明/无材质），迷你栏位置偏移。

根因

barFloatingStyle 中的 gradientMask 配置不当导致 IMMERSIVE 材质渲染管线异常：

// ❌ 错误配置
gradientMask: { maskColor: Color.Transparent, maskHeight: 0 }

• Color.Transparent 是 ArkUI 内置对象，传递给 HdsTabs 底层时可能与字符串色的解析路径不同
• maskHeight: 0 意味着 gradientMask 完全禁用，IMMERSIVE 材质依赖该遮罩层触发正确的渲染效果

正确配置

// ✅ 正确配置
gradientMask: { maskColor: '#00000000', maskHeight: 1 }

• 用 '#00000000' 字符串代替 Color.Transparent
• maskHeight 设为最小有效值 1（1vp），让遮罩层以零不透明度存在，触发正确的 IMMERSIVE 材质渲染

完整对比

排查方式

参考项目中正常工作的 ReminderBrandManagePage（一个页签作添加按钮的 IMMERSIVE HdsTabs），逐项对比 barFloatingStyle 各项属性定位到 gradientMask 的差异。