Bottom Navigation
stableBottom tab-style navigation.
Basic usage
Examples
Three destinations
BottomNavigation uses tab semantics and controlled/uncontrolled selected value.
Controlled value
Use value and onValueChange when route state owns the selected item.
Icons and labels
Use showLabels on the root or showLabel per item.
Features
- Controlled or uncontrolled.
- Selected item state.
Installation
bash
pnpm dlx structyl add bottom-navigationAPI Reference
BottomNavigation.Root
Bottom tablist root.
| Prop | Type | Default |
|---|---|---|
| value | defaultValue | stringControlled or uncontrolled selected value. | — |
| onValueChange | (value: string) => voidSelection callback. | — |
| showLabels | booleanShow all labels instead of only selected labels. | false |
| className | stringAdditional Tailwind classes merged with the component defaults. | — |
BottomNavigation.Item
Bottom navigation action.
| Prop | Type | Default |
|---|---|---|
| value | stringItem value. | — |
| label | React.ReactNodeVisible label slot. | — |
| icon | React.ReactNodeIcon slot. | — |
| showLabel | booleanOverride root label visibility. | — |
| className | stringAdditional Tailwind classes merged with the component defaults. | — |