01
Overview
Primary navigation with wide multi-column content panels, optional hover activation, shared viewport, indicator, and nested submenu columns.
Usage
02
When to use
Use when
- Building site-level navigation where top-level categories reveal rich multi-column content.
- You need optional hover-open behavior with keyboard-first trigger traversal.
Avoid when
- A simple single-trigger flyout is sufficient. Use Dropdown instead
- You need command-style application menus with item-by-item keyboard semantics. Use Menu bar instead
03
Examples
Mega menu
Top-level trigger/content navigation with viewport, indicator, and nested submenu.
04
Props
| Name | Type | Default | Required | Bindable | Description |
|---|---|---|---|---|---|
id | unknown | req | |||
items | MegaMenuItem[] | req | Top-level trigger/content entries. | ||
openOnHover | boolean | false | Hover opens top-level content instead of click-only mode. | ||
viewportVisible | boolean | true | Render the shared content viewport wrapper. | ||
indicatorVisible | boolean | true | Render an active trigger indicator bar. | ||
label | text | 'Main navigation' | Accessible name for the navigation landmark. | ||
dir | 'ltr' | 'rtl' | 'auto' | Text direction used for layout and keyboard navigation. |
05
Accessibility
Implements the Navigation landmark + disclosure buttons pattern.
ArrowLeft/ ArrowRight/ Home/ End/ ArrowDown/ Escape
Traverses triggers and opens/closes panels.
Trigger focus remains in the tab order; Escape closes and returns focus to the active trigger.