Problem

Webform elements support 3 types of descriptions (default, help icon, and more text) which are causing accessibility issues where an element's aria-described-by is not pointing to any descriptive text.

Solution

Refactor description, help, and more to make sure that an element's aria-described-by attribute points to the correct description

Notes

  • Description must not be empty to defined 'aria-described-by'.
  • Help that matches description should use aria-hidden to prevent screen reader duplication.

See

  • \Drupal\Core\Form\FormBuilder::doBuildForm
  • template_preprocess_form_element()
CommentFileSizeAuthor
#14 2983248-14.patch81.33 KBjrockowitz
#13 2983248-13.patch79.96 KBjrockowitz

Comments

jrockowitz created an issue. See original summary.

  • jrockowitz committed 72a3abf on 2983248-element-description 
    Issue #2983248: [accessibility] Improve element description handling

  • jrockowitz committed 1fe214a on 2983248-element-description 
    Issue #2983248: [accessibility] Improve element description handling

  • jrockowitz committed 5cc23eb on 2983248-element-description 
    Issue #2983248: [accessibility] Improve element description handling....
jrockowitz’s picture

jrockowitz commented
Title: [accessibility] Improve element description handling » [accessibility] Improve element, details, and fieldset description handling
Issue summary: View changes

  • jrockowitz committed bc11688 on 2983248-element-description 
    Issue #2983248: [accessibility] Improve element description handling....

  • jrockowitz committed 7dae77d on 2983248-element-description 
    Issue #2983248: [accessibility] Improve element description handling....

  • jrockowitz committed 8450845 on 2983248-element-description 
    Issue #2983248: [accessibility] Improve element description handling....

  • jrockowitz committed bedf0a9 on 2983248-element-description 
    Issue #2983248: [accessibility] Improve element description handling....

  • jrockowitz committed 3fd7b43 on 2983248-element-description 
    Issue #2983248: [accessibility] Improve element description handling....
jrockowitz’s picture

jrockowitz commented
Issue summary: View changes

  • jrockowitz committed 7722600 on 2983248-element-description 
    Issue #2983248: [accessibility] Improve element description handling....
jrockowitz’s picture

jrockowitz commented
Status: Active » Needs review
StatusFileSize
new 2983248-13.patch79.96 KB
jrockowitz’s picture

jrockowitz commented
StatusFileSize
new 2983248-14.patch81.33 KB

  • jrockowitz committed 35aa61f on 2983248-element-description 
    Issue #2983248: [accessibility] Improve element description handling....

  • jrockowitz committed ed5fc4a on 8.x-5.x 
    Issue #2983248 by jrockowitz: [accessibility] Improve element, details,...
jrockowitz’s picture

jrockowitz commented
Status: Needs review » Fixed

  • jrockowitz committed 02a69cf on 8.x-5.x 
    Issue #2983248: [accessibility] Improve element description handling....

Status: Fixed » Closed (fixed)

Automatically closed - issue fixed for 2 weeks with no activity.