[wp-trac] [WordPress Trac] #39441: Improve the Settings API for accessibility and ease of use.

[WordPress Trac]

#39441: Improve the Settings API for accessibility and ease of use.
-------------------------------------+-------------------------------------
 Reporter:  flixos90                 |       Owner:
     Type:  enhancement              |      Status:  new
 Priority:  normal                   |   Milestone:  Future Release
Component:  Plugins                  |     Version:
 Severity:  normal                   |  Resolution:
 Keywords:  settings-api has-patch   |     Focuses:  accessibility,
  2nd-opinion                        |  administration
-------------------------------------+-------------------------------------

Comment (by flixos90):

 Quick summary on today's meeting:

 * For single checkboxes, the `$title` should be used as the checkbox
 label, and nothing should be displayed in the left column. The checkbox
 label should be printed in bold.
 * The `$title` is currently printed out twice when `fieldset` is true.
 That is because the two column layout restricts us in a way that the
 `fieldset` can only be part of the right column, not actually wrap both
 columns. Therefore the `$title` is printed as `<span aria-hidden="true">`
 in the left column and as `<fieldset><legend class="screen-reader-text">`
 in the right column. It would be much better if the `<legend>` could be
 used as visual element as well instead of having two elements. This would
 require us to get rid of the two column layout though.
 * Moving away from the two column layout would be drastic change to the
 UI. We need opinions from more core developers and also discuss this with
 the design team. Is that change acceptable, and if so, what could the new
 layout look like?
 * The `$title` is a required argument, but it's possible to specify it as
 empty. There was no concensus yet whether an empty title should be ignored
 or whether a notice should be triggered. Generally it's wrong to pass an
 empty title, but there might be edge-cases where developers want to print
 the label themselves, and this would not be possible if we enforced the
 `$title`. We probably leave it as is, but this still needs more
 discussion.

--
Ticket URL: <https://core.trac.wordpress.org/ticket/39441#comment:19>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform