预览窗口顶部和底部出现白边
=============

**问题现象**

预览窗口顶部和底部出现白边。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/0b/v3/yELQDhcVT-SogIM0Jh_hEg/zh-cn_image_0000002229603709.png?HW-CC-KV=V1&HW-CC-Date=20260612T074805Z&HW-CC-Expire=86400&HW-CC-Sign=C4BD78E58FFAFEE744D75F7200D45EDAD1BC09E16F74BBBAAC202CF3C1164A14)

**解决措施**

这是应用了沉浸式的特性，在沉浸式布局中，状态栏和导航条区域称为避让区，其余区域称为安全区。在默认情况下，开发者的组件被布局在安全区内。如果开发者希望将页面布局应用到全屏窗口，可以采用如下两种方式：

*   方法一：预览场景下，使用[expandSafeArea()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-universal-attributes-expand-safe-area#expandsafearea)扩展安全区域属性。
    
    //Index.ets
    @Entry
    @Component
    struct Index {
      @State message: string = 'Hello World';
    
    
      build() {
        RelativeContainer() {
          Text(this.message)
            .id('HelloWorld')
            .fontSize(50)
            .fontWeight(FontWeight.Bold)
            .alignRules({
              center: { anchor: '\_\_container\_\_', align: VerticalAlign.Center },
              middle: { anchor: '\_\_container\_\_', align: HorizontalAlign.Center }
            })
        }
        .height('100%')
        .width('100%')
        .backgroundColor('#008000')
        .expandSafeArea(\[SafeAreaType.SYSTEM\])
      }
    }
    

*   方法二：预览调试时，调用[setWindowLayoutFullScreen()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-window-window#setwindowlayoutfullscreen9)接口设置窗口全屏。
    
    // EntryAbility.ets
    onWindowStageCreate(windowStage: window.WindowStage): void {
      // Main window is created, set main page for this ability
      hilog.info(0x0000, 'testTag', '%{public}s', 'Ability onWindowStageCreate');
      windowStage.loadContent('pages/Index', (err) => {
        // ...
      });
      windowStage.getMainWindow((err, data) => {
        if (!err.code) {
          data.setWindowLayoutFullScreen(true)
        }
      });
    }
    

**参考链接**

[开发应用沉浸式效果](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-develop-apply-immersive-effects)