Content · Web Development · HTML

HTML tablist ARIA Role: Reference and Examples

Understand the tablist ARIA role, when it helps accessibility, a clear HTML example and mistakes to avoid.

1 views Published Oct 19, 2026 Updated Oct 19, 2026 Admin

A screen reader needs to know what a piece of a page is, not only what it looks like. The ARIA role tablist describes a group containing related tab controls.

What this role means


A group containing related tab controls.

ARIA roles add meaning to the accessibility tree. They do not automatically make something clickable, move keyboard focus or build an interface. Those behaviors come from native HTML controls or from correctly implemented JavaScript.

See tablist in a real page


<nav aria-label="Project pages">
    <a href="overview.html">Overview</a>
    <a href="files.html">Files</a>
</nav>

Read the example


You may notice that the snippet does not write role="tablist" explicitly. That is intentional: the native element already communicates this meaning, so repeating the role would add unnecessary markup.

Ordinary navigation links are not tabs. A custom tablist needs matching tabs and tabpanels.

When to use it


Start with native HTML whenever possible. Add ARIA only when it provides missing meaning for an interface that you cannot build with the appropriate native element.

For custom interactive widgets, test with the keyboard and a screen reader. Depending on the pattern, you may need Enter or Space activation, arrow-key handling, state changes, focus movement and a clear accessible name. Assigning the role alone implements none of these.

Try it yourself


Put the example on a practice page and inspect it using your browser accessibility panel. If it includes interactive controls, reach them with Tab and check whether they work without a mouse. Explain whether the semantics come from native HTML or an explicit ARIA role.

Common Beginner Mistakes


  • Adding role="tablist" without checking whether an ordinary HTML element already supplies the right semantics.
  • Ordinary navigation links are not tabs. A custom tablist needs matching tabs and tabpanels.
  • Confusing the role announced by a screen reader with the behavior that the browser implements.

Key Takeaways


  • tablist is related to a group containing related tab controls.
  • Ordinary navigation links are not tabs. A custom tablist needs matching tabs and tabpanels.
  • Native HTML is the first choice; ARIA should clarify meaning, not replace working HTML.
Share this resourceSend this page to someone who may find it useful.