ToolbarButton
iOS 26 toolbar action button. Atomic building block for NavigationBar and BottomToolbar. Supports icon, text, filled, and back-chevron variants.
Import
import { ToolbarButton } from '@scaffald/ui';
Basic Usage
Props
See the TypeScript definitions for the complete props API.
| Prop | Type | Default | Description |
|---|---|---|---|
icon | ReactNode | — | Icon element to render |
label | string | — | Text label |
variant | 'icon' | 'text' | 'filled' | 'back' | 'icon' | Button style |
onPress | () => void | — | Press handler |
disabled | boolean | false | Whether disabled |
tintColor | string | — | Override accent color |
Variants
- icon: 44x44 touch target with centered icon
- text: Text label with accent color
- filled: Blue pill background with white text
- back: Chevron + text label for back navigation
Accessibility
accessibilityRole="button"on all variants- Disabled state communicated via
accessibilityState - Back button defaults to "Back" accessible label
Design Tokens
- Tint:
colors.accents[theme].blue - Icons:
colors.labelsVibrant[theme].primary - Filled background: accent blue with white text
See Design Tokens for more information.
Related Components
- NavigationBar — Uses ToolbarButton for actions
- BottomToolbar — Uses ToolbarButton for actions
- ToolbarButtonGroup — Groups multiple buttons
Changelog
See GitHub Releases for version history.