Make WordPress Core

Opened 9 years ago

Closed 9 years ago

#27591 closed defect (bug) (fixed)

Screen Reader Users Do Not Know Sections in Theme Customizer are Expandable

Reported by: davidakennedy's profile davidakennedy Owned by: sergeybiryukov's profile SergeyBiryukov
Milestone: 4.0 Priority: normal
Severity: normal Version: 3.4
Component: Customize Keywords: has-patch commit
Focuses: accessibility Cc:


The issue: When testing the new Widget customizer with a screen reader (in this case Mac OS 10.2 with Voiceover and Chrome), the arrows that expand each Customizer section(s) do not announce in a screen reader. A screen reader user may have no idea they are expandable. Note: this is a pattern that exist throughout the Customizer, not just with the new Widget customizer additions.

This relates to this kind of markup on the /wp-admin/customize.php screen.

<li id="accordion-section-title_tagline" class="control-section accordion-section top">
    <h3 class="accordion-section-title" tabindex="0">Site Title &amp; Tagline</h3>
    <ul class="accordion-section-content">
        <li id="customize-control-blogname" class="customize-control customize-control-text">
                <span class="customize-control-title">Site Title</span>
                <input type="text" value="Super Awesome WordPress Trunk Testing Site" data-customize-setting-link="blogname">
            </li><li id="customize-control-blogdescription" class="customize-control customize-control-text">
                <span class="customize-control-title">Tagline</span>
                <input type="text" value="Just Another Super Awesome WordPress Trunk Testing Site for Theme Development" data-customize-setting-link="blogdescription">
            </li><li id="customize-control-display_header_text" class="customize-control customize-control-checkbox">
                <input type="checkbox" value="fff" data-customize-setting-link="header_textcolor">
                Display Site Title &amp; Tagline

What I expected: Some way to know via announcement with the screen reader that the heading elements are expandable.

Recommendation: Use a similar markup pattern to this accessible accordion that relies heavily on WAI-ARIA:

I'd be happy to consult on and test potential solutions.

Attachments (2)

27591.patch (1.6 KB) - added by joedolson 9 years ago.
Adds screen reader notice how to expand panels
27591.2.patch (1.6 KB) - added by ocean90 9 years ago.

Download all attachments as: .zip

Change History (15)

#1 follow-up: @westonruter
9 years ago

@davidakennedy: Is this same problem also present on the widgets admin page?

#2 @ocean90
9 years ago

  • Keywords needs-patch 4.0-early added
  • Milestone changed from Awaiting Review to Future Release

#3 @SergeyBiryukov
9 years ago

  • Version changed from trunk to 3.4

Related: #27592

#4 in reply to: ↑ 1 @davidakennedy
9 years ago

Replying to westonruter:

@davidakennedy: Is this same problem also present on the widgets admin page?

Yes, looks that way. I glanced at the markup and it's nearly identical. Ticket #27592 also applies there. So we should definitely try to address both areas.

Should I create a separate ticket for that or should we change the component to Widgets and use this ticket for both areas?

By the way, great job with the Widget customizer! It works great navigating with a keyboard only. :)

#5 @davidakennedy
9 years ago

Never mind, just saw this comment: Sounds good to me!

#6 follow-up: @DrewAPicture
9 years ago

Seems like this also may be an issue in the menus screen as (last time I checked) there is shared code there.

#7 in reply to: ↑ 6 @davidakennedy
9 years ago

Replying to DrewAPicture:

Seems like this also may be an issue in the menus screen as (last time I checked) there is shared code there.

You're right. The code is very similar once you add menu items. I'll take a closer look soon. We should definitely try to tackle this as a pattern across the Admin and see if we can't make it better everywhere.

9 years ago

Adds screen reader notice how to expand panels

#8 @SergeyBiryukov
9 years ago

  • Keywords has-patch added; needs-patch removed
  • Milestone changed from Future Release to 4.0

9 years ago

#9 @ocean90
9 years ago

joedolson, is there a difference between "enter" and "return" for screen readers?

In 27591.2.patch I reverted the tabindex="-1" change, otherwise I couldn't access the panel via tabbing.

#10 @celloexpressions
9 years ago

The tabindicies are automatically turned on and off with JS as of so no, that change isn't needed.

To help distinguish between panels and top-level sections, can we use the word open instead of expand for panels? Sighted users have a small visual indicator of the direction it'll open in, but then get a very large animation to indicate the change of context going into a panel. I'm worried that screen reader users could easily become lost or disoriented going into or out of a panel, especially if panels aren't grouped together at the top.

#11 @joedolson
9 years ago

I don't have a problem with using open instead of expand; that's probably a better word choice, on the whole. As to return/enter, there's no difference between the two for screen readers - but I'm not sure what the generally preferred term is. Either works for me.

#12 @celloexpressions
9 years ago

  • Keywords commit added; 4.0-early removed

#13 @SergeyBiryukov
9 years ago

  • Owner set to SergeyBiryukov
  • Resolution set to fixed
  • Status changed from new to closed

In 29240:

Customizer: Add screen reader text to announce that panels and sections are expandable.

props joedolson, ocean90.
fixes #27591.

Note: See TracTickets for help on using tickets.