SiteLint documentation and guidelines

Tab element is not owned by a tablist

Description

This rule checks that every element with a semantic role of tab is a child of an element with a semantic role of tablist. In ARIA (Accessible Rich Internet Applications), tabs are interactive controls that must be contained within a tablist to define their relationship to each other and to the associated tab panels. This structural relationship is essential for assistive technologies to properly present and allow interaction with tab interfaces.

Disabilities impacted

  • Visual impairments: users with visual impairments who rely on screen readers need the correct parent-child relationship to understand the structure of a tabbed interface. Without it, they may not know which tabs belong together, how many tabs exist, or how to navigate between them.
  • Cognitive disabilities: users with cognitive disabilities benefit from the predictable structure and behavior that a proper tablist provides. The grouping helps in understanding that a set of controls are related and function together.
  • Motor impairments: users who navigate via keyboard or voice commands rely on the correct ARIA relationships for proper focus management and command targeting. If a tab is not in a tablist, standard keyboard navigation patterns (like arrow keys to switch between tabs) may not work.

Why it matters

Using the correct ARIA relationships is fundamental to creating accessible custom widgets. The tab and tablist roles are designed to work together; a tab that is not owned by a tablist is an orphaned control. This breaks the expected semantics for assistive technologies, leading to a confusing and potentially unusable experience for people who rely on them. Ensuring all tabs are properly nested within a tablist guarantees that the component is interpreted and operated correctly by all users.

Coding problems and solutions

Common coding problems

  • Missing tablist container: a role="tab" is applied to an element, but its parent container does not have role="tablist".
  • Incorrect element nesting: a tab element is placed inside a different type of container (e.g., a generic div or a list) that has not been given the tablist role.
  • Incorrect ARIA roles on parent: the parent container has a different ARIA role (e.g., role="group") instead of role="tablist".

How to Fix It

Wrap tabs in a tablist

Ensure all elements with role="tab" are direct children of an element with role="tablist".

Correct example
<div role="tablist">   <!-- The tablist container -->
    <button role="tab" aria-selected="true" aria-controls="panel1" id="tab1">Tab 1</button>
    <button role="tab" aria-selected="false" aria-controls="panel2" id="tab2">Tab 2</button>
</div>
<div role="tabpanel" id="panel1" aria-labelledby="tab1">...</div>
<div role="tabpanel" id="panel2" aria-labelledby="tab2">...</div>
Incorrect example
<!-- Tabs are direct children of a div with no role -->
<div>
    <button role="tab" aria-selected="true" aria-controls="panel1" id="tab1">Tab 1</button>
    <button role="tab" aria-selected="false" aria-controls="panel2" id="tab2">Tab 2</button>
</div>

Use native HTML semantics

If possible, use native HTML elements that imply the correct relationships, reducing the need for explicit ARIA roles.

Correct example (using native HTML)
<!-- A native <menu> element with <button> children. -->
<!-- Note: This example is structurally correct, but fully functional tabs still require JavaScript and the proper ARIA attributes for states and properties like aria-selected. -->
<menu>
    <li><button aria-selected="true">Tab 1</button></li>
    <li><button aria-selected="false">Tab 2</button></li>
</menu>
Incorrect example
<!-- Using a list without assigning the 'tablist' role to the parent. -->
<ul>
    <li role="tab">Tab 1</li>   <!-- List item has role="tab", but the <ul> is not a tablist -->
    <li role="tab">Tab 2</li>
</ul>

Known Limitations

  • DOM vs. Accessibility Tree: This rule checks the direct parent-child relationship in the DOM. In some complex, dynamically generated interfaces, an element might be programmatically associated with a tablist using aria-owns. While aria-owns can fix the relationship in the accessibility tree, best practice is to maintain proper DOM nesting.
  • Nested tablists: This rule is designed to catch top-level orphaned tabs. In scenarios with nested tablists, it verifies that each tab has an immediate parent tablist, but it does not validate the logical grouping of the nested structure itself.
  • Static analysis: As an automated check, this rule verifies the code structure at the time of testing. It cannot account for dynamic changes where a tablist container might be added or removed after the initial page load.

Resources

Rule

  • Audit: Accessibility
  • Standard: WCAG 2.1
  • Level: A
  • Success Criteria: 1.3.1 Info and Relationships
  • ID: tab-missing-tablist-owner