文档开发者中心
我的
|

HarmonyOS 5

HdsTabs设置expandSafeArea属性无法同时扩展到状态栏和导航条

已解决

【问题描述】:HdsTabs组件有默认设置扩展到底部安全区吗?如何将HdsTabs组件上下同时扩展到安全区?

【问题现象】:在使用HdsTabs时,无论将expandSafeArea属性设置到HdsTabs容器上还是其子组件上都不能实现上下同时扩展到安全区。不设置expandSafeArea属性时,底部扩展到安全区了。

【版本信息】:API20

【复现代码】:

收起
自动换行
深色代码主题
复制
import {  HdsTabs, HdsTabsAttribute, HdsTabsController } from '@kit.UIDesignKit';
@Entry
@Component
struct Index {
  build() {
    Column(){
      HdsTabs(){
        TabContent(){}.backgroundColor(Color.Gray).tabBar({icon:$r('app.media.startIcon'),text:'首页'})
        TabContent(){}.backgroundColor(Color.Pink).tabBar({icon:$r('app.media.startIcon'),text:'我的'})
      }.barBackgroundColor(Color.Green).barPosition(BarPosition.End)
      .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP,SafeAreaEdge.BOTTOM])
    }.backgroundColor(Color.Blue)
    .height('100%')
    .width('100%')
  }
}

【尝试解决方案】:

收起
自动换行
深色代码主题
复制
将.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP,SafeAreaEdge.BOTTOM])属性设置到子组件上无效
点赞
收藏
回复
10
分享
举报
浏览462 发布于2025-12-16 07:00湖北
全部评论
最多点赞
最新发布
最早发布
|
采纳答复

开发者你好,参考一楼的回复,需要在Column组件上也设置expandSafeArea,因为expandSafeArea属性仅作用于当前组件,不会向父组件或子组件传递,因此使用过程中,所有相关组件均需配置。你代码里面父组件Column固定宽高,那么子组件无法突破安全区。参考官方文档的说明,如果还有疑问请您再反馈:

【解决方案】

  • expandSafeArea:控制组件扩展其安全区域,可以让组件延伸到避让区。仅作用于当前组件,不会向父组件或子组件传递。如果组件的边界未与避让区重叠,设置expandSafeArea属性将不生效。

  • 对于expandSafeArea属性无法生效的场景,若要将组件部署在避让区,需要手动调整组件的坐标。

  • 设置expandSafeArea属性进行组件绘制扩展时,建议组件尺寸不要设置固定宽高(百分比除外),当设置固定宽高(包括设置'auto')时,扩展安全区域的方向只支持[SafeAreaEdge.TOP, SafeAreaEdge.START],扩展后的组件尺寸保持不变。
  • 当父容器是滚动容器时,expandSafeArea属性设置无效。
  • 组件设置expandSafeArea生效的条件为:
    • type为SafeAreaType.KEYBOARD时默认生效,表现为组件不避让键盘。
    • 设置其他type,组件的边界与安全区域重合时组件能够延伸到安全区域下。例如:设备顶部状态栏高度100,那么组件在屏幕中的绝对位置需要为0 <= y <= 100。
  • 滚动类容器内的组件不建议设置expandSafeArea属性,如果设置,需要按照组件嵌套关系,将当前节点到滚动类祖先容器间所有直接节点设置expandSafeArea属性,否则expandSafeArea属性在滚动后可能会失效。
3
2楼回复于2025-12-17 09:04 来自广东
  • Zelivorn
    您好,确实是.expandSafeArea属性不能传递到父组件的原因,尝试将所有相关组件配置扩展属性后能正常扩展到上下安全区。 但是正常扩展的前提是要将HdsTabs修改为ArkUI内置的Tabs组件,使用HdsTabs组件时,相同的配置依然不能正常生效。
    2025-12-18 03:18 来自湖北
  • 指针不迷茫回复Zelivorn
    开发者你好,请问你的版本是多少?我的版本是DevEco Studio 6.0.1 Release,我用HdsTabs也可以正常扩展。代码如下: import { HdsTabs, HdsTabsAttribute, HdsTabsController } from '@kit.UIDesignKit'; @Entry @Component struct Index { build() { Column(){ HdsTabs(){ TabContent(){}.backgroundColor(Color.Gray).tabBar({icon:$r('app.media.startIcon'),text:'首页'}) TabContent(){}.backgroundColor(Color.Pink).tabBar({icon:$r('app.media.startIcon'),text:'我的'}) }.barBackgroundColor(Color.Green).barPosition(BarPosition.End) .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP,SafeAreaEdge.BOTTOM]) } .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP,SafeAreaEdge.BOTTOM]) .backgroundColor(Color.Blue) .height('100%') .width('100%') } }
    2026-01-06 07:08 来自广东
  • Zelivorn回复指针不迷茫
    您好,在评论中无法上传图片,请看一下在下面我发送的详细信息。
    2026-01-08 02:46 来自湖北

