Install
Works with Drupal: ^11Using Composer to manage Drupal site dependencies
Alternative installation files
Download tar.gz
70.43 KB
MD5: 16bf1fd8ff19796868495d6d2e8a7ef9
SHA-1: ee165acaeaf32d10f1733ab3a167435551a3ccf9
SHA-256: 825edd55a0dd7fff8952b06af3ce40ba4a3cb5f4b5ccfb94b85d1d7f0ea32a19
Download zip
102.54 KB
MD5: 7fde4a346ac3f0c1965abe931e322e33
SHA-1: ec3b4ce3c875599c34b48e81be92d5864baadcfa
SHA-256: 923b796628a8377ecd02528d5af62c4ac89fa86c623ef75527284fd5c986cf39
Release notes
First stable release of Admin Navigation — a set of ergonomic enhancements
for the new core Navigation module shipped with Drupal 10.2+ and Drupal 11.
What's included
-
Sidebar ↔ Top bar position toggle with a live visual
preview on the settings page. Switch the entire core Navigation between
the default left sidebar and a horizontal top bar with one radio. -
Top-bar polish: dropdowns drop below their trigger,
nested submenus fly out to the right with viewport-edge correction,
automatic overflow detection with a "more" button that reveals hidden
items when the toolbar is too narrow, and portal-to-<body>
so flyouts work even with transformed ancestors. -
Hide duplicate popover headers option — turn the parent
button into a direct link instead of a redundant first menu item. -
Sticky behaviour toggle (sticky to viewport vs anchored
to page top) and auto-hide empty top bar for cleaner
pages. -
Admin Tools dropdown on the Drupal logo
(admin_navigation_toolssubmodule): hover the logo to access
nine granular cache flush operations (CSS & JS, plugins, render,
routing, static, twig, views, theme registry, flush-all), plus Run cron,
Run updates, and Logout. Fully customizable — drag to reorder, edit
labels, add custom links via routes or URLs. Two display styles for
items with children: inline expansion or sub-popover with a Back button. -
Top-bar item grouping
(admin_navigation_groupingsubmodule): bundle several top-bar
items under a single parent dropdown to reduce horizontal overflow.
Drag-and-drop admin UI with full keyboard support at runtime
(Enter/Space, Arrows, Escape, Tab). -
CSS / JS conflict blocking
(admin_navigation_conflictssubmodule): scans installed
modules, auto-detects files with globalaside { … }or
nav { … }selectors that break the toolbar, and lets you
disable any CSS or JS file with one checkbox — only for users with
toolbar access, so the front-end keeps the original styles intact.
Security
- All cache-flush routes are CSRF-token protected.
-
Every feature checks
access navigationor
administer site configurationbefore running. - Admin actions redirect back to the page the user came from.
Compatibility
- Drupal core 10.2+ or 11 (Navigation module enabled).
-
Mobile-friendly: below 769 px the module falls back to core's native
sidebar so phones get the experience that ships with Drupal core. - RTL: every directional value uses logical CSS properties.
Getting started
-
Install via Composer:
composer require drupal/admin_navigation -
Enable the base module and the submodules you want:
drush en admin_navigation admin_navigation_position admin_navigation_tools admin_navigation_grouping admin_navigation_conflicts -
Configure at Configuration → User interface → Admin
Navigation
(/admin/config/user-interface/admin-navigation).
Permission required: Administer admin navigation.
