Skip to content

[19637] fix: Add role="presentation" to container elements to fix aria-required-children violation - #19638

Open
fkwq34 wants to merge 1 commit into
primefaces:masterfrom
fkwq34:stepper-accessibility
Open

[19637] fix: Add role="presentation" to container elements to fix aria-required-children violation#19638
fkwq34 wants to merge 1 commit into
primefaces:masterfrom
fkwq34:stepper-accessibility

Conversation

@fkwq34

@fkwq34 fkwq34 commented Jun 23, 2026

Copy link
Copy Markdown

fixes: #19637

Fixes aria-required-children accessibility violation in the Stepper component.

Problem
The p-stepper component has role="tablist" which requires direct child elements with role="tab". The intermediate container components (p-step-list, p-step-item, p-step-panels) didn't have any ARIA role, breaking the required parent-child relationship.

Solution
Added role="presentation" to container components to make them semantically transparent:

  • p-step-list
  • p-step-item
  • p-step-panels

This allows assistive technologies to correctly perceive the tab elements as direct children of the tablist.

References
Rule: aria-required-children
WCAG: 1.3.1 Info and Relationships

@fkwq34 fkwq34 changed the title [19637] fix(stepper): add role="presentation" to container elements to fix aria-required-children violation [19637] fix: Add role="presentation" to container elements to fix aria-required-children violation Jun 23, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[A11y] Stepper: Add role="presentation" to container elements to fix aria-required-children violation

1 participant