cke_548.pngcke_1529.png

如上图左侧为HdsTabs组件效果,右侧为Tabs效果。可以看到是使用HdsTabs时,虽然在所有相关组件上使用功能了扩展属性,但是下面的蓝色是最外层Column的颜色,HdsTabs组件并没有扩展到底部。

正常扩展效果应该是右图:使用Tabs并配置扩展属性后,Tabs组件扩展到底部将Column覆盖。代码如下:

收起
自动换行
深色代码主题
复制
import {  HdsTabs, HdsTabsAttribute, HdsTabsController } from '@kit.UIDesignKit';
@Entry
@Component
struct Index {
  build() {
    Column(){
      HdsTabs(){//HdsTabs组件(右侧修改为Tabs,其他不变)
        TabContent(){}.backgroundColor(Color.Gray).tabBar({icon:$r('app.media.startIcon'),text:'首页'})
        .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP,SafeAreaEdge.BOTTOM])
        TabContent(){}.backgroundColor(Color.Pink).tabBar({icon:$r('app.media.startIcon'),text:'我的'})
      }.barBackgroundColor(Color.Green).barPosition(BarPosition.End)
      .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP,SafeAreaEdge.BOTTOM])
    }
    .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP,SafeAreaEdge.BOTTOM])
    .backgroundColor(Color.Blue)
    .height('100%')
    .width('100%')
  }
}

版本说明:

DevEco Studio 版本如下:

DevEco Studio 6.0.1 ReleaseBuild Version: 6.0.1.260, built on December 15, 2025

Runtime version: 21.0.8+1-b1038.71 amd64 (JCEF 122.1.9)VM: OpenJDK 64-Bit Server VM by JetBrains s.r.o.

Powered by open-source softwareCopyright © 2019–2026 Huawei

模拟器配置如下:

Category Content
Name Mate 80 Pro Max 21
Type phone
UUID 7fe9f42e-82d1-47ac-8a5b-7c743df00d84
ResolutionWidth 1320px
ResolutionHeight 2848px
Density 540dpi
ScreenSize 6.9"
CPU cores 4
Deploy path C:/Users/x2958/AppData/Local/Huawei/Emulator/deployed/Mate 80 Pro Max 21
RamSize 8192MB
Version(API) HarmonyOS 6.0.1(21)
CPU/ABI x86
展开全部
3楼回复于2026-01-08 02:44 来自湖北
将.expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP,SafeAreaEdge.BOTTOM])属性设置到HdsTabs的上一层Column组件上试试!
4
1楼回复于2025-12-16 07:13 来自北京
  • Zelivorn
    您好!Column确实可以扩展安全区,但是我想请问HdsTabs组件在.expandSafeArea属性设置上有冲突吗?为什么对HdsTabs和其子组件设置该属性无效?
    2025-12-16 08:58 来自湖北
  • 华夏回复Zelivorn
    可能是因为Column的原因吧,你把它换成RelativeContainer试试。
    2025-12-17 01:04 来自北京
  • Zelivorn回复华夏
    大佬,RelativeContainer也不行。如果给HdsTabs和他的子组件都.expandSafeArea属性,效果就是顶部扩展了而底部没有,都不设置.expandSafeArea属性,HdsTabs就是底部扩展了,顶部没有。 import { HdsTabs, HdsTabsAttribute, HdsTabsController } from '@kit.UIDesignKit'; @Entry @Component struct Index { build() { RelativeContainer(){ HdsTabs(){ TabContent(){}.backgroundColor(Color.Gray).tabBar({icon:$r('app.media.startIcon'),text:'首页'}) .expandSafeArea([SafeAreaType.SYSTEM],[SafeAreaEdge.TOP,SafeAreaEdge.BOTTOM]) TabContent(){}.backgroundColor(Color.Pink).tabBar({icon:$r('app.media.startIcon'),text:'我的'}) .expandSafeArea([SafeAreaType.SYSTEM],[SafeAreaEdge.TOP,SafeAreaEdge.BOTTOM]) }.barBackgroundColor(Color.Green).barPosition(BarPosition.End) .expandSafeArea([SafeAreaType.SYSTEM],[SafeAreaEdge.TOP,SafeAreaEdge.BOTTOM]) }.backgroundColor(Color.Blue).width('100%').height('100%') } }
    2025-12-17 03:48 来自湖北
  • 展开剩余1条回复
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

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