Navigation · core

Top bar

navigation.top-bar

Top bar: A wayfinding control that moves between locations, views, or levels of an interface.

top barthe control that changes viewsthe wayfinding element

States5

Touch target44px

Evidence6

Introduced by8 kits

Visual specimen

Same contract. Every kit voice.

MAVAN renderingdefault

Translation table

What code calls it.

Web<header>The closest native or standardized web primitive.direct

ARIAnavigationNo single ARIA role represents the complete component.pattern

SwiftUICustom View compositionSwiftUI has no single direct equivalent; compose and name the behavior explicitly.approximation

AppKitNSToolbarThe nearest named AppKit API.direct

Anatomy

Every part, named.

1Navigation container
2Destination or view labels
3Current-location indicator
4Keyboard and focus behavior

Often confused with

Similar shape. Different contract.

Tabsnavigation.tabs

Shares a visual family, but has a different role, state model, or interaction contract.

Segmented tabsnavigation.segmented-tabs

Shares a visual family, but has a different role, state model, or interaction contract.

Pill tabsnavigation.pill-tabs

Shares a visual family, but has a different role, state model, or interaction contract.

Prompt · paste into your agent

Ask for the exact thing.

Implement the canonical Top bar component (navigation.top-bar). Top bar: A wayfinding control that moves between locations, views, or levels of an interface. Support these states: default, hover, focus-visible, active, disabled. Use semantic design tokens rather than raw visual values. Preserve a minimum 44px touch target where interactive. Provide and verify: implementation, state-matrix, responsive, keyboard, touch, reduced-motion. Keep the component API stable so every Studio kit can supply its own rendering without changing the behavior contract.

Studio contract

What must be proven.

Required states

default · hover · focus-visible · active · disabled

Required evidence

implementation · state-matrix · responsive · keyboard · touch · reduced-motion

Source union

mavan · jade · lumen · aurora · cabana · purple-rain · spatial · margin