capacitor-plugin-status-bar 2.0.10 → 2.0.12

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

@@ -21,7 +21,6 @@ import androidx.core.view.WindowInsetsCompat;
 
 import com.getcapacitor.Plugin;
 
-
 /**
  * Android Status Bar utilities with Android 10-15+ (API 29-35+) support.
  * Supports:
@@ -42,39 +41,39 @@ public class CapacitorStatusBar extends Plugin {
     private int currentStatusBarColor = Color.BLACK;
     private int currentNavBarColor = Color.BLACK;
 
-    // Note: load() is not called since CapacitorStatusBar is instantiated via new CapacitorStatusBar()
+    // Note: load() is not called since CapacitorStatusBar is instantiated via new
+    // CapacitorStatusBar()
     // from CapacitorStatusBarPlugin, not registered as a Capacitor plugin itself.
-    // All initialization happens via ensureEdgeToEdgeConfigured() called from CapacitorStatusBarPlugin.load().
+    // All initialization happens via ensureEdgeToEdgeConfigured() called from
+    // 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();
@@ -85,27 +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 + ")");
                     }
                 }
 
-                ViewCompat.onApplyWindowInsets(v, insets);
-                return insets;
+                // 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 + ")");
+                    }
+                }
+
+                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);
@@ -157,57 +178,42 @@ public class CapacitorStatusBar extends Plugin {
         showNavigationBar(activity, true);
     }
 
-    public void hideStatusBar(Activity activity, String animation) {
-        Log.d(TAG, "hideStatusBar: animation=" + animation + ", API=" + Build.VERSION.SDK_INT);
+    public void hideStatusBar(Activity activity) {
         Window window = activity.getWindow();
         View decorView = window.getDecorView();
 
-        String animationType = animation != null ? animation.toLowerCase() : "slide";
-
-        if ("fade".equals(animationType)) {
-            // Fade mode: Make background transparent without removing status bar and
-            // navigation bar
-            Log.d(TAG, "hideStatusBar: fade mode - making backgrounds transparent");
-            makeStatusBarBackgroundTransparent(activity);
-            hideNavigationBar(activity, "fade");
-        } else if ("slide".equals(animationType)) {
-            // Slide mode: Hide status bar and navigation bar completely (current behavior)
-            Log.d(TAG, "hideStatusBar: slide mode - hiding bars completely");
+        // Slide mode: Hide status bar and navigation bar completely (current behavior)
+        Log.d(TAG, "hideStatusBar: slide mode - hiding bars completely");
 
-            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
-                // API 30+ (Android 11+) - Use WindowInsetsController
-                WindowInsetsController controller = window.getInsetsController();
-                if (controller != null) {
-                    Log.d(TAG, "hideStatusBar: hiding system bars (API 30+)");
-                    // Hide both status and navigation bars together
-                    controller.hide(WindowInsets.Type.systemBars());
-                    // Set behavior for immersive mode (user can swipe to reveal temporarily)
-                    controller.setSystemBarsBehavior(
-                            WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE);
-                } else {
-                    Log.w(TAG, "hideStatusBar: WindowInsetsController is null");
-                }
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
+            // API 30+ (Android 11+) - Use WindowInsetsController
+            WindowInsetsController controller = window.getInsetsController();
+            if (controller != null) {
+                Log.d(TAG, "hideStatusBar: hiding system bars (API 30+)");
+                // Hide both status and navigation bars together
+                controller.hide(WindowInsets.Type.systemBars());
+                // Set behavior for immersive mode (user can swipe to reveal temporarily)
+                controller.setSystemBarsBehavior(
+                        WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE);
             } else {
-                // API 29 (Android 10) - Use system UI visibility flags (deprecated but
-                // necessary)
-                Log.d(TAG, "hideStatusBar: hiding using system UI flags (API 29)");
-                // Use immersive sticky mode with proper layout flags for Android 10
-                decorView.setSystemUiVisibility(
-                        View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
-                                | View.SYSTEM_UI_FLAG_LAYOUT_STABLE
-                                | View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
-                                | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
-                                | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
-                                | View.SYSTEM_UI_FLAG_FULLSCREEN);
+                Log.w(TAG, "hideStatusBar: WindowInsetsController is null");
             }
-
-            // Make the overlay backgrounds transparent so content shows through
-            makeStatusBarBackgroundTransparent(activity);
         } else {
-            // Unknown animation type, default to slide
-            Log.w(TAG, "hideStatusBar: unknown animation type '" + animationType + "', defaulting to slide");
-            hideStatusBar(activity, "slide");
+            // API 29 (Android 10) - Use system UI visibility flags (deprecated but
+            // necessary)
+            Log.d(TAG, "hideStatusBar: hiding using system UI flags (API 29)");
+            // Use immersive sticky mode with proper layout flags for Android 10
+            decorView.setSystemUiVisibility(
+                    View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
+                            | View.SYSTEM_UI_FLAG_LAYOUT_STABLE
+                            | View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
+                            | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
+                            | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
+                            | View.SYSTEM_UI_FLAG_FULLSCREEN);
         }
+
+        // Make the overlay backgrounds transparent so content shows through
+        makeStatusBarBackgroundTransparent(activity);
     }
 
     public void setStyle(Activity activity, String style, @Nullable String colorHex) {
@@ -262,7 +268,8 @@ public class CapacitorStatusBar extends Plugin {
         }
 
         // Set icon appearance AFTER background operations.
-        // On Android 13 (API 33), applyStatusBarBackground triggers requestApplyInsets()
+        // On Android 13 (API 33), applyStatusBarBackground triggers
+        // requestApplyInsets()
         // which causes the WindowInsetsController to reset setSystemBarsAppearance.
         // Calling setLightStatusBarIcons last ensures the icon style is not overridden.
         setLightStatusBarIcons(window, lightBackground);
@@ -291,7 +298,8 @@ public class CapacitorStatusBar extends Plugin {
      * Returns the insets for status bar, navigation bar, and notch areas.
      *
      * @param activity The activity to get the insets from
-     * @return A map containing top, bottom, left, and right inset values in dp (density-independent pixels)
+     * @return A map containing top, bottom, left, and right inset values in dp
+     *         (density-independent pixels)
      */
     public java.util.Map<String, Integer> getSafeAreaInsets(Activity activity) {
         Log.d(TAG, "getSafeAreaInsets");
@@ -302,10 +310,12 @@ public class CapacitorStatusBar extends Plugin {
         WindowInsetsCompat windowInsets = ViewCompat.getRootWindowInsets(decorView);
 
         if (windowInsets != null) {
-            // Use WindowInsetsCompat for accurate, type-specific insets across all API levels
+            // Use WindowInsetsCompat for accurate, type-specific insets across all API
+            // levels
             androidx.core.graphics.Insets statusBars = windowInsets.getInsets(WindowInsetsCompat.Type.statusBars());
             androidx.core.graphics.Insets navBars = windowInsets.getInsets(WindowInsetsCompat.Type.navigationBars());
-            androidx.core.graphics.Insets displayCutout = windowInsets.getInsets(WindowInsetsCompat.Type.displayCutout());
+            androidx.core.graphics.Insets displayCutout = windowInsets
+                    .getInsets(WindowInsetsCompat.Type.displayCutout());
 
             int topPx = Math.max(statusBars.top, displayCutout.top);
             int bottomPx = Math.max(navBars.bottom, displayCutout.bottom);
@@ -499,12 +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);
         }
     }
