diff --git a/learn/react-native/edge-to-edge.md b/learn/react-native/edge-to-edge.md new file mode 100644 index 000000000..95e665a57 --- /dev/null +++ b/learn/react-native/edge-to-edge.md @@ -0,0 +1,166 @@ +--- +id: edge-to-edge-layout +title: Edge-to-Edge Layout & Auto-Hide Navbars +sidebar_label: Edge-to-Edge Layout & Auto-Hide Navbars +--- + +import scroll_both_e2e_transparent from '/learn/assets/react-native/edge-to-edge-apps/scroll_both_e2e_transparent.mp4'; +import scroll_none_e2e_false from '/learn/assets/react-native/edge-to-edge-apps/scroll_none_e2e_false.mp4'; +import scroll_none_e2e_true from '/learn/assets/react-native/edge-to-edge-apps/scroll_none_e2e_true.mp4'; +import scroll_both_e2e_false from '/learn/assets/react-native/edge-to-edge-apps/scroll_both_e2e_false.mp4'; +import deviceLight from '/learn/assets/react-native/device-light.png'; +import deviceDark from '/learn/assets/react-native/device-dark.png'; +import deviceE2ELight from '/learn/assets/react-native/device-e2e-light.png'; +import deviceE2EDark from '/learn/assets/react-native/device-e2e-dark.png'; +import ThemedImage from '@theme/ThemedImage'; +import edge_to_edge_page_level_props from '/learn/assets/react-native/edge-to-edge-page-level-config.png'; + +WaveMaker supports edge-to-edge layouts and auto-hide app navigation bars for mobile apps. These features provide a modern, immersive user experience and give developers precise control over layout and scroll behavior. These can be customized at app level and page level. + +
+ + +
+ +## Feature Summary + +| Feature | Description | Customization Support | +|------------------------|------------------------|------------------------| +| [Edge-to-Edge Layout](#edge-to-edge-layout) | Allows app content to render behind the system status and navigation bars. | App level | +| [Auto-Hide App Navbars](#auto-hide-navbars) | Enables top/bottom app navigation bars to hide or stay fixed during scroll. | App and page level +| [Status Bar Styling](#status-bar-styling) | Configure background color, opacity and blur of status bar. (Available only when using Edge-To-Edge UI with Auto-Hide App Navbars) | App level | +| [Status Bar Content Styling](#status-bar-style-android-only) | Configure status bar icon/text color in Android. iOS configuration is not required as iOS adjusts status bar appearance automatically based on background and theme.| Page level | +| [Device Navbar Styling](#navigation-bar-style-android-only) | Configure device navbar background in Android. iOS configuration is not required as iOS adjusts status bar appearance automatically based on background and theme. | Page level | + +## Edge-to-Edge Layout + +- By default, App takes the space between status bar and device navbar. +- You can change layout to edge-to-edge, to make the app render content behind status bar and device navbar, taking full advantage of the entire screen. This gives a sleek, modern feel and allows your app to better match today's immersive design trends. +- This can be configured globally, at app level. + +
+
+
+
+
+
+ +## Auto-Hide Navbars + +- By default app's top and bottom navbar is fixed. This can be customized using *Auto-Hide Navbars*. +- You can customise to make app's both top and bottom bar auto hide on scroll, or only top navbar. +- This can be configured at both app and individual page level. Page level config will take precedence over app level config for that page. + +
+
+
+
+
+
+ +## Status Bar Styling + +- When both edge-to-edge layout and auto-hide navbars is enabled, the content of the app will render behind status bar when app is scrolled up. +- Following styles of status bar can be customized here + 1. Background - We can configure Background type : Transparent/Blur, Background Color, Background Opacity + +## 1. App-Level Settings + +You can configure edge-to-edge and navbar scroll behavior globally from the Studio. + +### Location +**Studio → Settings → App Configurations** + +### Options Available + +| Setting | Description | +|-----------------------------|--------------------------------------------------------------| +| `Scroll Behavior`| Choose between Fixed or Hide app navbars on Scroll. Either only top app navbar or both top and bottom app navbar. | +| `Edge-to-Edge Display` | Enables content to extend behind system UI bars. | +| `Configure Status Bar (Optional)` | If both `Scroll Behavior` and `Edge-to-Edge Display` is enabled, we can configure system status bar background. (Background type : Transparent/Blur, Background Color, Background Opacity) | + +
+