Improving the accessibility of the date_hierarchy layout in the admin.

[Antoliny]

When navigating to the date_hierarchy area in the admin page using a screen reader, no specific description is provided for that section. Currently, the only information announced is that it is a "navigation" area.

As a result, screen reader users may find it difficult to understand the purpose of the links contained within this area when they access it. The lack of context makes it unclear what role these links play.

[Chaitanya]

in admin/date_hierarchy.html

aria is one way of fixing it like below

<nav class="toplinks" aria-label="Date filter">

now the screen reader says "Date filter navigation" instead of "navigation".

or Else we can have a hidden <h> tag which also does the same thing but will be announced while going through headings of the page like below. (definitely not the best way)

<h3 class="visually-hidden">Date filter navigation</h3>

any other ways to fix??

[Antoliny]

Replying to Chaitanya:

in admin/date_hierarchy.html

aria is one way of fixing it like below

<nav class="toplinks" aria-label="Date filter">

now the screen reader says "Date filter navigation" instead of "navigation".

or Else we can have a hidden <h> tag which also does the same thing but will be announced while going through headings of the page like below. (definitely not the best way)

<h3 class="visually-hidden">Date filter navigation</h3>

any other ways to fix??

Great! I think the changes above are necessary.

In addition, I believe the biggest issue here is how to convey the sorted order in the date_hierarchy.

Hmm... I've been thinking a lot about this recently as well, and I feel like we might need to slightly restructure this part.

[Chaitanya]

Do we need to really convey the sorted order?? if yes then we can have the same aria label to say something like "sorted date filter navigation".
I don't think we need to announce the sorted order.

[Antoliny]

Replying to Chaitanya:

Do we need to really convey the sorted order?? if yes then we can have the same aria label to say something like "sorted date filter navigation".
I don't think we need to announce the sorted order.

Yes, on second thought, since the date hierarchy already conveys its basic meaning, there's no need to provide additional information.
I think just adding a label should be enough. --> nav, aria-labelledby

However, I do think the word "hierarchy" should definitely be included, rather than simply calling it a date filter.
After all, users need to understand that this is ultimately a hierarchical structure.

[Chaitanya]

PR ​https://github.com/django/django/pull/19688