Skip to content

feat(web): add navigation menu - #4304

Merged
Adebesin-Cell merged 1 commit into
v6from
feat/web-navigation-menu
Nov 21, 2026
Merged

Adebesin-Cell merged 1 commit into
v6from
feat/web-navigation-menu

Conversation

@Adebesin-Cell

Copy link
Copy Markdown
Collaborator

📝 Description

Adds ark-navigation-menu to @ark-ui/web, the web version of Navigation Menu.

⛳️ Current behavior

Web has no Navigation Menu.

🚀 New behavior

  • ark-navigation-menu runs @zag-js/navigation-menu, with list, item, trigger, link, content, indicator, item indicator, arrow, viewport positioner and viewport parts.
  • Content, viewport and indicator are presence parts, so they animate in and out.
  • With a viewport, each item's content moves into it, and the viewport and trigger proxies are left in the item, as React does with its portal. Links inside moved content keep their item value.
  • value is a two-way property and valuechange is an event. Direction comes from the nearest ancestor with dir.
  • Basic, viewport, vertical and controlled examples.

🧩 Frameworks

  • React
  • Solid
  • Svelte
  • Vue
  • Not framework-specific

💣 Is this a breaking change (Yes/No):

No

✅ Checklist

  • Added a changeset for user-facing changes
  • Added or updated tests
  • Added an example for any new prop or part
  • Updated the docs

📝 Additional information

  • No changeset: @ark-ui/web isn't published yet.
  • This PR carries the same small definePresencePart change as feat(web): add swap #4300 (present gets the part element). Git merges the identical change cleanly whichever lands first.
  • The web suite passes (136 tests). Typecheck and build are clean.
  • In Chromium, hover opens the menu, the viewport resizes to each item's content, and Escape closes it.

@vercel

vercel Bot commented Nov 21, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
ark-docs Ready Ready Preview Nov 21, 2026 6:10pm UTC

Request Review

- ark-navigation-menu runs @zag-js/navigation-menu with list, item, trigger, link, content, indicator, item indicator, arrow, viewport positioner and viewport parts
- content, viewport and indicator are presence parts, so they animate in and out
- with a viewport, item content moves into it and leaves the viewport and trigger proxies in the item
- value is a two-way property and valuechange an event; direction comes from the nearest ancestor with dir
- presence parts can read their own element and opt out of the mount animation (same change as the swap PR)
@Adebesin-Cell
Adebesin-Cell force-pushed the feat/web-navigation-menu branch from 0c51b2d to 411e46d Compare November 21, 2026 18:08
@Adebesin-Cell
Adebesin-Cell merged commit aa466fb into v6 Nov 21, 2026
10 checks passed
@Adebesin-Cell
Adebesin-Cell deleted the feat/web-navigation-menu branch November 21, 2026 18:13

This branch was successfully deployed

1 active deployment
Preview — 411e46d4 Deployed Nov 21, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant