Semantics

A set of user interface objects that is not intended to be included in a page summary or table of contents by assistive technologies.

Additional info from the ARIA specification

Contrast with region, which is a grouping of user interface objects that will be included in a page summary or table of contents.

Authors SHOULD use a group to form a logical collection of items in a widget, such as children in a tree widget forming a collection of siblings in a hierarchy. However, when a group is used in the context of a listbox, for example, authors MUST limit its children to option elements. Therefore, proper handling of group by authors and assistive technologies is determined by the context in which it is provided.

Authors MAY nest group elements. If a section is significant enough to warrant inclusion in the web page's table of contents, the author SHOULD assign it a role of region or a standard landmark role.

Abstract Role

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

Content Categories

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

Allowed Descendants

Flow Children 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.

  • details
  • fieldset
  • optgroup

Explicitly allowed

  • dl[role=group]
  • figcaption[role=group]
  • footer[role=group]
  • header[role=group]
  • menu[role=group]
  • ol[role=group]
  • ul[role=group]

Elements that can have any role

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