Declare the CSS length format of the width of the box, message and code macros

The box macro, the message macros and the code macro take their width as free text in the Edit Macro dialog. The parameter only accepts a CSS length, as its description says, "expressed in px or %", but it declares no format, so the dialog accepts any value and the macro writes it as is into the style attribute of the box: a wrong value is silently ignored by the browser and the user never gets a message.

The macros to change, all through the same parameter class:

• box: DefaultBoxMacro.java.
• error, info, success and warning: AbstractMessageMacro.java.
• code: CodeMacroParameters.java, which extends the box parameters.

The fix is done once, in BoxMacroParameters.java, on setWidth:

• Declare the accepted format, a number with a px or % unit, for example with a @Pattern annotation, so that an invalid value is refused instead of being written in the style attribute.

Depends on

• XWIKI-25287, without which the Edit Macro dialog does not enforce the declared format and the value is only checked when the macro is rendered.

KOs covered

Impact found on macro fluidity

These 6 KOs come from the WYSIWYG usability audit of the macros, under the criterion C13 constraints of its usability criteria. The page of each macro, linked in the table, has the full notes and the steps to reproduce. Fixing them means declaring the format of one parameter of the box macro parameters.