Skip to content

Commit fca1418

Browse files
Material Design Teamdrchen
authored andcommitted
[Docs] Updated documentation with Expressive code/info for:
Bottom Navigation Common Button Docked Toolbar Extended Floating Action Button Floating Action Button Floating Toolbar Navigation Drawer PiperOrigin-RevId: 799044938
1 parent cc2390f commit fca1418

File tree

103 files changed

+535
-71
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

103 files changed

+535
-71
lines changed

docs/components/BottomNavigation.md

Lines changed: 38 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -9,14 +9,20 @@ path: /catalog/bottom-navigation/
99

1010
# Bottom navigation (Navigation bar)
1111

12-
**Note:** Bottom navigation has been renamed to navigation bar.
13-
1412
[Navigation bar](https://m3.material.io/components/navigation-bar/overview) lets
1513
people switch between UI views on smaller devices.
1614

17-
<img src="assets/bottomnav/navigationbar_hero.png" alt="Navigation bar with 4 icons.">
15+
**Note:** The design name of this component has been changed from **Bottom
16+
navigation** to **Navigation bar**. However, Material's Android implementation
17+
remains as `BottomNavigationView`.
18+
19+
<img src="assets/bottomnav/bottomnav-hero.png" alt="Navigation bar with 4 icons.">
1820
Navigation bar on compact and medium window sizes
1921

22+
Navigation bars can have three to five destinations. The nav bar is positioned
23+
at the bottom of screens for convenient access. Each destination is represented
24+
by an icon and label text.
25+
2026
**Note:** Images use various dynamic color schemes.
2127

2228
## Design & API documentation
@@ -26,7 +32,7 @@ Navigation bar on compact and medium window sizes
2632

2733
## Anatomy
2834

29-
![Navigation bar anatomy diagram](assets/bottomnav/navigationbar_anatomy.png)
35+
![Navigation bar anatomy diagram](assets/bottomnav/bottomnav-anatomy.png)
3036

3137
1. Container
3238
2. Icon
@@ -39,7 +45,9 @@ Navigation bar on compact and medium window sizes
3945
More details on anatomy items in the
4046
[component guidelines](https://m3.material.io/components/navigation-bar/guidelines#895b5b49-a166-4d30-90be-c71a4c970f04).
4147

42-
## M3 Expressive update
48+
## M3 Expressive
49+
50+
### M3 Expressive update
4351

4452
Before you can use `Material3Expressive` component styles, follow the
4553
[`Material3Expressive` themes setup instructions](https://github.com/material-components/material-components-android/tree/master/docs/getting-started.md#material3expressive-themes).
@@ -48,14 +56,35 @@ A new expressive style for the bottom navigation bar has been introduced that's
4856
shorter and supports horizontal navigation items in medium-sized windows.
4957
[More on M3 Expressive](https://m3.material.io/blog/building-with-m3-expressive)
5058

51-
<img src="assets/bottomnav/navigationbar_expressive.png" alt="Flexible horizontal navigation bar" width="700"/>
52-
The updated expressive navigation bar is shorter and can be used in medium
53-
windows with horizontal nav items
59+
<img src="assets/bottomnav/bottomnav-expressive.png" alt="Flexible horizontal navigation bar" width="700"/>
5460

5561
**Color:**
5662

5763
* Active label changed from **on-surface-variant** to **secondary**
5864

65+
### M3 Expressive styles
66+
67+
Changes from M3:
68+
69+
* Height: From 80dp to 64dp
70+
* Color: New expressive colors!
71+
* Top item padding: From 12dp to 6dp
72+
* Bottom item padding: From 16dp to 6dp
73+
* Label text is no longer bolded when selected
74+
* Active indicator: From 64dp to 56dp
75+
* New horizontal item configuration on medium and larger window sizes (greater
76+
than or equal to 600dp):
77+
* Icon moves from top to start of item
78+
* Instead of being a set width based on the item count, item width is
79+
based on content with a max width
80+
* Item gravity: From top center to center
81+
82+
The default style for bottom navigation bar is:
83+
84+
```xml
85+
<item name="bottomNavigationStyle">@style/Widget.Material3Expressive.BottomNavigationView</item>
86+
```
87+
5988
## Key properties
6089

6190
### Container attributes
@@ -304,7 +333,7 @@ Here's an example:
304333
app:menu="@menu/bottom_navigation_menu"/>
305334
```
306335

307-
<img src="assets/bottomnav/bottomnav_horizontal.png" alt="Horizontal navigation bar larger screens" height="100"/>
336+
<img src="assets/bottomnav/bottomnav-horizontal.png" alt="Horizontal navigation bar larger screens" height="100"/>
308337

309338
### Making navigation bar accessible
310339

0 commit comments

Comments
 (0)