Django Admin - Table improvements

[reitermb]

Description:

• As a django admin user using a screen reader, I want summary data to be presented via the table caption attribute in tables I interact with
• As a django admin user using a screen reader, I want a more explicit way to select all rows in a table (i.e. i want to be able to hear a meaningful label for the select all checkbox in the header row, which may include the total number of rows to be selected). Currently, checkboxes in the tables are simply labeled with numbers. This is likely not helpful for users.

Acceptance Criteria:

• [ ] All data tables in django use table captions to provide context for table contents (e.g. Lead with table name) and hint/get read sort instructions for columns (ex: https://adrianroselli.com/2021/04/sortable-table-columns.html#Caption)
• [ ] Number of columns currently being sorted on is included in the caption
• [ ] Caption gets read via live region
• [ ] Checkbox style select all in the header row of each table has a descriptive aria label that matches the quick action. e..g. "Select all [Table objects]"
• [ ] "Select All [Table Objects]" quick action works & is present on every table (e.g. Simple tables like Groups as well as Log Entries)
• [ ] Testing Checklist has been run and all tests pass
• [ ] README is updated, if necessary

Open Questions: Table column headers have aria-label attributes with values applied to them to help users understand the sorting functionality. However, this also interferes with getting the gist of the column contents when interacting with the table cells themselves. Table data cells have the following read out with the data from the header for "Action Time": Remove Action time from sorting and Sort by Action time link which is the header contents (due to use of aria-label) followed by the cell contents of Oct. 19, 2021, 2:36 p.m. and the column number info from the browser.

Does the table caption need to list names of sorted columns as well as a count of how many columns are being sorted? (For compliance). Should be technically feasible if desired, but could lead to pretty wordy reads if somebody is sorting on a lot of different columns.

Tasks: Create a list of granular, specific work items that must be completed to deliver the desired outcomes of this issue

• [ ] Add Live region to caption with polite reading
• [ ] Add caption with count
• [ ] Task 3
• [ ] Run Testing Checklist and confirm all tests pass

Supporting Documentation: HackMD notes

Example of appropriate select all checkbox copy (in the header row of a table)

Example of Quick Action select all (which should be added to each table that doesn't have one.

[ADPennington]

11/17 notes:

• caption should be number columns sorted re: open question
• whatever should be read aloud should be in a "live region"
• append what the table is (e.g. log entry, users, etc. ) --give audience info on what the table is about.

[valcollignon]

@ADPennington @abottoms-coder @lfrohlich - what is the priority of this ticket? It's been in "Next Sprint Backlog" since November 2021. :)

Is this refined and ready to go, or should we move back to product backlog for some other time in the future?

[valcollignon]

Is this refined and ready to go, or should we move back to product backlog for some other time in the future?

Same question for #1487, #1411, #1415

[andrew-jameson]

Is this refined and ready to go, or should we move back to product backlog for some other time in the future?

Same question for #1487, #1411, #1415

Moved to product backlog per backlog refinement 3.1.22.

[stevenino]

Fully refined. This is low priority because Django will only be used by a couple of people and there is higher priority work that is required to meet the release schedule goals.

[robgendron]

@andrew-jameson is this still needed? If still relevant, should we look to move it into one of the roadmap epics?

[reitermb]

@andrew-jameson is this still needed? If still relevant, should we look to move it into one of the roadmap epics?

This / other a11y tickets that are still open should all be up to date & still needed.