act-rules.github.io/_rules/table-headers-attribute-refer-to-data-cells-a25f45.md at 139863f7c2929814d7f8c7bb66e0167dfc75bb34 · act-rules/act-rules.github.io

a25f45

name

Headers attribute specified on a cell refers to cells in the same table element

rule_type

atomic

description

This rule checks that the `headers` attribute on a cell refer to other cells in the same `table` element.

accessibility_requirements

wcag20:1.3.1

wcag-technique:H43

forConformance	failed	passed	inapplicable
true	not satisfied	further testing needed	further testing needed

forConformance	failed	passed	inapplicable
false	not satisfied	further testing needed	further testing needed

input_aspects

DOM Tree

CSS Styling

acknowledgments

authors

funding

Audrey Maniez

Jey Nandakumar

Tom Brunet

WAI-Tools

Applicability

This rule applies to any headers attribute specified on a cell within a table element, where all of the following is true for the table element:

The table is visible; and
The table is included in the accessibility tree; and
The table has a semantic role of table, grid or treegrid.

Expectation 1

Each target's attribute value is a set of space separated tokens. Each token is the value of the id attribute of an element, which is a th element of the same table.

Expectation 2

Each target's attribute value is a set of space separated tokens, and none of these tokens is the id of the element on which the test target is specified.

Assumptions

This rule assumes that the headers attribute is only used to identify table headers. If other information is included in the headers attribute, the rule may fail on issues that are not accessibility concerns. For example, if headers is used to include information for scripts, this rule may not be accurate.
This rule assumes that the headers attribute is required to express the relationship between data and table header cells in the same table. If the browser computes an adequate fallback header for cells that have the headers attribute value that does not correspond to the id of any one cell in the same table, success Criterion 1.3.1 Info and Relationships may be satisfied even if this rule failed.
This rule assumes that the id values on the headers attribute are unique.

Accessibility Support

Screen reader support for the headers attribute does not follow the HTML specification at this time. Some screen readers will allow td elements to be referenced by the headers attribute. Other screen readers will ignore the headers attribute completely and look for th elements within the column. Note also that HTML specification says that the headers element must reference a th element, but some screen readers allow headers to reference semantic headers (i.e., ARIA role defined) also.

Background

Bibliography

headers attribute referencing elements that are non-existent or not in the table are ignored when assigning header cells (step 3, first case, point 2).
headers attribute referencing to the cell itself are ignored when assigning header cells (step 3, first case, point 2).

Test Cases

Passed

Passed Example 1

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>

Passed Example 2

The headers attribute on the cell refers to a th element within the same table. Multiple headers are referenced for a cell with colspan of 2.

<table>
	<thead>
		<tr>
			<th id="header1">Projects</th>
			<th id="header2">Exams</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td colspan="2" headers="header1 header2">15%</td>
		</tr>
	</tbody>
</table>

Passed Example 3

The headers attribute on the data cells in the second row refers to a th element with a role of columnheader 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>

Passed Example 4

This table has multiple elements with a role of columnheader. The headers attribute on the cells lists IDs of th elements within the same table.

<table>
	<tr>
		<th colspan="2" id="header1">Projects</th>
		<th colspan="2" id="header2">Exams</th>
	</tr>
	<tr>
		<th id="e1" headers="header1">1</th>
		<th id="e2" headers="header1">2</th>
		<th id="p1" headers="header2">1</th>
		<th id="p2" headers="header2">2</th>
	</tr>
	<tr>
		<td colspan="2" headers="header1 e1 e2">15%</td>
		<td headers="header2 p1">15%</td>
		<td headers="header2 p2">45%</td>
	</tr>
</table>

Passed Example 5

The headers attribute on the second data cell in each row refers to a th element with a role of rowheader within the same table.

<table>
	<tbody>
		<tr>
			<th role="rowheader" id="headerAge">Age</th>
			<td headers="headerAge">65</td>
		</tr>
		<tr>
			<th role="rowheader" id="headerObjective">Objective</th>
			<td headers="headerObjective">40%</td>
		</tr>
	</tbody>
</table>

Passed Example 6

The headers attribute on the last two th elements refers to another th element within the same table. Here the column header has a span of two columns.

<table>
	<tr>
		<th id="name" colspan="2">Name</th>
	</tr>
	<tr>
		<th headers="name">Firstname</th>
		<th headers="name">Lastname</th>
	</tr>
</table>

Passed Example 7

The headers attribute on the cells refers to th elements which are row scoped & within the same table.

<table>
	<tr>
		<th id="projects1" scope="row">Projects</th>
		<th id="progress1" scope="row">Progress</th>
	</tr>
	<tr>
		<td headers="projects1">My Project</td>
		<td headers="progress1">15%</td>
	</tr>
</table>

Passed Example 8

The headers attribute on the cell refers to th element which is not the same column as the cell.

