Semantics

A cell containing header information for a row.

Additional info from the ARIA specification

The rowheader role can be used to identify a cell as a header for a row in a table, grid, or treegrid. The rowheader establishes a relationship between it and all cells in the corresponding row. It is a structural equivalent to setting scope="row" on an HTML th element.

Authors MUST ensure elements with role rowheader are accessibility children of an element with the role row.

Applying the aria-selected state on a rowheader MUST NOT cause the user agent to automatically propagate the aria-selected state to all the cells in the corresponding row. An author MAY choose to propagate selection in this manner depending on the specific application.

While the rowheader role can be used in both interactive grids and non-interactive tables, the use of aria-expanded, aria-readonly, and aria-required is only applicable to interactive elements. Therefore, authors SHOULD NOT use aria-expanded, aria-readonly, or aria-required in a rowheader that descends from a table, and user agents SHOULD NOT expose these properties to assistive technologies unless the rowheader descends from a grid or treegrid.

Abstract Role

  • StructureRepresents a non-interactive part of a page that organizes content into coherent units.

  • WidgetRepresents a focusable, interactive element.

May be an interactive Widget or non-interactive Structure, depending on the context.

Content Category

Only Used with Specific Parent Roles

This role must be a direct descendant of one of the following roles:

  • row

Allowed Descendants

Flow Children Allowed

No main element descendants allowed.

Usage

Allowed HTML elements

Implicit semantics

These elements have the role semantics by default, without needing to set the role attribute. Reach for elements with native semantics first when choosing how to implement a role in your content.

  • th­[scope=­row]

Explicitly allowed

  • th[role=rowheader]

Elements that can have any role

  • abbr[role=rowheader]
  • address[role=rowheader]
  • b[role=rowheader]
  • blockquote[role=rowheader]
  • canvas[role=rowheader]
  • cite[role=rowheader]
  • code[role=rowheader]
  • custom-element[role=rowheader]
  • data[role=rowheader]
  • del[role=rowheader]
  • dfn[role=rowheader]
  • div[role=rowheader]
  • em[role=rowheader]
  • figure[role=rowheader]
  • i[role=rowheader]
  • ins[role=rowheader]
  • kbd[role=rowheader]
  • mark[role=rowheader]
  • output[role=rowheader]
  • p[role=rowheader]
  • pre[role=rowheader]
  • q[role=rowheader]
  • samp[role=rowheader]
  • small[role=rowheader]
  • span[role=rowheader]
  • table[role=rowheader]
  • tbody[role=rowheader]
  • tfoot[role=rowheader]
  • thead[role=rowheader]
  • time[role=rowheader]
  • u[role=rowheader]
  • var[role=rowheader]