Bottom App Bar
Bottom app bars display primary actions at the bottom of the screen. Supports standard layout and with-FAB cutout variant for prominent primary actions. Not intended for large navigation sets where a dedicated navigation bar should be used.
Basic Usage (Standard)
Default bottom app bar with action buttons aligned to the right. It keeps high-frequency actions reachable on mobile layouts.
<ds-app-bar-bottom> <button slot="actions" aria-label="Search" class="material-symbols-outlined">search</button> <button slot="actions" aria-label="More" class="material-symbols-outlined">more_vert</button> </ds-app-bar-bottom>
Initial Value
Actions are populated from slot content. Multiple buttons display in order from left to right.
<ds-app-bar-bottom> <button slot="actions" aria-label="Save" class="material-symbols-outlined">save</button> <button slot="actions" aria-label="Undo" class="material-symbols-outlined">undo</button> <button slot="actions" aria-label="Redo" class="material-symbols-outlined">redo</button> </ds-app-bar-bottom>
With FAB Cutout
The with-fab variant creates a centered cutout for a floating action button, emphasizing a primary action.
<ds-app-bar-bottom variant="with-fab"> <button slot="fab" aria-label="Add" class="fab-button">add</button> <button slot="actions" aria-label="Favorites" class="material-symbols-outlined">favorite</button> <button slot="actions" aria-label="Music" class="material-symbols-outlined">music_note</button> </ds-app-bar-bottom>
Variants
Choose between standard and with-fab layouts.
Standard
With FAB
Interactive Example
Click actions to see state changes. FAB appears centered.
Last action: None
Usage Guidelines
When to Use
- Quick access to secondary actions at bottom of screen
- Mobile-friendly action placement (thumb reach)
- Prominent primary action with with-fab variant
Best Practices
- Keep it simple: Limit to 2-4 action buttons
- Use with-fab: For one prominent primary action
- Icon buttons: Use Material Symbols with aria-labels
- Mobile first: Position actions within thumb reach
When Not to Use
- Top-level navigation (use top app bar instead)
- More than one primary action (FAB is for single primary action)
- On pages without significant bottom space
API
DSAppBarBottom
Container for bottom app bar variants.
Attributes
| Attribute | Type | Default | Description |
|---|---|---|---|
variant |
"standard" | "with-fab" | "standard" | Layout variant (with or without FAB cutout) |
Slots
| Slot | Description |
|---|---|
actions |
Trailing action buttons (right side) |
fab |
FAB element (center cutout, with-fab variant only) |
CSS Parts
| Part | Description |
|---|---|
container |
App bar container |
fab-area |
FAB cutout area (with-fab variant) |
actions |
Trailing actions region |
CSS Custom Properties
| Property | Default | Description |
|---|---|---|
--ds-app-bar-bg |
--md-sys-color-surface |
Background color |
--ds-app-bar-color |
--md-sys-color-on-surface |
Foreground color |
--ds-app-bar-shadow |
0 4px 12px rgba(0,0,0,0.12) |
Box shadow/elevation |
Accessibility
-
Landmark: App bar uses
role="contentinfo" -
Actions: Provide clear
aria-labelfor each action button -
FAB: Ensure FAB has descriptive
aria-labelfor primary action - Keyboard: Tab to buttons, activate with Enter/Space
- Focus: Visible focus rings on all controls