Skip to content

Summary accessibility #1529

@Ovgodd

Description

@Ovgodd

Bug Report

Problematic behavior
The Table of Contents (Summary) lacked accessibility and semantic structure:

  • Screen readers did not correctly announce it
  • Focus ring was too large and inconsistent
  • Poor keyboard navigation

Expected behavior/code

  • TOC should use semantic HTML (nav, ul, li)
  • ARIA attributes should be applied (aria-label, aria-selected, etc.)
  • Focus styling
  • Keyboard navigation with Tab and Enter should behave like mouse click

Steps to Reproduce

  1. Open a document with a summary section
  2. Try navigating with Tab or a screen reader
  3. Notice inconsistent focus, lack of semantic announcements, and weak accessibility

Possible Solution

  • Add semantic elements
  • Use ARIA
  • Use consistent focus behavior

Metadata

Metadata

Assignees

Type

No type

Projects

Status

No status

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions