[wp-trac] [WordPress Trac] #55172: Twenty Twenty-Two: Add "Accessibility Ready" tag to theme in repository

WordPress Trac noreply at wordpress.org
Fri Aug 5 08:07:03 UTC 2022


#55172: Twenty Twenty-Two: Add "Accessibility Ready" tag to theme in repository
------------------------------------+----------------------------
 Reporter:  bph                     |       Owner:  (none)
     Type:  task (blessed)          |      Status:  new
 Priority:  normal                  |   Milestone:  6.1
Component:  Bundled Theme           |     Version:
 Severity:  normal                  |  Resolution:
 Keywords:  has-patch dev-feedback  |     Focuses:  accessibility
------------------------------------+----------------------------

Comment (by poena):

 I have tested the theme against these requirements:
 https://make.wordpress.org/themes/handbook/review/accessibility/required/

 Theme version: 1.2
 WordPress version: 6.0.1
 macOs
 Chrome
 No plugins
 Theme test data


 == Summary
 Passes all tests except a decorative image that is missing {{{aria-
 hidden}}}.
 This issue will be solved in the query pagination block in WordPress 6.1.

 Recommended:
 Headings on single posts and pages could be improved.
 The search page is missing a visible label for the search form, so this
 could be improved.

 Recommended actions:
 Test the theme again in 6.1 beta after the query pagination block has been
 updated, then decide.

 -----



 == Keyboard Navigation

 Theme authors must provide visual keyboard focus highlighting
 in navigation menus and for form fields submit buttons and text links.
 **-Passed**

 All controls and links must be reachable using the keyboard.
 **-Passed**


 == Controls
 All theme features that behave as buttons or links must use <button>,
 <input>, or <a> elements, to ensure native keyboard accessibility and
 interaction with screen reader accessibility APIs.
 **-Passed**

 All controls must also have machine-readable text to indicate the nature
 of the control.
 **-Passed**

 Note: The icon only buttons for the navigation block,
 and icon only links for social icons have accessible names.


 == Skip Links
 **-Passed**

 Note: The theme has one template that does not include the <main> element,
 and because of that it does not have a skip link by default.
 But this is the "blank" template that only shows the post content block.
 Which means that by default, it does not have anything to skip past before
 the content is reached. Advanced Users can add the main landmark by
 changing the HTML tag of blocks in the block settings sidebar.


 == Forms
 Forms must have appropriate field labels.
 All content within form tags need to be explicitly associated to a form
 control.
 **-Passed**

 Note: The default search template uses a search block with the form label
 hidden.
 Displaying the label would be an improvement, but it passes the
 requirements.


 == Headings
 **Required: Passed
 Recommended: Did not pass**

 On single posts or pages, when comments are enabled,
 the site title is an H1, the post title is an H1, but the next title
 is the "Leave a Reply" title and it is an H3, so the H2 level is skipped.
 If there are comments, the "One response to “title” is present, but it is
 also an H3:
 H1 Site Title
 H1 Sample Page
 H3 One response to “Sample Page”
 H3 Leave a Reply

 There are a few different ways to solve this, but I think
 that the best option, that would work for both older versions of WP and
 6.1,
 is to add a new heading above the comments area.


 == ARIA Landmark Roles
 Assign landmark roles to the main content areas of your site.
 All content on your site must be wrapped in at least one landmark role.
 **-Passed**

 Header, main, footer are used appropriately.
 The exception is the optional blank template.
 By default, the theme only has one nav element on each page (the main
 navigation block in the header).
 Notably, on the homepage the theme has a header element inside another
 header element.


 == Content Links
 Links within large sections of text (e.g., post content or comments) must
 be underlined.
 **-Passed**


 == Repetitive Link Text
 **-Not used, passed**


 == Contrasts
 **-Passed**


 == Images
 **-Did not pass, but will pass in WordPress 6.1**
 Query navigation uses arrows that supplement text, but do not currently
 use aria-hidden. Patches for this have been submitted for the block
 itself.


 == Media
 **-Not found, passed**


 == Screen Reader Text
 **-Passed**
 Note: Provided by WordPress core, not the theme.


 == Not Allowed
 **-Passed**
 No links in the theme are set to open in new windows by default.

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


More information about the wp-trac mailing list