<table>
	<tr>
		<td></td>
		<th id="projects2">Projects</th>
	</tr>
	<tr>
		<td headers="projects2">15%</td>
		<td></td>
	</tr>
</table>

Failed

Failed Example 1

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.

<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>

Failed Example 2

The td elements have a headers attribute referring to an ID that exist in a separate table.

<table>
	<tr>
		<th id="headOfColumn1">Projects</th>
		<th id="headOfColumn2">Objective</th>
	</tr>
</table>

<table>
	<tr>
		<td headers="headOfColumn1">15%</td>
		<td headers="headOfColumn2">10%</td>
	</tr>
</table>

Failed Example 3

The td element has a headers attribute referring to its own ID.

<table>
	<tr>
		<th>Event Type</th>
	</tr>
	<tr>
		<td id="headerBday" headers="headerBday">
			Birthday
		</td>
	</tr>
</table>

Failed Example 4

The headers attribute on the data cells in the second row refers to an element inside the same table which is not a cell nor a th element.

<table>
	<tr>
		<td>
			<span id="headerProject">Projects</span>
		</td>
		<td>
			<span id="headerObjective">Objective</span>
		</td>
	</tr>
	<tr>
		<td headers="headerProject">
			15%
		</td>
		<td headers="headerObjective">
			10%
		</td>
	</tr>
</table>

Failed Example 5

The headers attribute on the data cells refers to a td element within the same table and not a th element.

<table>
	<thead>
		<tr>
			<td id="header1">Projects</td>
			<td id="header2">Objective</td>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td headers="header1">15%</td>
			<td headers="header2">10%</td>
		</tr>
	</tbody>
</table>

Inapplicable

Inapplicable Example 1

There is no headers attribute.

<table>
	<tr>
		<th scope="col">Projects</th>
		<th scope="col">Exams</th>
	</tr>
	<tr>
		<td>15%</td>
		<td>45%</td>
	</tr>
</table>

Inapplicable Example 2

The table has a role="presentation" and thus is not included in the accessibility tree.

<table role="presentation">
	<tr>
		<td id="header1">Project Status</td>
		<td id="header2">Objective</td>
	</tr>
	<tr>
		<td headers="header1">15%</td>
		<td headers="header2">10%</td>
	</tr>
</table>

Inapplicable Example 3

The table is not visible in page.

<html>
	<style>
		.notInPage {
			position: absolute;
			left: -9999px;
			top: -9999px;
		}
	</style>
	<table class="notInPage">
		<tr>
			<th id="header1">Project Status</th>
			<th id="header2">Objective</th>
		</tr>
		<tr>
			<td headers="header1">15%</td>
			<td headers="header2">10%</td>
		</tr>
	</table>
</html>

Inapplicable Example 4

The rule applies only to headers attribute within a table element.

<div role="table">
	<div role="row">
		<div role="columnheader" id="header1">Projects</div>
		<div role="columnheader" id="header2">Exams</div>
	</div>
	<div role="row">
		<div role="cell" headers="header2">15%</div>
		<div role="cell" headers="header1">15%</div>
	</div>
</div>

Inapplicable Example 5

The table is not included in the accessibility tree.

<table style="display:none;">
	<tr>
		<td id="header1">Project Status</td>
		<td id="header2">Objective</td>
	</tr>
	<tr>
		<td headers="header1">15%</td>
		<td headers="header2">10%</td>
	</tr>
</table>

Inapplicable Example 6

This table doesn't have a role of table, grid or treegrid.

<table role="region">
	<td id="self" headers="self">World</td>
</table>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Applicability

Expectation 1

Expectation 2

Assumptions

Accessibility Support

Background

Bibliography

Test Cases

Passed

Passed Example 1

Passed Example 2

Passed Example 3

Passed Example 4

Passed Example 5

Passed Example 6

Passed Example 7

Passed Example 8

Failed

Failed Example 1

Failed Example 2

Failed Example 3

Failed Example 4

Failed Example 5

Inapplicable

Inapplicable Example 1

Inapplicable Example 2

Inapplicable Example 3

Inapplicable Example 4

Inapplicable Example 5

Inapplicable Example 6

FilesExpand file tree

table-headers-attribute-refer-to-data-cells-a25f45.md

Latest commit

History

table-headers-attribute-refer-to-data-cells-a25f45.md

File metadata and controls

Applicability

Expectation 1

Expectation 2

Assumptions

Accessibility Support

Background

Bibliography

Test Cases

Passed

Passed Example 1

Passed Example 2

Passed Example 3

Passed Example 4

Passed Example 5

Passed Example 6

Passed Example 7

Passed Example 8

Failed

Failed Example 1

Failed Example 2

Failed Example 3

Failed Example 4

Failed Example 5

Inapplicable

Inapplicable Example 1

Inapplicable Example 2

Inapplicable Example 3

Inapplicable Example 4

Inapplicable Example 5

Inapplicable Example 6