文档开发者中心
我的
|

HarmonyOS 6

DevEco Studio

HdsNavigation组件

HdsNavigation组件,代码如下,为啥打开【布局边界】的时候,底部有一条线,但是这个位置没有布局呀!
这条线是怎么来的?可以隐藏吗?

收起
自动换行
深色代码主题
复制
import { HdsNavigation } from '@kit.UIDesignKit';

@Entry
@Component
struct Index {
  private stack: NavPathStack = new NavPathStack();

  build() {
    HdsNavigation(this.stack) {
      Column() {
        Button("打开详情")
          .onClick(() => {
            this.stack.pushPath({ name: "Detail" })
          })
      }
      .width('100%')
      .height('100%')
      .justifyContent(FlexAlign.End)
      .backgroundColor('#C0C0C0')
    }
    .hideToolBar(true)
    .hideTitleBar(true)
    .hideNavBar(false) // 是否隐藏HdsNavigation
  }
}

cke_14594.png

cke_158.png

点赞
1
收藏
1
回复
4
分享
举报
浏览240 发布于2026-07-10 09:10江苏
全部评论
最多点赞
最新发布
最早发布
|
技术支持
尊敬的开发者,您好:
本地通过DevEco Studio 6.1.1 release版本 + API24版本的模拟器进行测试,使用您提供的代码,并未在ArkUI Inspector开启布局边界后复现上述问题。
请问能否提供以下信息:
  • 您所使用的DevEco Studio版本
  • 您复现上述问题的设备型号以及系统版本

合作愉快。
华为开发者联盟
4楼回复于2026-07-14 08:10 来自广东
这是【布局边界】画出来的。
1楼回复于2026-07-10 09:21 来自广西

楼主你好。

这个其实不是你的 Column 布局产生的,从你贴的代码来看,你的 Column 已经是:

收起
自动换行
深色代码主题
复制
.width('100%')
.height('100%')
.justifyContent(FlexAlign.End)

布局本身没有问题。

那这条线是哪来的?

从你开启 布局边界 的截图来看,这条横线正好位于:

  • 页面内容区域底部

  • Navigation 容器内部

  • SafeArea 上方

而且宽度贯穿整个页面。

它实际上是 HdsNavigation/Navigation 内部的内容容器(NavDestination)的布局边界,并不是你的组件。

也就是说,布局边界模式会把系统组件内部的一些布局节点也画出来,包括:

  • Navigation

  • NavDestination

  • SafeArea

  • TitleBar(即使隐藏了)

  • ToolBar(即使隐藏了)

所以即使页面上没有放任何组件,也可能看到几条横线。

为什么按钮正好压在线上?

因为你设置了:

收起
自动换行
深色代码主题
复制
.justifyContent(FlexAlign.End)

按钮被放到了 Column 的底部。

而布局边界显示的是:

Navigation 内容区域的边界 + 你的 Column 边界。

两者刚好重合,所以会感觉按钮"压在一条神秘的线上"。

实际上:

按钮属于你的 Column,这条线属于 Navigation。

能隐藏吗?

正常情况下不能。

因为:

布局边界(Layout Bounds)是 DevEco Studio 的调试功能。

它会把系统组件内部的布局节点全部绘制出来。

这些红线:

  • 不属于 UI

  • 不会真正绘制

  • 不会影响布局

  • Release 包也不会显示

因此没有 API 可以隐藏某一条。

可以验证一下是不是 Navigation 画的

可以把:

收起
自动换行
深色代码主题
复制
HdsNavigation()

改成:

收起
自动换行
深色代码主题
复制
Navigation(this.stack)

或者直接:

收起
自动换行
深色代码主题
复制
Column() {
    ...
}

再打开布局边界。

如果不用 Navigation,这条线一般就不会出现。

hideToolBar(true) 为什么还有?

很多人第一次都会疑惑这一点。

实际上:

收起
自动换行
深色代码主题
复制
.hideToolBar(true)
.hideTitleBar(true)

只是:

隐藏显示。

并不是:

把内部节点删除。

Navigation 内部依然存在:

  • NavBar

  • Content

  • Toolbar Container

  • SafeArea Container

只是其中一些节点高度变成了 0 或者不参与绘制。

布局边界仍然会把这些 LayoutNode 显示出来。

会不会影响布局?

不会。

如果你的页面:

收起
自动换行
深色代码主题
复制
.height('100%')

测量出来是正常的;

点击区域也正常;

真机显示没有异常;

那完全可以忽略。

很多系统组件(Navigation、List、Grid、Tabs)在开启布局边界后都会看到一些"看起来没有对应组件"的辅助线,这是调试工具把内部布局节点一起画出来导致的,并不是页面真的多了一层布局。

总结一下:

这条横线大概率是 HdsNavigation(底层 Navigation)内部内容容器或 SafeArea 容器的布局边界,不是你的 Column 或 Button 产生的。布局边界模式会把系统组件的内部 LayoutNode 一起显示出来,即使已经调用了 hideTitleBar(true)、hideToolBar(true),对应节点通常只是隐藏而不是销毁,所以仍然会显示调试边界。这是调试现象,不会影响实际布局,也没有单独隐藏这条线的接口,可以放心忽略。

展开全部
3楼回复于2026-07-13 08:55 来自辽宁

这条横线不是业务代码绘制的分割线,而是开启“显示布局边界”后,调试层把 HdsNavigation 内部保留的底部工具栏/导航容器节点边界标了出来。

hideToolBar(true) 控制的是工具栏的可见性;为安全区适配以及显隐、切页动画,内部布局节点仍可能存在,所以调试模式仍会显示边界。关闭“显示布局边界”后它不会参与正常界面绘制,Release 包也不会出现,无需通过 border、backgroundColor 或 divider 去处理(divider 仅用于分栏模式的分割线)。

另外,当前 hideNavBar(false) 是保留 NavBar。不要为了这条调试线改成 hideNavBar(true):该接口会连 titleBar、HdsNavigation 的子内容和 toolBar 一并隐藏,NavPathStack 为空时页面会变空。

如果关闭“显示布局边界”后仍能看到真实像素线,再重点排查系统导航条与页面背景色的衔接;那就不是这条调试边界了。

2楼回复于2026-07-10 09:26 未知归属地
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。