You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/refguide/mobile/designing-mobile-user-interfaces/edge-to-edge.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,7 +11,7 @@ Edge-to-edge display is a modern Android design approach where your app's conten
11
11
12
12
## How Does Mendix Support Edge-to-Edge Display?
13
13
14
-
From Native template version 16.1.0, Mendix automatically implements edge-to-edge display following Google's recommendations to ensure your app looks modern and polished on Android devices. This means the Android status bar and navigation bar are transparent, allowing your app's design to shine through. System UI elements blend seamlessly with your app's design, creating a cohesive, polished appearance.
14
+
From Native template version 16.1.0 and Mendix Studio Pro version 11.6.0, Mendix automatically implements edge-to-edge display following Google's recommendations to ensure your app looks modern and polished on Android devices. This means the Android status bar and navigation bar are transparent, allowing your app's design to shine through. System UI elements blend seamlessly with your app's design, creating a cohesive, polished appearance.
Copy file name to clipboardExpand all lines: content/en/docs/refguide10/mobile/designing-mobile-user-interfaces/edge-to-edge.md
+60-67Lines changed: 60 additions & 67 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -9,46 +9,44 @@ description: "This guide explains how to implement edge-to-edge display in Mendi
9
9
10
10
Edge-to-edge display is a modern Android design approach where your app's content extends to the full screen, drawing behind the system bars (status bar at the top and navigation bar at the bottom). This creates a more immersive, modern look by utilizing the entire display area.
11
11
12
-
## What is Edge-to-Edge Display?
12
+
## How Does Mendix Support Edge-to-Edge Display?
13
13
14
-
Edge-to-edge display is a modern Android design approach where your app's content extends to the full screen, drawing behind the system bars (status bar at the top and navigation bar at the bottom). This creates a more immersive, modern look by utilizing the entire display area.
15
-
16
-
**With our latest update, we've made the Android status bar and navigation bar transparent**, allowing your app's design to shine through. This means:
14
+
From Native template version 14.1.0 and Mendix Studio Pro version 10.24.14, Mendix automatically implements edge-to-edge display following Google's recommendations to ensure your app looks modern and polished on Android devices. This means the Android status bar and navigation bar are transparent, allowing your app's design to shine through. System UI elements blend seamlessly with your app's design, creating a cohesive, polished appearance.
17
15
18
-
- The **status bar** takes on the color of your app's background (typically the header area)
19
-
- The **navigation bar** takes on the color of your app's bottom bar or main background
20
-
- System UI elements blend seamlessly with your app's design, creating a cohesive, polished appearance
16
+
### Status Bar Changes
21
17
22
-
### Visual Impact
18
+
The status bar has the following changes:
23
19
24
-
-**Status Bar**: Your app content extends behind the status bar (showing time, battery, notifications)
25
-
-**Navigation Bar**: Your app content extends behind the navigation bar (back, home, recent apps buttons)
26
-
-**Modern Appearance**: Creates a seamless, full-screen experience where system bars feel like part of your app's design
20
+
* It takes on the color of your app's background (typically the header area).
21
+
* Your app content extends behind the status bar (which shows items such as the time, battery charge, and notifications).
27
22
28
-
##How Mendix Handles Edge-to-Edge Display
23
+
### Navigation Bar Changes
29
24
30
-
Mendix automatically implements edge-to-edge display following Google's recommendations to ensure your app looks modern and polished on Android devices:
25
+
The navigation bar has the following changes making your app's bottom navigation appears unified with the Android system UI, creating the polished, edge-to-edge experience that Google recommends:
31
26
32
-
### Our Solution
27
+
* It is made transparent, allowing it to blend seamlessly with your app's design. In practice, this means the navigation bar takes on the background color of your bottom bar, making it appear as an integrated part of your app rather than a separate system element.
28
+
* Your app content extends behind the navigation bar which contains the back, home, and recent apps buttons.
29
+
* The height is automatically adjusted. When the Android navigation bar is present, your app automatically detects its height and adds it to your bottom bar height. This dynamic adjustment ensures that your bottom bar content remains fully visible and accessible, preventing any overlap with the system navigation buttons.
33
30
34
-
1.**Transparent Navigation Bar**: We make the Android navigation bar transparent, allowing it to blend seamlessly with your app's design. This means the navigation bar takes on the background color of your bottom bar, making it appear as an integrated part of your app rather than a separate system element.
31
+
## What This Means for You
35
32
36
-
2.**Automatic Height Adjustment**: When the Android navigation bar is present, we automatically detect its height and add it to your bottom bar height. This dynamic adjustment ensures that your bottom bar content remains fully visible and accessible, preventing any overlap with the system navigation buttons.
33
+
Mendix Native template 14.1.0 automatically provides you with an edge-to-edge display experience with the following features.
37
34
38
-
3.**Seamless Integration**: By combining transparency with height calculation, your app's bottom navigation appears unified with the Android system UI, creating the polished, edge-to-edge experience that Google recommends.
35
+
***No Manual Calculations**: You don't need to worry about calculating insets or adjusting for different device configurations
36
+
***Automatic Adaptation**: The bottom bar automatically adjusts its height based on whether the navigation bar is visible
37
+
***Consistent Appearance**: Your app maintains a modern, cohesive look across all Android devices
39
38
40
-
### What This Means for You
39
+
{{% alert color="info" %}}
40
+
You may need to set a height for your bottom bar if you have customized it. See [Adjusting the Bottom Bar Layout](#adjust-bottom) for more information.
41
+
{{% /alert %}}
41
42
42
-
-**No Manual Calculations**: You don't need to worry about calculating insets or adjusting for different device configurations
43
-
-**Automatic Adaptation**: The bottom bar automatically adjusts its height based on whether the navigation bar is visible
44
-
-**Consistent Appearance**: Your app maintains a modern, cohesive look across all Android devices
45
-
-**Suggested** You may need to set certain height to your bottom bar if you've customized it.
46
-
47
-
## ⚠️ Important Warnings and Responsibilities
43
+
## Important Warnings and Responsibilities
48
44
49
45
### Common Issues to Avoid
50
46
51
-
#### ❌ DO NOT: Place Buttons Near Android Navigation Bar
47
+
{{% alert color="warning" %}}
48
+
49
+
#### Do Not Place Buttons Near the Android Navigation Bar
**Solution**: Add sufficient padding/margin at the bottom of your layouts to account for the navigation bar height.
66
64
67
-
## Configuration via custom-variables.js
65
+
{{% /alert %}}
68
66
69
-
Find `// Navigation Styles` within custom-variables.js, where you can adjust the proper design according to your needs. You can find the navigation section here.
67
+
## Configuration via `custom-variables.js`
70
68
71
-
### Location
72
-
```
73
-
<your-native-template>/src/custom-variables.js
74
-
```
69
+
Find `// Navigation Styles` within `custom-variables.js`, where you can adjust the proper design according to your needs. The configuration JavaScript is usually located in `<your-native-template>/src/custom-variables.js`
75
70
76
-
## Adjusting Bottom Bar Layout (If Needed)
71
+
## Adjusting the Bottom Bar Layout {#adjust-bottom}
77
72
78
-
### When You Might Need This
73
+
### When Might You Need This?
79
74
80
-
If you've customized your bottom navigation bar and notice layout issues after enabling edge-to-edge display (such as icons or labels appearing cut off or misaligned), you may need to adjust the bottom bar styling.
75
+
If you have customized your bottom navigation bar and notice layout issues after enabling edge-to-edge display (such as icons or labels appearing cut off or misaligned), you may need to adjust the bottom bar styling.
81
76
82
-
### Solution: Custom Navigation Styles
77
+
Because the navigation bar is now transparent and your app content extends behind it, any custom bottom bar configurations you previously had may need slight adjustments to account for the new layout. The transparent navigation bar means your bottom bar needs to ensure adequate spacing and sizing for all its elements to remain visible and accessible.
83
78
84
-
Add or modify the following configuration in your `main.js` file to fine-tune the bottom bar appearance:
79
+
### Solution: Custom Navigation Styles
85
80
86
-
```javascript
87
-
exportconstnavigationStyle= {
88
-
bottomBar: {
89
-
container: {
90
-
height:60,
91
-
},
92
-
label: {
93
-
fontSize:18,
94
-
},
95
-
selectedLabel: {
96
-
fontSize:18,
97
-
},
98
-
icon: {
99
-
size:25
81
+
Add or modify the configuration in your `main.js` file to fine-tune the bottom bar appearance by doing the following:
82
+
83
+
1. Copy the following configuration into your `main.js` file:
84
+
85
+
```javascript
86
+
exportconstnavigationStyle= {
87
+
bottomBar: {
88
+
container: {
89
+
height:60,
90
+
},
91
+
label: {
92
+
fontSize:18,
93
+
},
94
+
selectedLabel: {
95
+
fontSize:18,
96
+
},
97
+
icon: {
98
+
size:25
99
+
},
100
+
selectedIcon: {
101
+
size:25
102
+
}
100
103
},
101
-
selectedIcon: {
102
-
size:25
103
-
}
104
-
},
105
-
};
106
-
```
107
-
108
-
### How to Use
109
-
110
-
1.**Copy** the configuration above into your `main.js` file
111
-
2.**Adjust** the values to match your needs:
112
-
-`height`: Increase if your bottom bar content is too close to the Android navigation bar or decrease if it's far away.
113
-
-`label`: Adjust label text size for cases where the Android navigation bar is close to your bottom bar (if height doesn't solve the problem)
114
-
-`icon`: Adjust icon size for cases where the Android navigation bar is close to your bottom bar (if height doesn't solve the problem)
104
+
};
105
+
```
115
106
116
-
3.**Test** on various Android devices to ensure the layout works well across different screen sizes
107
+
2. Adjust the following values to match your needs:
117
108
118
-
### Why This Might Be Necessary
109
+
*`height`: Increase if your bottom bar content is too close to the Android navigation bar or decrease if it's far away.
110
+
* `label`: Adjust label text size for cases where the Android navigation bar is close to your bottom bar (if height doesn't solve the problem)
111
+
*`icon`: Adjust icon size for cases where the Android navigation bar is close to your bottom bar (if height doesn't solve the problem)
119
112
120
-
Because the navigation bar is now transparent and your app content extends behind it, any custom bottom bar configurations you previously had may need slight adjustments to account for the new layout. The transparent navigation bar means your bottom bar needs to ensure adequate spacing and sizing for all its elements to remain visible and accessible.
113
+
3. Test your modified configuration on various Android devices to ensure the layout works well across different screen sizes.
0 commit comments