Opened 3 weeks ago

Last modified 3 weeks ago

#36630 assigned Bug

Semantic structure and accessibility improvements for the admin navigation sidebar.

Reported by: Antoliny Owned by: Antoliny
Component: contrib.admin Version: 5.2
Severity: Normal Keywords: accessibility
Cc: Eliana Rosselli, Thibaud Colas, Sarah Abderemane, Tom Carrick Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description (last modified by Antoliny)

Currently, the admin navigation sidebar is built using <table> tags.
I don’t think this structure is appropriate from an accessibility perspective.
It has the following issues:

  • When accessing the sidebar, it is described as a table, but I’m not sure if the structure that users imagine when they hear “table” matches the actual structure of the sidebar.


  • When accessing a row element, the table structure provides a description of which column each item is in. However, since the sidebar does not have the last column, users expect three items in a row, but in reality, only two items are accessible.


  • When navigating elements with a screen reader, they are traversed in the wrong order.

Currently, when using the standard element navigation of a screen reader, it moves to the end of the table without accessing the internal elements.
I suspect this issue might be caused by the <a> tag being placed directly under the table.

  • Incorrect navigation order during tab navigation.

When using tab navigation, we would expect to navigate from the app to the models under it, but in reality, the models are navigated first, and the apps for those models are navigated last.

To resolve this issue, I believe the structure of app_list(sidebar, index, app index), should be changed to <h>, <ul>, <li>.

Attachments (2)

table_wrong_description.png (177.3 KB ) - added by Antoliny 3 weeks ago.
table_wrong_description_2.png (182.7 KB ) - added by Antoliny 3 weeks ago.

Download all attachments as: .zip

Change History (6)

by Antoliny, 3 weeks ago

Attachment: table_wrong_description.png added

by Antoliny, 3 weeks ago

comment:1 by Antoliny, 3 weeks ago

Owner: set to Antoliny
Status: newassigned

comment:2 by Antoliny, 3 weeks ago

Description: modified (diff)

comment:3 by Antoliny, 3 weeks ago

Description: modified (diff)

comment:4 by Sarah Boyce, 3 weeks ago

Cc: Eliana Rosselli Thibaud Colas Sarah Abderemane Tom Carrick added
Triage Stage: UnreviewedAccepted

I saw an agreement that this should be improved within #accessibility in the Discord channel. It may make sense to agree the semantic structure/design before this is picked up

Note: See TracTickets for help on using tickets.
Back to Top