This has been addressed in D8 core: #314385 Make position of #description configurable via the API, which makes this part of #378
D8 change record: https://www.drupal.org/node/2324025
For short form fields it makes sense to have the
#descriptionappear below the form widget; however, in long lists of checkboxes and/or radio buttons it would be nice to be able to have a toggle whether the
#descriptionappears above, or below, the form widget.
The is a new
#description_displayoption with three allowed values, consistent with
There is no UI in core for toggling this behavior for existing forms.
I'm very glad this issue has been addressed for Drupal 8.
People with low vision may use the site at an extreme zoom level, in which case the issue of the help text being below the field is exacerbated because they only see a very small portion of the screen at one time. Imagine the image in comment
#47but at 500% zoom. That's a TON of scrolling. ARIA doesn't really help users in this scenario.
Contrib modules that help with this
I would like to see a field's description/help text appear above the field rather than after, as would surely be the case with forms in everyday life (i.e. non-Drupal/Backdrop).
I have just read Drupal 7 - Move field's help text (description) between the label and input element(s). Do we have a Backdrop view or decision on this?
See https://github.com/backdrop/backdrop-issues/issues/1351 for one example.