NavigationBar
iOS 26 top navigation bar with standard and large title modes. Supports back button, leading/trailing action buttons, inline segmented controls (iPad), and search accessories.
Import
import { NavigationBar, ToolbarButton } from '@scaffald/ui';
Basic Usage
Props
See the TypeScript definitions for the complete props API.
| Prop | Type | Default | Description |
|---|---|---|---|
title | string | required | Navigation bar title |
subtitle | string | — | Optional subtitle below title |
showSubtitle | boolean | true | Whether to show the subtitle |
titleSize | 'standard' | 'large' | 'standard' | Title display size |
backButton | { label?, onPress, tintColor? } | — | Back button configuration |
leadingItems | ReactNode | — | Items on the left side |
trailingItems | ReactNode | — | Items on the right side |
segmentedControl | SegmentedControlProps | — | iPad: inline segmented control |
searchAccessory | SearchAccessoryProps | — | iPad: search row below nav |
glass | boolean | false | Apply glassmorphic background |
Common Props
All NavigationBar components accept standard React Native View props.
Variants
Standard Title
Centered title with optional subtitle, back button, and trailing actions.
Large Title
34pt bold title displayed below the nav row, matching iOS large title behavior.
iPad with Segmented Control
Replaces center title with a segmented control for tabbed navigation.
Glass Background
Applies a translucent glassmorphic background with backdrop blur.
Accessibility
- Back button has accessible label
- Title and subtitle are readable by screen readers
- Trailing actions are focusable and announce their role
- Segmented control provides tab semantics
Design Tokens
This component uses the following design tokens:
- Colors:
colors.labels[theme].primary,colors.labels[theme].secondary - Accents:
colors.accents[theme].bluefor tint colors - Typography: 17pt semibold (standard), 34pt bold (large title)
- Glass: backdrop-filter blur for glassmorphic variant
See Design Tokens for more information.
Related Components
- BottomToolbar — Bottom toolbar companion
- ToolbarButton — Button used in toolbars
- SearchAccessory — Search bar for iPad nav bars
Changelog
See GitHub Releases for version history.