Semantics

A single item in a list or directory.

Additional info from the ARIA specification

Authors MUST ensure elements whose role is listitem are accessibility children of an element whose role is list.

Abstract Role

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

Content Category

Only Used with Specific Parent Roles

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

  • list

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.

  • li

Explicitly allowed

  • dt[role=listitem]

Elements that can have any role

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