Skip to content

Update: Clarify and update role allowances for td and th elements#563

Draft
scottaohara wants to merge 10 commits intogh-pagesfrom
updates-to-td-and-th-elements
Draft

Update: Clarify and update role allowances for td and th elements#563
scottaohara wants to merge 10 commits intogh-pagesfrom
updates-to-td-and-th-elements

Conversation

@scottaohara
Copy link
Copy Markdown
Member

@scottaohara scottaohara commented Jan 8, 2026

This PR covers a few things:

  1. clarifies that the mention of "ancestor table" was meant to mean "nearest ancestor table" - re: Cells with role="presentation" of a nested table with role="presentation" are stated as invalid validator/validator#1304
  2. Per feedback / use cases for correcting errant tables, the allowances for td and th elements have been expanded to allow other reasonable roles that developers may need to use.
  3. It is meant to supersede parts of the dormant PR updates table element allowances #265
  4. this will close <td> and role="columnheader/rowheader" #562

TODO: need test cases / updated test cases for the updated role allowances.


Preview | Diff

This PR covers a few things:

1. clarifies that the mention of "ancestor table" was meant to mean "nearest ancestor table" - re: validator/validator#1304
2. Per feedback / use cases for correcting errant tables, the allowances for td and th elements have been expanded to allow other reasonable roles that developers may need to use.
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html Outdated
Comment thread index.html
<div class="note">
<p>
If a `td` element is a descendant of a `table` element with exposed with a role of `table`, `grid` or `treegrid`, and the `td` is marked as
`role=none` or `presentation`, then it is advised that the `td` contain an <a data="aria/#dfn-accessibility-child">accessibility child</a>
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

are you using "it is advised" to avoid "SHOULD"? it reads slightly clunky. In particular, the follow-up later "Otherwise, that" should at least be expanded to "Otherwise, it is advised that" or similr

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ditto in the other two places

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

could we use "we advise" rather than "it is advised"? and then "Otherwise, we advise that..."

scottaohara and others added 3 commits March 9, 2026 15:35
Co-authored-by: Patrick H. Lauke <splintered@gmail.com>
Co-authored-by: Patrick H. Lauke <splintered@gmail.com>
Co-authored-by: Patrick H. Lauke <splintered@gmail.com>
Copy link
Copy Markdown
Contributor

@daniel-montalvo daniel-montalvo left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The current additions of <a data="aria/#dfn-accessibility-child">accessibility child</a> result in a markup issue.

I suggest you addxref: ["wai-aria-1.2"], to allow for shorthands to ARIA spec, and then just replace the three instances of <a data="aria/#dfn-accessibility-child">accessibility child</a> with simply [=accessibility child=]

I am sorry I cannot commit these suggestions directly but unfortunately with the new github files changed redesigned interface it takes significantly more time for me to do that, so I'm just commenting here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

<td> and role="columnheader/rowheader"

3 participants