[feat]: add `aria-orientation` support to `TabsAriaController`
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 4/5
- Geschätzter Aufwand
- 1-2 Tage
- Anfängerfreundlichkeit
- 57/100
- Issue-Typ
- Feature
- Klarheit
- Größtenteils klar
- Aktivitätsstatus
- Aktiv
- Tech-Stack
- typescript
- Bereich
- accessibility, frontend
Rechercherichtung
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.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
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
- Vorherrschende Sprache
- TypeScript
- Sterne
- 397
- Forks
- 109
- PR-Merge-Kennzahlen
- Keine gemergten PRs in 30 T.
Entwicklungsumgebung
- Kein Dockerfile und keine Docker-Compose-Datei
- Hat eine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus patternfly/patternfly-elements
-
[feat]: support non-element `ReactiveControllerHost` in pfe-core controllersEvtl. wieder frei @bennypowers hat das vor 30 Tagen übernommen, und es ist kein Pull Request offen. Offenbreaking change feature needs discussion
patternfly/patternfly-elements#3166 · 1 zugewiesene Person ·
-
[bug] ssr-shims.js uses deprecated globalThis.litSsrCallConnectedCallbackEvtl. vergeben @zeroedin hat das vor 106 Tagen übernommen. Offenbug
patternfly/patternfly-elements#3158 · 1 zugewiesene Person ·
-
chore: evaluate removing isolatedDeclarations from tsconfigEvtl. wieder frei @bennypowers hat das vor 196 Tagen übernommen, und es ist kein Pull Request offen. Offen
patternfly/patternfly-elements#3136 · 1 Kommentar · 1 zugewiesene Person ·
-
chore: update docs scaffolding for v6 elementsEvtl. wieder frei @zeroedin hat das vor 196 Tagen übernommen, und es ist kein Pull Request offen. Offendocs
patternfly/patternfly-elements#3131 · 1 zugewiesene Person ·
-
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 55/100
patternfly/patternfly-elements#3122 ·
Alle Issues in patternfly/patternfly-elements
Ähnliche Issues
-
[Site] Active section detection should respect scroll-margin-topEvtl. vergeben Ein verknüpfter Pull Request ist offen oder bereits gemergt. Offenarea/web reproduced type/bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 65/100
anomalyco/opencode#65384 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
swc-project/swc-ai-issues#1001 ·
-
check:passed streams:add
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 62/100
Maintainer antworten meist innerhalb von 1 Tag
-
fix(table): CollapseColumn uses wrong caret icon for expandable row toggleEvtl. vergeben @redhat-chai-bot hat das heute übernommen. Offen
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 85/100
patternfly/patternfly-react#12727 ·
Maintainer antworten meist innerhalb von 1 Tag
-
CLI OAuth login fails behind an authenticating proxy: GET /api/v1/user omits Proxy-AuthorizationOffen
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 85/100
lightdash/lightdash#33086 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag