Skip to content

Content Lacks Proper Heading Markup #227528

Open
@Bluefish0558

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

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