feat: ion-accordion - allow a heading element around the header item (WAI-ARIA accordion pattern)
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 4/5
- Tempo stimato
- 3-5 giorni
- Idoneità per principianti
- 48/100
- Tipo di issue
- Funzionalità
- Chiarezza
- Abbastanza chiara
- Stato di attività
- Attiva
- Stack tecnologico
- angular, html, typescript
- Ambito
- accessibility, frontend
Direzione di ricerca
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.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
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
- Lingua principale
- TypeScript
- Stelle
- 52.8k
- Fork
- 13.3k
- Merge medio
- 3g 1h
- PR unite (30g)
- 86
Preparare l'ambiente
- Nessun Dockerfile né file Docker Compose
- Ha un modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di ionic-team/ionic-framework
-
bug: input-otp, backspace in an empty box only moves focus instead of clearing the previous boxForse già presa @sarankumar1325 l’ha presa 23 giorni fa. Apertapackage: core type: bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 90/100
ionic-team/ionic-framework#31639 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
-
bug: vue swipe cancellation throws when the previous page is missingForse già presa @dandoingdev l’ha presa 46 giorni fa. Apertapackage: vue type: bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
ionic-team/ionic-framework#31514 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
-
bug: ion-searchbar input is always labelled "search text"; aria-label on the host is not forwardedForse già presa @HappyKnuckles l’ha presa 41 giorni fa. Apertaa11y package: core type: bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 84/100
ionic-team/ionic-framework#31492 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
-
bug: IonTabs throws when a Fragment contains one IonRouterOutletForse già presa @Benziza l’ha presa 82 giorni fa. Apertapackage: react type: bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
ionic-team/ionic-framework#31410 · 2 commenti ·
I maintainer di solito rispondono entro 1 giorno
-
bug: angular swipe-back gesture crashes in StackController.startBackTransition when the stack is popped before the gesture is capturedForse già presa @officialasishkumar l’ha presa 9 giorni fa. Apertapackage: angular type: bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 86/100
ionic-team/ionic-framework#31291 · 1 commento ·
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di ionic-team/ionic-framework
Issue simili
-
ready-for-ai
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 88/100
umbraco/Umbraco-CMS-MCP-Dev#647 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 66/100
HelloAOLab/seed-bible#2173 ·
I maintainer di solito rispondono entro 1 giorno
-
enhancement good first issue help wanted
Difficoltà 2/5 1-3 ore Idoneità per principianti 88/100
hocinehacherouf/liberarr#77 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
LibreChat-AI/LibreChat#18225 ·
I maintainer di solito rispondono entro 1 giorno
-
b-ber/build/epub b-ber/themes
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
triplecanopy/b-ber#790 ·
I maintainer di solito rispondono entro 1 giorno