[feat]: add `aria-orientation` support to `TabsAriaController`
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 4/5
- Temps estimé
- 1-2 jours
- Accessibilité débutants
- 57/100
- Type d'issue
- Fonctionnalité
- Clarté
- Plutôt claire
- Activité
- Active
- Stack technique
- typescript
- Domaine
- accessibility, frontend
Piste de recherche
Start with core/pfe-core/controllers/tabs-aria-controller.ts and trace how pf-v5-tabs supplies its tablist and vertical state, then check how RovingTabindexController reads orientation. Implementing this spans controller ownership, component wiring, runtime orientation changes, and SSR behavior; the issue names controller tests as the place to cover horizontal, vertical, and switching orientation. Done when the tablist exposes the correct orientation and keyboard navigation follows it.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Summary
TabsAriaController does not set aria-orientation on the tablist, and nothing wires a tabs element's vertical/horizontal state into the accessibility tree.
Current state
TabsAriaController (core/pfe-core/controllers/tabs-aria-controller.ts) only:
- sets
role="tab"androle="tabpanel"on slotted children - sets
aria-controlsandaria-labelledbyinhostUpdated()
It never touches the tablist itself. In pf-v5-tabs, the tablist is an inner <div id="tabs" role="tablist"> with no aria-orientation, while the element has a vertical boolean that only drives styling.
// tabs-aria-controller.ts
hostUpdated(): void {
for (const [tab, panel] of this.#tabPanelMap) {
panel.setAttribute('aria-labelledby', tab.id);
tab.setAttribute('aria-controls', panel.id);
}
}
Problems
-
Missing ARIA state. A vertical tablist has no
aria-orientation="vertical", so assistive tech reports the wrong orientation. Per the ARIA spec,aria-orientationdefaults tohorizontalontablist, so a vertical tablist is actively announced incorrectly. -
Keyboard behavior is not orientation-aware.
ATFocusController.onKeydownreadsaria-orientationfrom the items container to decide which arrow keys move focus:const orientation = this.options.getOrientation?.() ?? this .#itemsContainerElement ?.getAttribute('aria-orientation') as 'horizontal' | 'vertical' | 'grid' | 'undefined';Because the tablist never has the attribute and
pf-v5-tabsdoes not passgetOrientationtoRovingTabindexController, both Left/Right and Up/Down move focus in a horizontal tablist. The APG tabs pattern expects Left/Right for horizontal tablists and Up/Down for vertical ones. -
Duplicated ownership.
role="tablist"is hardcoded in thepf-v5-tabsrender while the rest of the tabs ARIA is managed by the controller. This split makes it easy for one side to drift from the other.
Proposed direction
- Add tablist ARIA management to
TabsAriaController, includingaria-orientation. - Accept an orientation source in
TabsAriaControllerOptions, for exampleorientation?: 'horizontal' | 'vertical'orgetOrientation?: () => 'horizontal' | 'vertical', and reflect it toaria-orientationon the tablist (omit the attribute for the horizontal default, or set it explicitly, whichever the team prefers). - Give the controller a way to reference the tablist element. Since the host is not the tablist in
pf-v5-tabs, this likely needs an option such asgetTabList?: () => HTMLElement | null, or a documented contract that the host itself carriesrole="tablist". - Feed the same orientation to
RovingTabindexControllerviagetOrientation, or rely on the attribute once the controller sets it on the items container. - Consider moving
role="tablist"ownership into the controller as part of this change. - Keep the SSR path safe (
isServerguard) and add controller tests covering horizontal, vertical, and switching orientation at runtime.
Impacted components
core/pfe-core/controllers/tabs-aria-controller.tselements/pf-v5-tabs<pf-v6-tabs>implementation in #3040
Related issues
- #3040
Jira Issue: FELT-5230
- Langage dominant
- TypeScript
- Étoiles
- 397
- Forks
- 109
- Métriques de merge des PR
- Aucune PR mergée en 30 j
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Propose un modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de patternfly/patternfly-elements
-
[feat]: support non-element `ReactiveControllerHost` in pfe-core controllersPeut-être à nouveau libre @bennypowers l’a pris il y a 30 jours, et aucune pull request n’est ouverte. Ouvertebreaking change feature needs discussion
patternfly/patternfly-elements#3166 · 1 personne assignée ·
-
[bug] ssr-shims.js uses deprecated globalThis.litSsrCallConnectedCallbackPeut-être pris @zeroedin l’a pris il y a 106 jours. Ouvertebug
patternfly/patternfly-elements#3158 · 1 personne assignée ·
-
chore: evaluate removing isolatedDeclarations from tsconfigPeut-être à nouveau libre @bennypowers l’a pris il y a 196 jours, et aucune pull request n’est ouverte. Ouverte
patternfly/patternfly-elements#3136 · 1 commentaire · 1 personne assignée ·
-
chore: update docs scaffolding for v6 elementsPeut-être à nouveau libre @zeroedin l’a pris il y a 196 jours, et aucune pull request n’est ouverte. Ouvertedocs
patternfly/patternfly-elements#3131 · 1 personne assignée ·
-
Difficulté 4/5 3-5 jours Accessibilité débutants 55/100
patternfly/patternfly-elements#3122 ·
Toutes les issues de patternfly/patternfly-elements
Issues similaires
-
[Site] Active section detection should respect scroll-margin-topPeut-être pris Une pull request liée à cette issue est ouverte ou déjà fusionnée. Ouvertearea/web reproduced type/bug
Difficulté 2/5 1-3 heures Accessibilité débutants 65/100
anomalyco/opencode#65384 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour
-
bug
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
swc-project/swc-ai-issues#1001 ·
-
Add: Da Vinci Asia VietnamOuvertecheck:passed streams:add
Difficulté 1/5 Moins d'une heure Accessibilité débutants 62/100
Les mainteneurs répondent en général sous 1 jour
-
fix(table): CollapseColumn uses wrong caret icon for expandable row togglePeut-être pris @redhat-chai-bot l’a pris aujourd’hui. Ouverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 85/100
patternfly/patternfly-react#12727 ·
Les mainteneurs répondent en général sous 1 jour
-
CLI OAuth login fails behind an authenticating proxy: GET /api/v1/user omits Proxy-AuthorizationOuverte
Difficulté 1/5 Moins d'une heure Accessibilité débutants 85/100
lightdash/lightdash#33086 · 1 commentaire ·
Les mainteneurs répondent en général sous 1 jour