@@ -512,13 +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);
         }
     }
@@ -547,7 +557,8 @@ public class CapacitorStatusBar extends Plugin {
             overlay.setLayoutParams(lp);
 
             decorView.addView(overlay);
-            // Sizing updates are handled by the unified listener in ensureEdgeToEdgeConfigured
+            // Sizing updates are handled by the unified listener in
+            // ensureEdgeToEdgeConfigured
             decorView.requestApplyInsets();
         } else {
             Log.d(TAG, "ensureStatusBarOverlay: updating existing overlay");
@@ -597,7 +608,8 @@ public class CapacitorStatusBar extends Plugin {
             overlay.setLayoutParams(lp);
 
             decorView.addView(overlay);
-            // Sizing updates are handled by the unified listener in ensureEdgeToEdgeConfigured
+            // Sizing updates are handled by the unified listener in
+            // ensureEdgeToEdgeConfigured
             decorView.requestApplyInsets();
         } else {
             Log.d(TAG, "ensureNavBarOverlay: updating existing overlay");
@@ -623,9 +635,9 @@ public class CapacitorStatusBar extends Plugin {
     }
 
     private void applyWindowBackground(Activity activity, @ColorInt int color) {
-        Log.d(TAG, "applyWindowBackground: color=#" + Integer.toHexString(color));
+        Log.d(TAG, "applyWindowBackground: body is always transparent; status/nav bars use overlays/native APIs");
         View decorView = activity.getWindow().getDecorView();
-        decorView.setBackgroundColor(color);
+        decorView.setBackgroundColor(Color.TRANSPARENT);
     }
 
     /**
@@ -637,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);
@@ -650,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;
-                });
-            }
         });
     }
 
@@ -71,7 +55,7 @@ public class CapacitorStatusBarPlugin extends Plugin {
     public void hide(PluginCall call) {
         try {
             getActivity().runOnUiThread(() -> {
-                implementation.hideStatusBar(getActivity(), "slide");
+                implementation.hideStatusBar(getActivity());
                 call.resolve();
             });
         } catch (Exception e) {

package/ios/Sources/CapacitorStatusBarPlugin/CapacitorStatusBar.swift

@@ -227,8 +227,8 @@ import Capacitor
                 return
             }
 
-            window.backgroundColor = color
-            print("CapacitorStatusBar: setBackground - Set window background to \(colorHex)")
+            window.backgroundColor = .clear
+            print("CapacitorStatusBar: setBackground - Body is always transparent; status/nav bars use overlays/native APIs")
         }
     }
 
@@ -237,20 +237,15 @@ import Capacitor
             var insets: [String: CGFloat] = ["top": 0, "bottom": 0, "left": 0, "right": 0]
 
             if let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
-               let window = windowScene.windows.first {
-                // Use statusBarManager for accurate status bar height
-                let statusBarHeight = windowScene.statusBarManager?.statusBarFrame.height ?? 0
+               let window = windowScene.windows.first(where: { $0.isKeyWindow }) ?? windowScene.windows.first {
                 let safeAreaInsets = window.safeAreaInsets
 
-                // top: status bar height specifically
-                insets["top"] = statusBarHeight
-                // bottom: home indicator / navigation bar area
-                insets["bottom"] = safeAreaInsets.bottom
-                // left/right: safe area for landscape / display cutouts
-                insets["left"] = safeAreaInsets.left
-                insets["right"] = safeAreaInsets.right
+                insets["top"] = self.sanitizedInsetValue(safeAreaInsets.top)
+                insets["bottom"] = 0
+                insets["left"] = 0
+                insets["right"] = 0
 
-                print("CapacitorStatusBar: getSafeAreaInsets - top=\(statusBarHeight), bottom=\(safeAreaInsets.bottom), left=\(safeAreaInsets.left), right=\(safeAreaInsets.right)")
+                print("CapacitorStatusBar: getSafeAreaInsets - top=\(safeAreaInsets.top), bottom=\(safeAreaInsets.bottom), left=\(safeAreaInsets.left), right=\(safeAreaInsets.right)")
             } else {
                 print("CapacitorStatusBar: getSafeAreaInsets - Unable to get window, returning zero insets")
             }
@@ -399,6 +394,12 @@ import Capacitor
         return (0.299 * red + 0.587 * green + 0.114 * blue)
     }
 
+    /// Guard against non-finite/negative inset values before bridging to JS.
+    private func sanitizedInsetValue(_ value: CGFloat) -> CGFloat {
+        guard value.isFinite else { return 0 }
+        return max(0, value)
+    }
+
     private func isSystemInDarkMode() -> Bool {
         guard let windowScene = UIApplication.shared.connectedScenes.first as? UIWindowScene,
               let window = windowScene.windows.first else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "capacitor-plugin-status-bar",
-  "version": "2.0.10",
+  "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",