feat: ion-accordion - allow a heading element around the header item (WAI-ARIA accordion pattern)

Đang mở
#31,621 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
4/5
Thời gian dự kiến
3-5 ngày
Mức phù hợp với người mới
48/100
Loại issue
Tính năng
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
angular, html, typescript
Lĩnh vực
accessibility, frontend

Hướng nghiên cứu

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.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

type: feature request
Prerequisites
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> - the h3 is slotted, but the ion-item
    inside is not turned into the toggle: no button (inner element stays a div), no
    ion-focusable class, no tabindex, 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-item overrides the host role
    (inList ? 'listitem' : null); aria-level stays, role is 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).

Additional Information

No response

Ngôn ngữ chính
TypeScript
Star
52.8k
Fork
13.3k
Merge trung bình
3 ngày 1 giờ
Pull request đã merge (30 ngày)
86

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của ionic-team/ionic-framework

Tất cả issue của ionic-team/ionic-framework

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.