capacitor-plugin-status-bar 2.0.11 → 2.0.12

package/android/src/main/java/com/cap/plugins/statusbar/CapacitorStatusBar.java

@@ -48,37 +48,32 @@ public class CapacitorStatusBar extends Plugin {
     // CapacitorStatusBarPlugin.load().
 
     /**
-     * Ensures edge-to-edge is properly configured for Android 15+.
-     * Sets up a unified insets listener on the decorView that handles both
-     * IME insets and overlay view sizing.
+     * Ensures edge-to-edge is properly configured for Android 12+.
+     * Sets up a unified insets listener on the decorView that handles
+     * overlay view sizing and WebView padding so content stays within
+     * the safe area.
      *
      * @param activity The activity to configure
+     * @param webView  The Capacitor WebView to apply safe-area padding to (may be null)
      */
-    public void ensureEdgeToEdgeConfigured(Activity activity) {
+    public void ensureEdgeToEdgeConfigured(Activity activity, @Nullable View webView) {
         Window window = activity.getWindow();
         View decorView = window.getDecorView();
 
         if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
-            // Android 12+ (API 31+): enable edge-to-edge layout.
-            // The nav bar uses overlay views because gesture navigation ignores
-            // setNavigationBarColor().
-            // The status bar still uses setStatusBarColor() reliably on API 31–34;
-            // overlay is only needed on API 35+ where edge-to-edge is enforced and the
-            // native API is a no-op.
             WindowCompat.setDecorFitsSystemWindows(window, false);
 
-            // Set a transparent baseline; setStyle() will apply the actual color via
-            // setStatusBarColor()
-            // (API 31-34) or the status bar overlay (API 35+).
             window.setStatusBarColor(Color.TRANSPARENT);
             window.setNavigationBarColor(Color.TRANSPARENT);
             window.setStatusBarContrastEnforced(false);
             window.setNavigationBarContrastEnforced(false);
 
-            // Single unified insets listener on decorView for overlay sizing
             ViewCompat.setOnApplyWindowInsetsListener(decorView, (v, insets) -> {
-                // Size status bar overlay
                 int top = insets.getInsets(WindowInsetsCompat.Type.statusBars()).top;
+                int navBottom = insets.getInsets(WindowInsetsCompat.Type.navigationBars()).bottom;
+                boolean imeVisible = insets.isVisible(WindowInsetsCompat.Type.ime());
+
+                // Size status bar overlay
                 View statusOverlay = ((ViewGroup) v).findViewWithTag(STATUS_BAR_OVERLAY_TAG);
                 if (statusOverlay != null) {
                     ViewGroup.LayoutParams params = statusOverlay.getLayoutParams();
@@ -89,29 +84,49 @@ public class CapacitorStatusBar extends Plugin {
                     }
                 }
 
-                // Size navigation bar overlay
-                int bottom = insets.getInsets(WindowInsetsCompat.Type.navigationBars()).bottom;
+                // Size navigation bar overlay — collapse it when the keyboard is
+                // open since the nav bar is hidden behind the IME.
+                int overlayBottom = imeVisible ? 0 : navBottom;
                 View navOverlay = ((ViewGroup) v).findViewWithTag(NAV_BAR_OVERLAY_TAG);
                 if (navOverlay != null) {
                     ViewGroup.LayoutParams params = navOverlay.getLayoutParams();
-                    if (params.height != bottom) {
-                        params.height = bottom;
+                    if (params.height != overlayBottom) {
+                        params.height = overlayBottom;
                         navOverlay.setLayoutParams(params);
-                        Log.d(TAG, "insetsListener: nav bar overlay height=" + bottom);
+                        Log.d(TAG, "insetsListener: nav bar overlay height=" + overlayBottom
+                                + " (imeVisible=" + imeVisible + ")");
+                    }
+                }
+
+                // Inset the WebView via layout margins so it never renders behind
+                // system bars. When the keyboard is open the nav bar is behind the
+                // IME, so drop the bottom margin to avoid a gap above the keyboard.
+                if (webView != null
+                        && webView.getLayoutParams() instanceof ViewGroup.MarginLayoutParams) {
+                    ViewGroup.MarginLayoutParams mlp =
+                            (ViewGroup.MarginLayoutParams) webView.getLayoutParams();
+                    int left = insets.getInsets(WindowInsetsCompat.Type.systemBars()).left;
+                    int right = insets.getInsets(WindowInsetsCompat.Type.systemBars()).right;
+                    int bottomMargin = imeVisible ? 0 : navBottom;
+                    if (mlp.topMargin != top || mlp.bottomMargin != bottomMargin
+                            || mlp.leftMargin != left || mlp.rightMargin != right) {
+                        mlp.topMargin = top;
+                        mlp.bottomMargin = bottomMargin;
+                        mlp.leftMargin = left;
+                        mlp.rightMargin = right;
+                        webView.setLayoutParams(mlp);
+                        Log.d(TAG, "insetsListener: webView margins t=" + top
+                                + " b=" + bottomMargin + " l=" + left + " r=" + right
+                                + " (imeVisible=" + imeVisible + ")");
                     }
                 }
 
-                ViewCompat.onApplyWindowInsets(v, insets);
-                return insets;
+                return WindowInsetsCompat.CONSUMED;
             });
 
+            decorView.requestApplyInsets();
             Log.d(TAG, "ensureEdgeToEdgeConfigured: edge-to-edge with overlay views, API=" + Build.VERSION.SDK_INT);
         } else {
-            // Android < 12 (API < 31): Only disable contrast enforcement.
-            // Do NOT call setDecorFitsSystemWindows(false), create overlay views, or set
-            // insets listener.
-            // This avoids conflicts with plugins like
-            // @capawesome/capacitor-android-edge-to-edge-support.
             if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.Q) {
                 window.setStatusBarContrastEnforced(false);
                 window.setNavigationBarContrastEnforced(false);
@@ -494,15 +509,12 @@ public class CapacitorStatusBar extends Plugin {
 
     private void applyStatusBarBackground(Activity activity, @ColorInt int color) {
         Log.d(TAG, "applyStatusBarBackground: color=#" + Integer.toHexString(color) + ", API=" + Build.VERSION.SDK_INT);
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.VANILLA_ICE_CREAM) {
-            // Android 15+ (API 35+): edge-to-edge is enforced, setStatusBarColor() is a
-            // no-op
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+            // API 31+: edge-to-edge is enabled, setStatusBarColor() is unreliable.
+            // Use an overlay View drawn on top of the status bar area.
             ensureStatusBarOverlay(activity, color);
         } else {
-            // API 29–34: setStatusBarColor() works reliably for the status bar on all
-            // navigation modes.
-            // Note: gesture navigation only ignores setNavigationBarColor(), not
-            // setStatusBarColor().
+            // API 29–30: no edge-to-edge, native API works reliably.
             activity.getWindow().setStatusBarColor(color);
         }
     }
@@ -510,15 +522,13 @@ public class CapacitorStatusBar extends Plugin {
     private void applyNavigationBarBackground(Activity activity, @ColorInt int color) {
         Log.d(TAG, "applyNavigationBarBackground: color=#" + Integer.toHexString(color) + ", API="
                 + Build.VERSION.SDK_INT);
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.VANILLA_ICE_CREAM) {
-            // Android 15+ (API 35+): edge-to-edge enforced, setNavigationBarColor() is a
-            // no-op
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+            // API 31+: edge-to-edge is enabled, setNavigationBarColor() is unreliable
+            // (especially gesture navigation which ignores it entirely).
+            // Use an overlay View drawn at the bottom of the screen.
             ensureNavBarOverlay(activity, color);
         } else {
-            // API 29–34: setNavigationBarColor() works for button navigation.
-            // Gesture navigation ignores it (system enforces transparency for gesture
-            // handles),
-            // but in that case there is no visible nav bar to color anyway.
+            // API 29–30: no edge-to-edge, native API works for button navigation.
             activity.getWindow().setNavigationBarColor(color);
         }
     }
@@ -639,8 +649,8 @@ public class CapacitorStatusBar extends Plugin {
         Window window = activity.getWindow();
         ViewGroup decorView = (ViewGroup) window.getDecorView();
 
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.VANILLA_ICE_CREAM) {
-            // Android 15+: both bars use overlay views
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+            // API 31+: edge-to-edge uses overlay views for both bars
             View statusBarOverlay = decorView.findViewWithTag(STATUS_BAR_OVERLAY_TAG);
             if (statusBarOverlay != null) {
                 statusBarOverlay.setBackgroundColor(Color.TRANSPARENT);
@@ -652,7 +662,7 @@ public class CapacitorStatusBar extends Plugin {
                 Log.d(TAG, "makeStatusBarBackgroundTransparent: nav bar overlay made transparent");
             }
         } else {
-            // API 29–34: both bars use native window API
+            // API 29–30: no edge-to-edge, native window API
             window.setStatusBarColor(Color.TRANSPARENT);
             window.setNavigationBarColor(Color.TRANSPARENT);
             Log.d(TAG, "makeStatusBarBackgroundTransparent: set native bar colors to transparent");

package/android/src/main/java/com/cap/plugins/statusbar/CapacitorStatusBarPlugin.java

@@ -1,12 +1,7 @@
 package com.cap.plugins.statusbar;
 
-import android.os.Build;
 import android.view.View;
 
-import androidx.core.graphics.Insets;
-import androidx.core.view.ViewCompat;
-import androidx.core.view.WindowInsetsCompat;
-
 import com.getcapacitor.Plugin;
 import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
@@ -19,21 +14,10 @@ public class CapacitorStatusBarPlugin extends Plugin {
     @Override
     public void load() {
         super.load();
-        // Apply default style based on system theme on plugin load
         getActivity().runOnUiThread(() -> {
-            implementation.ensureEdgeToEdgeConfigured(getActivity());
+            View webView = getBridge().getWebView();
+            implementation.ensureEdgeToEdgeConfigured(getActivity(), webView);
             implementation.applyDefaultStyle(getActivity());
-
-            // On Android 15+ (API 35+), edge-to-edge is enforced and the WebView content
-            // extends under system bars. Apply padding so Ionic content stays in the safe area.
-            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.VANILLA_ICE_CREAM) {
-                View webView = getBridge().getWebView();
-                ViewCompat.setOnApplyWindowInsetsListener(webView, (v, insets) -> {
-                    Insets systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
-                    v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom);
-                    return insets;
-                });
-            }
         });
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capacitor-plugin-status-bar",
-  "version": "2.0.11",
+  "version": "2.0.12",
   "description": "Capacitor plugin for managing the status bar style, visibility, and color on iOS and Android. Control overlay modes, background colors, and appearance for native mobile applications.",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",