Skip to content

[BUG] Pages lack complete landmark structure #1052

Description

@adambuttrick

Component
Sitewide page layout and the ID Details page

Describe the issue
Page content is not consistently contained within semantic landmarks. The sitewide layout does not expose one clear main landmark, some content falls outside landmarks, and sections on the ID Details page lack appropriate containers.

Affected findings

  • Audit row 5: Each document should have one main landmark.
  • Audit row 7: All sitewide page content should be contained by landmarks.
  • Audit row 120: Content sections with headings on the ID Details page should be grouped within landmarks.

To Reproduce

  1. Open representative public, authenticated, and ID Details pages.
  2. Inspect the landmark list with a screen reader or accessibility testing tool.
  3. Observe missing main landmarks or content outside landmark regions.

Expected behavior
Each page has one main landmark. Page content is organized within appropriate semantic regions, and assistive technology users can understand the page structure without encountering orphaned content.

WCAG Standard

  • WCAG SC 1.3.1 Info and Relationships, Level A

Recommended Fix
Wrap the primary page content in a single <main> element in the shared layout. Place remaining content in appropriate semantic regions. Group ID Details sections with meaningful semantic containers and accessible names where needed.

Acceptance Criteria

  • Every tested page exposes exactly one main landmark.
  • Automated checks for landmark-one-main and region pass.
  • ID Details sections have a clear semantic structure in screen reader landmark navigation.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions