Navigation Panel config UI

Hey everyone,

As part of a recent usability pass, I identified several areas where the current navigation experience could be improved. This post outlines the key issues and presents my proposal to address them.

Top Issues

  • Drag-and-drop only actions: These interactions are not always intuitive or accessible.
  • Lack of visual aids for drag-and-drop: The current interface relies solely on text, which limits discoverability.
  • Important information that can be hidden by very tall navigation trees.**
  • Missing configuration options: Several useful settings available in the Document Tree Macro are not included in the default navigation.

My goal with this proposal is to mitigate the issues above while keeping the user friendliness of the interface clear and the configuration options.

Improved Interaction Design

Drag-and-Drop Enhancements

  • Replace drag-and-drop-only operations with visible action buttons directly in the tree.
  • A drag icon is added at the beginning of each movable line to clearly indicate the action.

Terminology and Visual Updates

Clearer Language

  • I renamed the term “Excluded” to “Hidden” to better reflect its effect.
  • I also updated the icon to an eye symbol, consistent with visibility controls used elsewhere.

Hiding and unhiding a page

Visual Feedback

  • Hidden pages now use a distinct visual treatment to clearly indicate their status.

Layout Improvements

  • The introductory text was moved to the top of the page to ensure users see it immediately.

Configuration Enhancements

To support more flexible customization, especially for admins, I’m proposing the addition of a selected set of parameters from the Document Tree Macro. Some of these were requested in tickets like XWIKI-21841.

New Options Focus

  • I prioritized on/off switches that are easy to understand and configure.
  • The focus is on options that directly improve the experience of using and managing the navigation tree.
  • I also renamed all “exclude” parameters to “hide” to align with the updated UI language.

Complete Views

Desktop View

Mobile View

As always, I’d be glad to hear your feedback and discuss any ideas you might have for further improvements.

Thank you very much for reading.

I like it, thx for the proposal. :slight_smile:

My only comment is that this tree can become very large. For ex on this very simple wiki with very little extensions installed, there are 36 entries that would appear in the tree:

On a real life wiki, you can expect 50-100 entries or more. Especially if there are top level spaces containing user content pages.

I’m not saying it’s a blocker, just mentioning it in case it affects the proposal in some way.

The main issue is that a Hidden page is already a concept of XWiki that is going to clash. I feel it’ll confuse users.

Sounds good!

Thx a lot

1 Like

Same comment. I don’t think “Hidden” is the proper terminology here.

We’ll have to see how easy it is to add that drag icon to the jsTree layout, which is not very flexible.

You lose the WYSIWYG aspect. One of the goals was to have a quick preview of how the navigation tree will look like without reloading the page.

I find the dotted border a bit confusing. This kind of border is often used to designate an area where you can drop something, or the item that is currently being dragged.

Thanks,
Marius

Looks good overall, thanks!

In addition to the dotted border mentioned by Marius, I wonder if the gray text lacks contrast with the background, which could lead to accessibility issues.

About hiding pages in XWiki, how do I turn them to visible pages again?

If it’s something that’s not possible to do, we can try to find something that works. It’s hard to do right now though, not knowing the limitations.

Regarding the text color, indeed, I changed them to the same color of the other pages.

The dots are there mainly for cohesion and visual align with the eye icon on the right. I did an example without them, but the icon feels kind of lost when there are a lot of pages removed.

We could just change the background color, even though that style is very close to the selection style, but usable. Let me know what do you think.

See https://www.xwiki.org/xwiki/bin/view/Doc/XS/Extensions/XWikiStandardFlavor/User/ViewPage/HiddenPages/ and https://www.xwiki.org/xwiki/bin/view/Doc/XS/Extensions/XWikiStandardFlavor/User/ViewPage/HidePage/ .

1 Like