标题栏动态显隐
=======

#### 场景介绍

从6.0.0(20)版本开始，导航组件新增支持设置标题栏动态显隐功能。

用于实现标题栏在特定条件下自动显示或隐藏的效果，适用于需要节省屏幕空间的应用界面。当应用开发者需要动态隐藏标题栏时，可通过使用[dynamicHideTitleBar](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ui-design-hdsnavigation#dynamichidetitlebar)属性实现该功能。在设置动态隐藏标题栏的前提下，才可进一步设置隐藏状态栏。隐藏状态栏表现为状态栏内容区颜色为透明，状态栏区域无模糊。仅在隐藏标题栏区域后，执行隐藏状态栏。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/96/v3/9u948UlLRRuMRjh2fBGocg/zh-cn_image_0000002625187935.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073348Z&HW-CC-Expire=86400&HW-CC-Sign=C2BE6FEC92D87F4F40D52DF85C3B4A550124C5A17EF4362534BB0CE207BEEA4E "点击放大")

#### 开发步骤

1.  导入相关模块。
    
    // 从6.0.2(22)版本开始，无需手动导入HdsNavigationAttribute。具体请参考HdsNavigation的导入模块说明。
    import { HdsNavigation, BottomBuilderShowType, HideMode, HdsNavigationAttribute, HdsNavigationTitleMode } from '@kit.UIDesignKit';
    
2.  创建一级导航组件，通过设置dynamicHideTitleBar属性，可隐藏状态栏、标题区域、bottomBuilder区域。
    
    @Entry
    @Component
    struct Index {
      scroller: Scroller = new Scroller();
      private arr: number\[\] = \[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20\];
    
      @Builder
      bottomBuilder() {
        Column() {
          Search({ placeholder: 'Search' })
            .height(40)
            .placeholderColor($r('sys.color.font\_primary'))
            .margin({ left: 16, right: 16 })
        }
        .width('100%')
      }
    
      build() {
        HdsNavigation() { // 创建HdsNavigation组件
          List({ space: 12, initialIndex: 0, scroller: this.scroller }) {
            ForEach(this.arr, (item: number) => {
              ListItem() {
                Column() {
                  Row({ space: 8 }) {
                    Button() {
                      SymbolGlyph($r('sys.symbol.wifi'))
                        .fontColor(\[$r('sys.color.icon\_on\_primary')\])
                        .fontSize(24)
                    }
                    .width(35)
                    .height(35)
    
                    Text('list\_' + item)
                      .width('100%')
                      .height(72)
                      .fontSize(16)
                      .fontWeight(500)
                  }
    
                  Divider().margin({ left: 40 })
                }
              }
              .height(56)
            }, (item: number) => item.toString())
          }
          .margin({ left: 16, right: 16 })
          .clip(false) // 设置不对子组件超出当前组件范围外的区域进行裁剪，使内容区可以穿透到标题栏下方
          .cachedCount(3, true) // 设置列表中ListItem/ListItemGroup的预加载数量，列表穿透到标题栏下方不会消失
          .scrollBar(BarState.Off)
          .edgeEffect(EdgeEffect.Spring, { alwaysEnabled: true })
        }
        .titleBar({
          content: {
            title: { mainTitle: 'MainTitle' },
            // 设置标题下方bottomBuilder区域，包括设置高度，显示类型
            bottomBuilder: {
              builder: (): void => this.bottomBuilder(),
              height: 56,
              showType: BottomBuilderShowType.DIRECTLY\_SHOW
            }
          },
          enableComponentSafeArea: true, // 将标题栏设置为组件级安全区，内容区可避让标题栏
        })
        .bindToScrollable(\[this.scroller\]) // 绑定导航组件和可滚动容器组件
        .titleMode(HdsNavigationTitleMode.MINI)
        .hideBackButton(true)
        // 设置标题栏动态显隐，包括设置标题区域，bottomBuilder区域，状态栏区域是否动态隐藏，隐藏模式以及开始隐藏时内容区的滚动距离。
        .dynamicHideTitleBar({
          hideTitleArea: true,
          hideBottomBuilder: true,
          hideStatusBar: false,
          mode: HideMode.SCROLL\_UP\_TO,
          hideOffset: 10
        })
      }
    }