bellhop by actabl

When to use

Use page navigation for secondary navigation within a specific section or module of your application.

Section Navigation

Navigate within a specific module or section of the application.

Multi-Level Menus

Organize navigation items with expandable parent-child relationships.

Settings Pages

Provide navigation for settings, preferences, or configuration screens.

When not to use

  • For primary site navigation—use header navigation
  • For in-page navigation—use table of contents or anchor links
  • When page relationships are unclear—reconsider content structure
  • For sequential forms—use stepper component

Features

Page navigation includes powerful features for organizing content.

Single Items

Simple navigation items for direct links

Expandable Sections

Parent items with collapsible children

Icons

Material Symbols icons for visual identification

Badges

Show counts or status indicators on items

Active States

Clear visual indication of current page

Configuration Examples

Different ways to configure page navigation.

Simple Navigation

All single-level items without expansion

Mixed Levels

Combination of single and expandable items

Best Practices

Follow these guidelines when using page navigation.

Do

  • Group related navigation items under parent sections
  • Use clear, descriptive labels
  • Limit nesting to 2 levels (parent and children only)
  • Use icons consistently across similar items
  • Show badges for important counts or notifications
  • Keep navigation items to 7-10 maximum

Don't

  • Don't nest more than 2 levels deep
  • Don't use vague or unclear labels
  • Don't mix different icon styles
  • Don't overcrowd with too many items
  • Don't hide critical navigation in collapsed sections

Common Patterns

Typical use cases for page navigation.

Settings Navigation

Navigate between different settings categories (Account, Security, Notifications, etc.)

Admin Panel

Organize admin tools and features into logical sections

Documentation

Structure documentation topics with parent categories and child pages

Dashboard Sections

Navigate between different views or reports within a dashboard module

Accessibility

Page navigation is designed to be accessible to all users.

Keyboard Navigation

  • Tab - Navigate between menu items
  • Enter/Space - Activate item or toggle expansion
  • Arrow Up/Down - Move through menu items
  • Arrow Right - Expand collapsed section
  • Arrow Left - Collapse expanded section

Screen Reader

  • Navigation landmark role
  • Expandable items announce their state
  • Active item is clearly identified
  • Badge values are announced
  • Icon meanings are conveyed through labels

Visual Design

  • Clear focus indicators
  • Sufficient color contrast
  • Active state is visually distinct
  • Hover states provide feedback

Resources

Design and development resources for the Page Navigation component.

Figma

Available
View in Figma →

Web Components/Angular

Available
View in Storybook →

React

Available
View in Storybook →