1.3.1 Info and Relationships
This document gives information about the related Acquia Optimize checks:
Headers attribute specified on a cell refers to cells in the same table element
When the headers attribute is used in a table cell, its value must refer to the ID of a cell within the same table.
The headers attribute establishes a connection between a table data cell and a table header cell. When it is done correctly, this relationship allows users of assistive technologies, such as blind users, to more easily understand the structure of the table.
If the headers attribute is present on a cell but does not reference a cell within the same table, it is a strong indication of a coding error. This means the intended accessibility function is not working as expected, which leads to a significantly worse experience for users who rely on assistive technology.
This check affects the following users who have:
Visual impairments: Or other users who access the site contents with a screen reader or screen magnification software.
Bridgit is a blind mother to a five-year-old girl and an 11-year-old boy:
“You know, my little girl, she is only five, and we had to take her in for a blood test. The doctors were worried she might have diabetes, just like my dad did. I was really anxious about it, of course, as any mom would be.
So, when the results came in, I had to check them myself using my computer. Now, with my screen reader, it is always a bit tricky. The results were all in this table format, and let me tell you, it was not easy to make sense of it. The screen reader just starts reading everything out of order. So instead of getting a clear table reading, I am hearing things like "glucose level, 102," then right after, 140, cholesterol, then something like "A1C, 5.6" followed by “150”, and “6.2” without any clear connection between what these numbers mean in relation to each other.
It is like trying to sort through a jumble of information that just does not fit together. I had to go over it several times, piecing things together, and even then, I was not sure if I was understanding it all correctly. It is frustrating because, as a mom, you want to know what is going on with your child right away, but sometimes, technology just does not make it easy. Eventually, I had to call the doctor’s office to get them to explain the results to me directly, just to make sure I was not missing anything important.”
This section gives some examples of the issue.
The headers attribute on the data cells refers to a th element within the same table.
<table>
<thead>
<tr>
<th id="header1">Projects</th>
<th id="header2">Objective</th>
</tr>
</thead>
<tbody>
<tr>
<td headers="header1">15%</td>
<td headers="header2">10%</td>
</tr>
</tbody>
</table>The td elements have a headers attribute referring to an ID that does not exist within the same table. Here the referenced ID is incorrect.
Notice the difference between "headOfColumn1" and "headerOfColumn1".
<table>
<tr>
<th id="headerOfColumn1">Projects</th>
<th id="headerOfColumn2">Objective</th>
</tr>
<tr>
<td headers="headOfColumn1">15%</td>
<td headers="headOfColumn2">10%</td>
</tr>
</table>The Optimize platform identifies cases where the headers attribute is present, but its value does not point to the ID of a cell within the same table.
To resolve this issue, you need to update your HTML code so that the value of the headers attribute refers to an ID or a list of IDs for cells within the same table.
See the “ACT Rules” section below, which provides a link to a full technical explanation of this check and offers detailed examples on how to pass it.
Related accessibility conformance testing rules:
If this content did not answer your questions, try searching or contacting our support team for further assistance.
Wed Oct 30 2024 12:22:05 GMT+0000 (Coordinated Universal Time)