Skip to content

feat(admin): make the main navigation menu scrollable#4073

Merged
tvdeyen merged 1 commit into
mainfrom
issue-3816
Jul 19, 2026
Merged

feat(admin): make the main navigation menu scrollable#4073
tvdeyen merged 1 commit into
mainfrom
issue-3816

Conversation

@tvdeyen

@tvdeyen tvdeyen commented Jul 18, 2026

Copy link
Copy Markdown
Member

What is this pull request for?

On small screens and on installations with many admin modules the lower main
navigation items could not be reached — the menu column had no way to scroll.

The left menu is now a flex column: the navigation area scrolls within the space
left by the logout entry (pinned at the bottom by the layout rather than by
absolute positioning), and its height uses the dynamic viewport unit so mobile
browser chrome no longer hides the bottom of the list.

The tricky part is that a scroll container clips its content, which would cut off
the hover flyouts (a module's label or its sub navigation) that reach out to the
right of the collapsed column. Each entry is now a small web component
(alchemy-main-navi-entry) that, while its flyout is open, lifts it out of the
clip by fixing it to the viewport and keeps it anchored to the entry with Floating
UI (already a dependency). Closed flyouts default to position: fixed so they no
longer inflate the column's scrollable height.

Closes #3816

Notable changes (remove if none)

No behavioural change for existing browsers beyond the menu now scrolling. The
100vh/100dvh pair on #left_menu is intentional: 100vh is a fallback for
browsers that predate dvh support, some of which still run the admin.

Checklist

  • I have followed Pull Request guidelines
  • I have added a detailed description into each commit message
  • I have added tests to cover this change

@tvdeyen
tvdeyen requested a review from a team as a code owner July 18, 2026 18:08
@tvdeyen tvdeyen added this to the 8.4 milestone Jul 18, 2026
@codecov

codecov Bot commented Jul 18, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 98.10%. Comparing base (b070d3e) to head (140abc8).

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #4073   +/-   ##
=======================================
  Coverage   98.10%   98.10%           
=======================================
  Files         348      348           
  Lines        9083     9083           
=======================================
  Hits         8911     8911           
  Misses        172      172           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

On small screens and on installations with many admin modules the lower
menu items could not be reached because the navigation column had no way
to scroll. The column is now a flex layout whose navigation area scrolls
within the space left by the logout entry, sized with the dynamic
viewport height so mobile browser chrome no longer hides the bottom.

Because a scroll container clips its content, the hover flyouts (a
module's label or its sub navigation) are lifted out of the clip by a
per-entry web component that fixes them to the viewport and keeps them
anchored to their entry with Floating UI.
@tvdeyen
tvdeyen merged commit c99c330 into main Jul 19, 2026
28 checks passed
@tvdeyen
tvdeyen deleted the issue-3816 branch July 19, 2026 09:57
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.

Scrollable Menu

1 participant