目录

如何实现单页面的沉浸式效果

问题现象

A页面没有设置沉浸式模式,B页面设置了沉浸式模式。在A页面跳转B页面时使用setWindowLayoutFullScreen()方法让页面变沉浸式,在B页面的aboutToDisappear生命周期中退出沉浸式,回到A页面,发现A页面也进入了沉浸式模式,如何避免A页面因跳转B页面而进入沉浸式模式?

问题效果预览:

背景知识

沉浸式模式通常指让应用的界面更加专注于内容,不希望用户被无关元素干扰。实现沉浸式效果有如下两种方案:

解决方案

由于aboutToDisappear生命周期是异步回调,因此在B页面的aboutToDisappear生命周期中退出沉浸式,A页面也会看到沉浸式过渡为非沉浸式的效果。解决该问题可参考以下2种方案:

常见FAQ

Q:当页面存在悬浮子窗口时,使用下述方法实现沉浸式效果失效。

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

@Entry
@Component
struct Index {
  onPageShow(): void {
    window.getLastWindow(this.getUIContext().getHostContext(), (err, win) => {
      if (err) {
        return;
      }
      win.setWindowLayoutFullScreen(true);
    });
  }

  onPageHide(): void {
    window.getLastWindow(this.getUIContext().getHostContext(), (err, win) => {
      if (err) {
        return;
      }
      win.setWindowLayoutFullScreen(false);
    });
  }

  build() {
    Column() {
      Text('全屏页面....');
    }.width('100%').height('100%').backgroundColor(Color.Green);
  }
}

A:getLastWindow用于获取当前应用内最上层显示的子窗口,若无应用子窗口或子窗口未调用showWindow()进行显示,则返回应用主窗口。当页面存在子窗口时,可使用AppStorage存储windowStage,并在页面中获取该windowStage实例下的主窗口。

EntryAbility.ets:

onWindowStageCreate(windowStage: window.WindowStage): void {
  windowStage.loadContent('pages/Index', (err) => {
    if (err.code) {
      return;
    }
    // 保存windowStage,在页面中取出使用
    AppStorage.setOrCreate('windowStage', windowStage);
  });
}

Index.ets:

import { window } from '@kit.ArkUI'

@Entry
@Component
struct Index {
  onPageShow(): void {
    let windowStage = AppStorage.get('windowStage') as window.WindowStage;
    let windows = windowStage.getMainWindowSync();
    windows.setWindowLayoutFullScreen(true);
  }

  onPageHide(): void {
    let windowStage = AppStorage.get('windowStage') as window.WindowStage;
    let windows = windowStage.getMainWindowSync();
    windows.setWindowLayoutFullScreen(false);
  }

  build() {
    Column() {
      Text('全屏页面....');
    }.width('100%').height('100%').backgroundColor(Color.Green);
  }
}

总结

一般来说,整个应用(所有页面)都需要沉浸式效果,可以选择设置窗口全屏方案统一实现,针对具体页面的避让场景设置padding;单个页面或者仅需要将背景延伸到状态栏和导航栏,页面内容(子组件)希望避让状态栏和导航栏,使用expandSafeArea属性扩展对应组件安全区域来实现沉浸式效果更为方便。