Semantics

A list of tab elements, which are references to tabpanel elements.

Additional info from the ARIA specification

To be keyboard accessible, authors SHOULD manage focus of descendants for all instances of this role, as described in Managing Focus.

For a single-selectable tablist, authors SHOULD hide from all users other tabpanel elements until the user selects the tab associated with that tabpanel. For a multi-selectable tablist, authors SHOULD ensure that the tab for each visible tabpanel has the aria-expanded attribute set to true, and that the tabs associated with the remaining hidden from all users tabpanel elements have their aria-expanded attributes set to false.

tablist elements are typically placed near, and usually preceding, a series of tabpanel elements. See the ARIA Authoring Practices Guide for details on implementing a tab set design pattern.

Elements with the role tablist have an implicit aria-orientation value of horizontal.

Abstract Role

  • CompositeRepresents a container for navigating interactive descendants.

Content Categories

  • Flow ContentAn element that structures and organizes the body of a web document.

Allowed Descendants

Specific Guidance

Only tab roles allowed.

Usage

Allowed HTML elements

Implicit semantics

  • None

Explicitly allowed

  • menu[role=tablist]
  • nav[role=tablist]
  • ol[role=tablist]
  • ul[role=tablist]

Elements that can have any role

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