feat: ion-accordion - allow a heading element around the header item (WAI-ARIA accordion pattern)
Maintainer antworten meist innerhalb von 1 Tag
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 4/5
- Geschätzter Aufwand
- 3-5 Tage
- Anfängerfreundlichkeit
- 48/100
- Issue-Typ
- Feature
- Klarheit
- Größtenteils klar
- Aktivitätsstatus
- Aktiv
- Tech-Stack
- angular, html, typescript
- Bereich
- accessibility, frontend
Rechercherichtung
Start by reading the ion-accordion header slot handling and ion-item role behavior; the issue provides a reproduction in src/app/repros/accordion.page.ts and identifies Ionic 8.8.5. Check how the header item becomes the keyboard toggle and how heading semantics could wrap that button. Done means the accessibility tree exposes a heading at the requested level containing an operable accordion toggle.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
Prerequisites
- I have read the Contributing Guidelines.
- I agree to follow the Code of Conduct.
- I have searched for existing issues that already include this feature request, without success.
Describe the Feature Request
Allow the header of an ion-accordion to be exposed as a heading that contains the toggle
button, as in the WAI-ARIA accordion pattern: <h3><button aria-expanded>...</button></h3>.
Today there is no way to get this structure: the header ion-item only becomes the focusable
toggle when it is the direct child in the header slot, and it overrides any role set on it.
Describe the Use Case
Screen reader users navigate long pages by headings (VoiceOver rotor "Headings", TalkBack
heading navigation, NVDA/JAWS H key). In our app each Beleg (receipt) of an application is an
accordion; its title should be a level-3 heading so users can jump between them. An accessibility
audit (BITV/WCAG 1.3.1 Info and Relationships) flagged the missing headings.
What we tried (Ionic 8.8.5):
<h3 slot="header"><ion-item>...</ion-item></h3>- theh3is slotted, but theion-item
inside is not turned into the toggle: nobutton(inner element stays adiv), no
ion-focusableclass, notabindex, so it cannot be reached or activated with the keyboard.
A mouse click still toggles.<ion-item slot="header" role="heading" aria-level="3">-ion-itemoverrides the hostrole
(inList ? 'listitem' : null);aria-levelstays,roleis gone.- A heading inside the item's label works, but inverts the pattern (button contains heading):
VoiceOver's heading rotor does not reach it.
Describe Preferred Solution
A property on the accordion (e.g. headingLevel="3", or aria-level on the header item) that renders/exposes a heading wrapping the toggle button, so the accessibility tree becomes heading (level 3) > button (expanded/collapsed).
Describe Alternatives
Accept a heading element (h1-h6 or role="heading") in the header slot as a wrapper and still make the ion-item inside it the focusable toggle button.
Related Code
Reproduction (Angular, Ionic 8.8.5), page /repro/accordion "3 ion-accordion heading":
tab through the page (variant A gets no tab stop), then press "Inspect roles" (A focusable=false inner=<div>, B role=null aria-level=3).
- StackBlitz: https://stackblitz.com/github/mrambow/starterApp/tree/a11y-repros
- GitHub: https://github.com/mrambow/starterApp/blob/a11y-repros/src/app/repros/accordion.page.ts
Additional Information
No response
- Vorherrschende Sprache
- TypeScript
- Sterne
- 52.8k
- Forks
- 13.3k
- Ø Merge
- 3 T. 1 Std.
- Gemergte PRs (30 T.)
- 86
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 ionic-team/ionic-framework
-
bug: input-otp, backspace in an empty box only moves focus instead of clearing the previous boxEvtl. vergeben @sarankumar1325 hat das vor 23 Tagen übernommen. Offenpackage: core type: bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 90/100
ionic-team/ionic-framework#31639 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
bug: vue swipe cancellation throws when the previous page is missingEvtl. vergeben @dandoingdev hat das vor 46 Tagen übernommen. Offenpackage: vue type: bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 78/100
ionic-team/ionic-framework#31514 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
bug: ion-searchbar input is always labelled "search text"; aria-label on the host is not forwardedEvtl. vergeben @HappyKnuckles hat das vor 41 Tagen übernommen. Offena11y package: core type: bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 84/100
ionic-team/ionic-framework#31492 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
bug: IonTabs throws when a Fragment contains one IonRouterOutletEvtl. vergeben @Benziza hat das vor 82 Tagen übernommen. Offenpackage: react type: bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
ionic-team/ionic-framework#31410 · 2 Kommentare ·
Maintainer antworten meist innerhalb von 1 Tag
-
bug: angular swipe-back gesture crashes in StackController.startBackTransition when the stack is popped before the gesture is capturedEvtl. vergeben @officialasishkumar hat das vor 9 Tagen übernommen. Offenpackage: angular type: bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 86/100
ionic-team/ionic-framework#31291 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
Alle Issues in ionic-team/ionic-framework
Ähnliche Issues
-
ready-for-ai
Schwierigkeit 1/5 Unter einer Stunde Anfängerfreundlichkeit 88/100
umbraco/Umbraco-CMS-MCP-Dev#647 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 66/100
HelloAOLab/seed-bible#2173 ·
Maintainer antworten meist innerhalb von 1 Tag
-
enhancement good first issue help wanted
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 88/100
hocinehacherouf/liberarr#77 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 70/100
LibreChat-AI/LibreChat#18225 ·
Maintainer antworten meist innerhalb von 1 Tag
-
b-ber/build/epub b-ber/themes
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
triplecanopy/b-ber#790 ·
Maintainer antworten meist innerhalb von 1 Tag