Show form field descriptions after the label and before the field itself

[erral]

Is your feature request related to a problem? Please describe.

After an accessibility review of a Plone Site (6.0.x, but it happens also in 6.1.x), we have seen that the ordering of the widgets in a form follows the following pattern:

• label
• required
• field
• description
• errors

The accessibility review suggested that the description should go after the label and, in any case, before the field, because it usually contains a helpful description about how the user should fill the field.

Describe the solution you'd like

We were requested to change the rendering widgets to match the following pattern:

• label
• required
• description
• field
• errors

Additional context

The change is related to accessibility, specially for users using screen readers.

The change goes in templates/widget.pt

cc: @rber474 @UnaiEtxaburu

[petschki]

Hi, since we're following Bootstrap conventions here (see https://getbootstrap.com/docs/5.3/forms/form-control/#form-text) I think the fix would be to add a valid aria-describedby to all field descriptions...

I know we had discussions about the description position and decided to follow the bootstrap standard.

Since there are discussions to replace Bootstrap with something else in Plone 7 I'm open to a new form field layout then.