Skip to content

Content Lacks Proper Heading Markup #227528

Open

Description

Does this issue occur when all extensions are disabled?: Yes/No

  • VS Code Version: 1.92.2
  • OS Version: 14.6.1 (23G93)

Description:
Certain content, such as "Extensions," "HTML" visually functions as headings but does not use proper heading markup, making navigation difficult for screen reader users.

Steps to Reproduce:

  • Navigate to content like "Extensions" in VSCode.
  • Use a screen reader to navigate and notice the lack of heading structure.

User Impact: Screen reader users will have difficulty efficiently navigating and gaining an accurate overview of the page due to missing heading markup.

Expected Behavior: Text that visually functions as a heading should use appropriate heading elements (<h1>, <h2>, etc.), with levels that reflect the visual hierarchy. For example:

"Extensions" should be <h2>,
"HTML" should be <h3>,
"HTML: Auto Closing Tags" should be <h4>.

Actual Behavior: Text visually appears as a heading but lacks the proper HTML heading tags, reducing accessibility.

Recommendation: Ensure that text functioning as headings uses appropriate heading tags (<h1>, <h2>, etc.) to improve navigation for screen reader users.

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

Metadata

Assignees

Labels

accessibilityKeyboard, mouse, ARIA, vision, screen readers (non-specific) issuesbugIssue identified by VS Code Team member as probable bugsettings-editorVS Code settings editor issues

Type

No type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions