1.3.1 Info and Relationships
This article provides 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 does not work as expected.
This check affects the following users who have:
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.
Example: A table with the correct use of the headers attribute
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>Example: A table with the wrong use of the headers attribute
The td elements have a headers attribute that refer to an ID that does not exist within the same table. The referenced ID is incorrect.
Notice the difference between headOfColumn1 and headerOfColumn1 in the following example:
<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:
headers attribute refers to an ID or a list of IDs for cells within the same table.The ACT rules section below 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.
Fri Mar 28 2025 16:11:24 GMT+0000 (Coordinated Universal Time)