PageControl
iOS 26 page indicator dots. Displays the current page in a paginated view with active/inactive dot states. Supports a glass pill variant and dot size compression for 6+ pages.
Import
import { PageControl } from '@scaffald/ui';
Basic Usage
Props
See the TypeScript definitions for the complete props API.
| Prop | Type | Default | Description |
|---|---|---|---|
totalPages | number | required | Total number of pages |
currentPage | number | required | Active page (0-indexed) |
onPageChange | (page: number) => void | — | Page change handler |
variant | 'dots' | 'pill' | 'dots' | Visual variant |
Variants
Dots (default)
Simple row of dots with opacity differentiation.
Pill
Wraps dots in a glassmorphic capsule with backdrop blur. For 6+ pages, edge dots progressively shrink (size compression) to maintain compact layout.
Accessibility
- Each dot announces its page number and total
- Active dot has
selectedaccessibility state - Dots are pressable when
onPageChangeis provided
Design Tokens
- Dot color:
colors.labels[theme].primary - Active opacity: 1.0, inactive: 0.3
- Pill background: glassmorphic with
backdrop-filter: blur(30px) - Dot sizes: 8px (standard), 6px (small), 4px (tiny)
See Design Tokens for more information.
Related Components
- BottomToolbar — Uses PageControl in page control variant
Changelog
See GitHub Releases for version history.