Navigation Editor Tracking Issue #29102
Description
Last updated Aug 23, 2021
Extends #24551, preliminary for milestone 7
This is an overview issue that we'll maintain going forward into WP 5.7 and 5.8 milestones. It attempts to track discussions and resulting actions about the Navigation Editor.
This overview tries not to track bugs of the Navigation Editor - for that you should filter open issues using the labels:
[Feature] Navigation Screen[Type] Bug.
🏷 High
This high priority label designates what is required before we can remove the "experimental" flag in Gutenberg from the Nav Editor screen. The prerequisite for doing this is: UI/UX feature parity with the existing Menus screen (nav-menus.php).
UI/Visual Issues
Issues that are important to ensure the quality of the use experience is at an acceptable baseline:
- Add accordion style menus to the navigation block #29747 - fix the current UI styling inconsistencies.
- Improve how different types of nav items are rendered on the Navigation screen #34035
- Width of long items affect other items on the Navigation editor screen #34036
- Fix spacing issues in the mobile version of the Navigation editor screen #34032
- Fix snackbar component overflow on mobile on the Navigation editor screen #31182
- Fix error notice appearing underneath the modal screen overlay on the Navigation editor screen #31100
- Navigation Screen: consolidate top bar with the one used in the FSE #31241
Detrimental to UX
Issues deemed critical that severely impair the user experience of the new screen:
- Handle heavily nested items in the Nav Editor screen #23583 (comment) - need to be able to click to expand all levels of nesting via some means. Possibly requires a dedicated Issue.
- Nav Editor menu title doesn't support special characters #34223
- Temporarily disable support for theme-opt for
block-nav-menusfrom the Nav Editor #34265 - Improve Nav Editor placeholder state #23953
- Nav item toolbar too far removed from nav item block #34225
- Improve UX for nesting navigation items via drag / drop #34234
- Make it easier to add new items in between existing Nav Item blocks within the Nav Editor #34268
- Show more items in the "Recent" items of the Link UI when adding a new Nav item in the Nav Editor #34283
- Add block inserter to navigation editor #34438
Feature parity with the classic navigation screen
Issues required to achieve a feature parity with the existing screen:
- Option to bulk add entities of any type in Nav Editor screen #31667
- "Manage Locations" doesn't work on the Navigation screen #33815
- Mark invalid menu items in Navigation editor and block #23573
- Expose user facing documentation on the Navigation Editor screen #34266
- Add support for custom post types in navigation editor #34440
- Add support for custom taxonomies in navigation editor #34442
- Navigation editor should respect
show_in_nav_menus#34443
🏷 Normal
User experience
- Confusing navigation block inserter menu / block library #33867
- Add all pages option doesn't work in Navigation screen #33999
- Nav items of fixed "type" retain ability to enter a custom URL. #34224
- Navigation editor: Menu switcher doesn't show after deleting a menu #34255
- Add ability to create a new navigaition menu with a single click #34227
- Pass filter value when clicking Browse All in Nav Editor screen #34987
Visual/UI
Improved interaction mode
- Navigation Editor: Preview functionality #31074
- Navigation Editor: Add visual cues for the menu and page list items #30659
- Navigation Screen: Always show appender #31276
- Navigation Editor: Handling saving for multiple menus #31813
- Navigation screen: can't move links into a submenu with keyboard only #33271
- Navigation screen: blocks can't be dragged into submenus #33272
Feature parity with the classic navigation screen
- Load last edited menu by default #22623
- Ability to ascertain nav item "type" without having to select each Nav item #34233
- Ability to bulk select non (immediately) adjacent sibling Nav items #34232
Compatibility with the Navigation block
- Provide a better way to disable/enable nav block features for the nav editor #30007
- Decide if it's better to switch to a Legacy Menu block (TL;DR - decision was it's best to evolve the existing Nav Block to suite the needs of the editor).
- Improve Nav Editor placeholder state #23953
- List View Design Updates #24029
- Handle heavily nested items in the Nav Editor screen #23583
- Allow expanding and collapsing of nested blocks in List View #26141
- Supporting future block types in the navigation editor. #30006
Required REST API updates
- Migrating experimental navigation and widgets screen to bulk REST API #24907
- REST API: Introduce reorder menu endpoint #25093
- REST API: Audit menus endpoint slashing #25094
- REST API: Audit menus route filters. #25095
- Navigation: Preload API requests #24642
- Add preload_paths filter for widgets screen and full site editing #28701
- Navigation editor: Nested block-based menu items are deleted and re-created on each save #35047
- Navigation editor: Speed issues with saving and loading #35046
- Navigation editor: Fail loudly when attempting to save unsupported blocks #35045
- Lots of calls to menu item REST API after saving menu. #34999
Upgrading WordPress menus to allow blocks
- Navigation: Make the
block-nav-menussetting more granular #24638 - Navigation Screen: Page List block styling is inconsistent with navigation link styling #29101
- Navigation Screen: Page List block styling is inconsistent with navigation link styling #29101
- Navigation: Improve how non-link blocks appear in old
nav-menus.phpscreen #24639
Customizer support
This may evolve into a lot more once we have the foundation for embedding a block editor in the customizer.
Others
🏗 Architecture
This section is reserved for Issues that are related to overall architectural discussions. Any concrete tasks should be added to the relevant section above.
- The future of the
block-nav-menustheme opt-in for the Navigation Screen #33969 - Navigation Block: save data to a custom post type #34612
- Provide a better way to disable/enable nav block features for the nav editor #30007
- Experiment: dedicated menu and menu item blocks for navigation editor #34496
Known/Potential backwards compatibility problems
This section is reserved to list any potential or known backwards compatibility issues with the existing Menus screen that cannot (or will not) be solved in time for removal of the Experimental status from the Nav Editor. It is expected that we will communicate early about these problems in order that developers have sufficient time to adapt their code.