目录

expandSafeArea常见问题

问题现象

安全区域是指页面的显示区域,默认情况下开发者开发的界面都布局在安全区域内,不与系统设置的避让区比如状态栏、导航栏区域重叠。如果希望组件内容可以扩展到非安全区域实现沉浸式效果,可以给组件设置expandSafeArea属性扩展其绘制区域至安全区外。expandSafeArea的部分使用场景和常见问题有哪些?

场景

场景说明

场景一:横屏下组件没有规避挖孔区域

横屏状态下,挖孔区域处于屏幕左侧或右侧,会出现挖孔区域遮挡内容的情况,需要控制边缘组件规避挖孔区域防止内容被遮挡。

场景二:TabContent设置expandSafeArea属性无法扩展至非安全区域

单独给TabContent设置expandSafeArea属性无法扩展至非安全区域。

场景三:使用expandSafeArea实现沉浸式,原有UI比例发生变化

组件内容扩展至非安全区域后,设置百分比高度的组件无法保持原有比例;设置固定高度的组件会在安全区域中产生空白。

场景四:给Canvas组件设置expandSafeArea属性,Canvas绘制内容无法扩展至底部导航条

给Canvas组件设置expandSafeArea属性,Canvas组件自身可以扩展至顶部状态栏和底部导航条,但其中绘制内容无法扩展至底部导航条。

场景一:横屏下组件没有规避挖孔区域。

问题现象图:

示例代码如下:

@Entry
@Component
struct Index {
  build() {
    RelativeContainer() {
      Row() {
        Text(`边缘控件`)
          .fontSize(30)
          .fontWeight(FontWeight.Bold)
          .width(30);
      }
      .justifyContent(FlexAlign.End)
      .height('100%')
      .width('100%')
      .backgroundColor('#f1f3f5');
    }
    .height('100%')
    .width('100%');
  }
}

场景二:TabContent设置expandSafeArea属性无法扩展至非安全区域。

问题现象图:

灰色为TabContent背景色。

示例代码如下:

@Entry
@Component
struct TabsExample {
  private controller: TabsController = new TabsController();

  build() {
    Column() {
      Tabs({ controller: this.controller }) {
        TabContent() {
          Column()
            .width('100%').height('100%').backgroundColor('#f1f3f5');
        }
        .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM]);

        TabContent() {
          Column().width('100%').height('100%').backgroundColor('#00CB87');
        };

        TabContent() {
          Column().width('100%').height('100%').backgroundColor('#FFBF00');
        };

        TabContent() {
          Column().width('100%').height('100%').backgroundColor('#E67C92');
        };
      }
      .barHeight(0)
      .width('100%')
      .height('100%');
    }
    .height('100%')
    .width('100%');
  }
}

场景三:使用expandSafeArea实现沉浸式,原有UI比例发生变化。

示例一:组件使用百分比高度时,由于状态栏高度与导航栏高度不一,扩展内容后会导致原有的UI比例发生变化。

问题现象图:

示例代码如下:

@Entry
@Component
struct Index4 {
  build() {
    Column() {
      Row()
        .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP])
        .width('100%')
        .height('50%')
        .backgroundColor('#E5E5EA');
      Row()
        .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.BOTTOM])
        .width('100%')
        .height('50%')
        .backgroundColor('#F1F3F5');
    }
    .height('100%')
    .width('100%');
  }
}

示例二:设置固定高度的组件会在安全区域中产生空白。

问题现象图:

示例代码如下:

@Entry
@Component
struct Index6 {
  build() {
    Column() {
      Column()
        .height(300)
        .width('100%')
        .backgroundColor('#E5E5EA')
        .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP]);

      Column()
        .layoutWeight(1)
        .width('100%')
        .backgroundColor('#F1F3F5')
        .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.BOTTOM]);
    }
    .height('100%')
    .width('100%');
  }
}

场景四:给Canvas组件设置expandSafeArea属性,Canvas绘制内容无法扩展至底部导航条。

问题效果图:

其中,灰色为Canvas背景色,已经扩展至底部导航条,但fillRect方法绘制的黑色矩形与底部导航条仍有一定距离。

示例代码如下:

import { display } from '@kit.ArkUI';

@Entry
@Component
struct CanvasExample {
  private settings: RenderingContextSettings = new RenderingContextSettings(true);
  private context: CanvasRenderingContext2D = new CanvasRenderingContext2D(this.settings);
  @State screenWidth: number = 0;
  @State screenHeight: number = 0;

  aboutToAppear() {
    display.getAllDisplays((err, data) => {
      let screenWidth: number = data[0].width;
      this.screenWidth = this.getUIContext().px2vp(screenWidth);
      let screenHeight: number = data[0].height;
      this.screenHeight = this.getUIContext().px2vp(screenHeight);
    });
  }

  build() {
    NavDestination() {
      Canvas(this.context)
        .expandSafeArea([SafeAreaType.SYSTEM], [SafeAreaEdge.TOP, SafeAreaEdge.BOTTOM])
        .width('100%')
        .height('100%')
        .backgroundColor('#f1f3f5')
        .onReady(() => {
          this.context.fillRect(0, 0, this.screenWidth, this.screenHeight);
        });
    }
    .width('100%')
    .height('100%');
  }
}

背景知识

解决方案

常见FAQ

Q:expandSafeArea属性的参数中,TOP、BOTTOM、START、END,是相对什么的?会受手机横竖屏的影响吗?

A:TOP是顶部,BOTTOM是底部,START是左侧,END是右侧,这些位置受手机横竖屏影响,例如,竖屏时,挖孔区域属于顶部,右旋转横屏后,挖孔区域位于右侧,如场景一中代码所示,需要组件内容扩展到右侧挖孔区域,需要向types参数中添加CUTOUT,edges参数中添加END。