feat(android): Add Statusbar.setOverlaysWebView method

android/capacitor/src/main/java/com/getcapacitor/plugin/StatusBar.java

@@ -116,4 +116,32 @@ public void getInfo(final PluginCall call) {
     data.put("color", String.format("#%06X", (0xFFFFFF & window.getStatusBarColor())));
     call.resolve(data);
   }
+
+  @PluginMethod()
+  public void setOverlaysWebView(final PluginCall call) {
+    final Boolean overlays = call.getBoolean("enabled", true);
+    getBridge().executeOnMainThread(new Runnable() {
+      @Override
+      public void run() {
+        if (overlays) {
+          // Sets the layout to a fullscreen one that does not hide the actual status bar, so the webview is displayed behind it.
+          View decorView = getActivity().getWindow().getDecorView();
+          int uiOptions = decorView.getSystemUiVisibility();
+          uiOptions = uiOptions | View.SYSTEM_UI_FLAG_LAYOUT_STABLE | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN;
+          decorView.setSystemUiVisibility(uiOptions);
+          getActivity().getWindow().setStatusBarColor(Color.TRANSPARENT);
+
+          call.success();
+        } else {
+          // Sets the layout to a normal one that displays the webview below the status bar.
+          View decorView = getActivity().getWindow().getDecorView();
+          int uiOptions = decorView.getSystemUiVisibility();
+          uiOptions = uiOptions | View.SYSTEM_UI_FLAG_LAYOUT_STABLE | View.SYSTEM_UI_FLAG_VISIBLE;
+          decorView.setSystemUiVisibility(uiOptions);
+          call.success();
+        }
+
+      }
+    });
+  }
 }

core/src/core-plugin-definitions.ts

@@ -1608,6 +1608,11 @@ export interface StatusBarPlugin extends Plugin {
    *  Get info about the current state of the status bar
    */
   getInfo(): Promise<StatusBarInfoResult>;
+  /**
+   *  Set whether or not the status bar should overlay the webview to allow usage of the space
+   *  around a device "notch"
+   */
+  setOverlaysWebView(options: StatusBarOverlaysWebviewOptions): Promise<void>;
 }
 
 export interface StatusBarStyleOptions {
@@ -1635,6 +1640,10 @@ export interface StatusBarInfoResult {
   color?: string;
 }
 
+export interface StatusBarOverlaysWebviewOptions {
+  enabled: boolean;
+}
+
 export interface StoragePlugin extends Plugin {
   /**
    * Get the value with the given key.

ios/Capacitor/Capacitor/Plugins/StatusBar.swift

@@ -75,5 +75,9 @@ public class CAPStatusBarPlugin: CAPPlugin {
       ])
     }
   }
+
+  @objc func setOverlaysWebView(_ call: CAPPluginCall) {
+    call.unimplemented()
+  }
 }
 

site/docs-md/apis/status-bar/index.md

@@ -49,6 +49,11 @@ export class StatusBarExample {
       style: this.isStatusBarLight ? StatusBarStyle.Dark : StatusBarStyle.Light
     });
     this.isStatusBarLight = !this.isStatusBarLight;
+
+    // Display content unter transparent status bar (Android only)
+    Statusbar.setOverlaysWebView({
+      enabled: true
+    })
   }
 
   hideStatusBar() {