Macro Usability Improvements

Last modified by Adina Milica on 2025/11/25 07:44

 XWiki
 Design
 Idea
 
Add pickers on all macro configuration fields with predefined values: https://jira.xwiki.org/browse/XWIKI-23757

Macro name next to move handle: https://jira.xwiki.org/browse/XWIKI-22383

Macro content vs boundary: https://jira.xwiki.org/browse/XWIKI-22384

 

Discussion focused on macro configuration: https://forum.xwiki.org/t/macro-configuration-standards-ui-ux/14965/10

Discussion focused on macro look and behaviour in edit mode: https://forum.xwiki.org/t/macros-for-newbies-blank-states-scary-set-up/14329/25

Added by Mathieu on the XWiki Standard 18.x Cycle + Apps/XNNG/Cloud Brainstorming (XWikiSAS meeting), line 21 (ATM)

 
No

Description

Last updates and agreed upon conclusions


Macro Configuration  

Success

 To formalize some doable actions regarding macro configuration improvements, started from this discussion

#1 A field that has a limited list of possible values, should offer the user those values before selection (through any available UI) - made JIRA issue

#2 We should start linking documentation in macros even if that documentation is in english, even if it’s not always available. It is a step forward and will be of a lot of help to users. We don’t need to make everything perfect from the first time.

#3 Slightly more spacing between each property would be nice.

Macro block appearance and behaviour

Success

The doable actions from this discussion have also been added here:

#4 On hover, next to the move icon, we’d display an edit icon button and the name of the macro. JIRA Issue


#5 For the issue of differentiating macro boundary and content boundary: I think it highly depends on color contrast or just general accessibility:

  • choose a different colour for content boundary (maybe main color or link color, if it has enough contrast in all cases)

or

  • use a dashed line for macro boundary

#6 Empty macros render the “macro: content“ message. It’s good, but we could make it much nicer easily.

  • add more padding (especially vertical)
  • some round corners (by radius variable)
  • add a light gray background (by color variable)
  • instead of “macro: content“ just write “Empty macro. Use the edit icon or double click to configure it.“

 

Get Connected