Block Navigation

Description

DemoDocumentationGitHub

Block Navigation provides a sidebar with the current post/page’s blocks and some tools to facilitate the editing process in the new Gutenberg editor.

Features

The features are especially useful for nested blocks – blocks that are inside parent blocks which are difficult to select or move in the editor.

Inside the panel several utilities are included to enhance the UX, such as:

  • Dragging blocks to a different location
  • Moving blocks by click
  • Selecting blocks
  • Easily recognising the block from a small snippet of the block’s content

The user can select a dark or light color scheme, from the multiple included.

Plugin and Theme developers

The plugin also provides some features for Plugin and Theme developers, such as:

  • Click and Copy the block’s clientId
  • Click to console.log helpful data from the block

Usage

Inside the Post editor on the right side of the top Block’s Toolbar the plugin icon/button should appear (if not, please read the FAQ below).
Click the icon/button to open the plugin sidebar.

Credits

Images from the readme banner and screenshots belong to Charles Postiaux.

Screenshots

  • Main view, dark scheme.
  • Dragging a block to a different position.
  • Block menu.
  • List of available color schemes, light and dark.

Installation

Installation from the WordPress admin.

  1. Log in to the WordPress admin and navigate to Plugins > Add New.
  2. Type “Block Navigation” in the Search field.
  3. In the results list Block Navigation plugin should appear, click Install Now button.
  4. Once it finished installing, click the Activate button.
  5. That’s it, now you can go to any post where Gutenberg is enabled and start using the plugin.

FAQ

I do not see the plugin icon in the post editor

Alternatively the Plugin can be opened from the Show More button (the 3 dots on the right side of the Editor Top Bar).
Click the More button and inside the menu list click on the plugin name “Block Navigation”.

Reviews

June 26, 2020
Great stuff, really love this thing! Always used something similar with Elementor (build in), and really missed it in Gutenberg. So this plugin is just what I was looking for; neat! Suggestions for improvement: - Easy bulk collapsing/expanding of the options panel (or whatever they're called) - Easier way to switch between block navigation and options panels (separate them?) But as said, great plugin; should be part of Gutenberg core!
January 17, 2020
Great work. Really helpful especially when using nested groups. Works as I need. Would like to suggest it could be handy to show the additional css class names next to group blocks. Eg you would see "Group.mygroup1" in the nav menu. That would help to know which group is which quickly.
December 30, 2019
I was surprised that Gutenberg didn't come with the feature to reorganize blocks from an outline view. This plugin saved me from a lot of tedium. Thank you so much for this elegant solution! I only wish that I could select and move multiple blocks at once.
October 16, 2019
Really handy plugin when blocks get nested and they become a bit hard to select. Makes that task really simple.
Read all 4 reviews

Contributors & Developers

“Block Navigation” is open source software. The following people have contributed to this plugin.

Contributors

Translate “Block Navigation” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

2.0.1

  • Fixed text being selected on drag
  • Fixed images being able to be dragged
  • Updated dependencies

2.0.0

  • Major refactor. Use of react hooks, load an old version of the plugin for WP 5.2
  • Use of a virtual list to improve performance (specially when dragging)
  • Blocks can be dropped as a children of an empty nestable block
  • Overall improvement in the UX
  • The scrollTop position will update based on the current selected block

1.3.0

  • Blocks that are nestable (like columns) now retain their collapsed/expanded state, after closing and re-opening the plugin sidebar or after collapsing an ancestor block.
  • Reusable blocks now show their title, so they are more easy to identify.

1.2.1

  • Minor bugfixes.

1.2.0

  • Improved moving blocks UX (both by drag and by click).
  • Added the filter “blockNavigation.addBlockContentAttributePath” for developers to include their own block type content.
  • Updated the UI.
  • Rebuilt code, migrated JavaScript to TypeScript.
  • Raised minimum WordPress version to 5.2 to make use of block-editor package.

1.1.2

  • Cleaned console log output and added “attributes-available”.
  • Fixed castaña scheme dark color.
  • Updated cover block and added media-text block.
  • Small typo and bug fixes.

1.1.1

  • Make use of Rich Text WordPress package.
  • Small typo and bug fixes.

1.1.0

  • Added Development Mode. Currently it adds two extra actions inside each Block’s menu: Copy the Block clientId to the Clipboard and Log to the browser’s console some helpful Block related data.
  • Clicking on an already selected block deselects it.

1.0.1

  • Fix bug with jQuery variable
  • Upgrade logo to SVG
  • Schemes naming fix

1.0.0

  • Initial release.