Download & Extend

Add ARIA landmarks for Seven theme

Project:Drupal core
Version:8.x-dev
Component:Seven theme
Category:task
Priority:normal
Assigned:Unassigned
Status:closed (fixed)
Issue tags:a11ySprint, accessibility, aria

Issue Summary

Problem/Motivation

As a screenreader user, I need helpful ARIA landmarks so I can efficiently use the Drupal administration screens and jump to the correct parts of each page. The Seven theme for administration tasks needs ARIA landmarks to improve its accessibility.

Proposed resolution

Screenshots are attached showing the proposed ARIA landmarks to apply to different sections of the page on Drupal administration screens in the Seven theme.

The first screenshot shows the basic landmarks that should appear on every page. The second one shows internal landmarks on some pages that have multiple areas of tools. The third screenshot shows that the tabs (primary tabs and secondary tabs) should get a navigation landmark.

Remaining tasks

Based on the screenshots attached, the appropriate ARIA attributes should be added to the specified elements of the admin pages. This should be a simple job of adding appropriate markup into Seven theme template files.

User interface changes

None, except for screenreader users who will be able to navigate within a page using landmarks.

API changes

None.

(Thanks to David MacDonald who works with the W3C and attended the Montreal Drupal Accessibility Sprint for recommendations on these landmarks.)

AttachmentSizeStatusTest resultOperations
aria-landmarks-seven-admin.png70.93 KBIgnored: Check issue status.NoneNone
aria-landmarks-seven-admin-internal.png180.36 KBIgnored: Check issue status.NoneNone

Comments

#1

AttachmentSizeStatusTest resultOperations
aria-landmarks-seven-tabs.png86.02 KBIgnored: Check issue status.NoneNone

#2

Shouldn't these ARIA landmarks be in the default templates too?

#3

@JohnAlbin, I suggest we handle the other themes and the default templates as a separate issue (one has not been opened yet, AFAIK). The reason is that they are actually more complex with many more regions that need landmarks (like sidebars, footer, and such). The Seven theme and administration screens are comparatively simple.

But if you feel otherwise, we could add specs here for all core themes and make this one mega-issue to add ARIA landmarks.

#4

Status:needs work» needs review

Let's see if this gets things moving.

AttachmentSizeStatusTest resultOperations
seven-aria-landmark-roles-1643410-4.patch1.3 KBIdleFAILED: [[SimpleTest]]: [MySQL] Unable to apply patch seven-aria-landmark-roles-1643410-4.patch. Unable to apply patch. See the log in the details link for more information.View details

#5

Issue tags:+aria

forgot to tag.

#6

+1

#7

#8

Issue tags:+a11ySprint

tagging.

#9

Status:needs review» needs work

The last submitted patch, seven-aria-landmark-roles-1643410-4.patch, failed testing.

#10

Status:needs work» needs review

The file the patch was affecting has moved to core/themes/seven/templates/page.tpl.php. Re-rolling.

AttachmentSizeStatusTest resultOperations
seven-aria-landmark-roles-1643410-10.patch1.34 KBIdlePASSED: [[SimpleTest]]: [MySQL] 50,841 pass(es).View details

#11

#12

Status:needs review» reviewed & tested by the community

This looks great. I just added a visual using https://addons.mozilla.org/en-us/firefox/addon/juicy-studio-accessibilit... and it's going to be a great addition!

AttachmentSizeStatusTest resultOperations
Screen Shot 2013-01-24 at 1.11.20 AM.png48.99 KBIgnored: Check issue status.NoneNone

#13

Status:reviewed & tested by the community» needs review

Drat, remembered when reviewing Bartik that we'd agreed to use role="contentinfo". Adding that now. Back to review.

AttachmentSizeStatusTest resultOperations
seven-aria-landmark-roles-1643410-13.patch1.53 KBIdlePASSED: [[SimpleTest]]: [MySQL] 49,272 pass(es).View details

#14

Cool, thanks Mike! :)

I'll definitely have to use that extension in the future!

#15

Assigned to:Anonymous» mparker17

Assigning to me to review.

#16

Assigned to:mparker17» Anonymous
Status:needs review» reviewed & tested by the community

Sorry about the delay in getting this RTBC'd.

Everything's looking good!

#17

Status:reviewed & tested by the community» fixed

Looks sensible to me. Committed/pushed to 8.x.

#18

Great!

#19

Thanks!

#20

Adding link to #1913692: Convert Seven to HTML5 - not really a child issue, but related. Not sure why it wasn't done before.

#21

Status:fixed» closed (fixed)

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

nobody click here