Modal Dialog Example: Change dialog title heading elements from H2 to H1

[daniel-montalvo]

Fixes #3395

See Preview of modal dialog example where these headings are no longer included in the ToC.

---

WAI Preview Link (Last built on Wed, 04 Feb 2026 19:23:58 GMT).

[a11ydoer]

The visual review is done during the meeting.

[shirsha]

Reviewed all dialogs that have H1. This is not motivated by an accessibility concern. Rather, the generation logic is picking up H2 elements and inserting them into its table of contents. Initially inclined to use H3 elements because those dialogs exist within specific sections, but we will discuss this new issue

[a11ydoer]

done

[css-meeting-bot]

The ARIA Authoring Practices (APG) Task Force just discussed PR 3412: Change dialog title heading elements from H2 to H1.

The full IRC log of that discussion

<jugglinmike> Topic: PR 3412: Change dialog title heading elements from H2 to H1
<jugglinmike> github: https://github.com//pull/3412
<jugglinmike> Matt_King: I took a quick look at this but didn't submit a review
<jugglinmike> Matt_King: I think we need someone to review this visually to determine whether or not we need to also make CSS changes
<jugglinmike> Jem_: I can do that
<jugglinmike> Matt_King: This impacts the headings inside the dialogs
<jugglinmike> Matt_King: e.g. the dialog for "Add Delivery Address"
<jugglinmike> Siri: Also "Verification Result"
<jugglinmike> Matt_King: And one with a heading that reads "End of the Road"
<jugglinmike> Jem_: I checked with the tag inspector and it is indeed H1
<jugglinmike> Matt_King: If I were to merge this today, do we want to add it to the release we've already prepared?
<jugglinmike> Daniel: I'm fine with that
<jugglinmike> Matt_King: I'll take another look at the actual diff before I merge it, but I'll plan to merge it
<CurtBellew> +1
<jugglinmike> Matt_King: Remember that this is not motivated by an accessibility concern. Rather, the generation logic is picking up H2 elements and inserting them into its table of contents.
<jugglinmike> Siri: Can we add a note to explain why we have made this change?
<Daniel> q+
<jugglinmike> Siri: We usually don't use H1 elements like this
<jugglinmike> Matt_King: That sounds like a new issue: an issue discussing whether or not we recommend using H1 elements within the dialog pattern
<jugglinmike> Daniel: My initial impulse was to use H3 elements because those dialogs exist within specific sections
<jugglinmike> Daniel: We eventually stepped away from that justification, but I do agree that this would be good to discuss in a new issue