Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Ensure Visual Titles Use Correct Semantic HTML or Roles #560

Open
jeromehardaway opened this issue Mar 17, 2024 · 1 comment
Open

Ensure Visual Titles Use Correct Semantic HTML or Roles #560

jeromehardaway opened this issue Mar 17, 2024 · 1 comment

Comments

@jeromehardaway
Copy link
Contributor

Description:
We've identified an issue where elements in our application that visually present themselves as titles are not semantically marked up as headings. To adhere to best practices for accessibility and semantic HTML, these elements need to be properly coded. Specifically, elements that look like titles should either be marked up with heading tags (h1 to h6) or, if using non-heading tags (such as div, span, p, etc.), should include a "role" attribute set to "heading". This change is crucial for screen reader users to understand the page structure correctly and navigate our content more effectively.

Action Required:

  • Audit the application to identify all elements that visually appear as titles but are coded with non-heading HTML tags.
  • For each identified element, do one of the following:
    • Change the tag to an appropriate heading tag (h1-h6), ensuring it fits the page's hierarchical structure.
    • If changing the tag is not feasible, add a "role" attribute with the value "heading" to the element and, if necessary, include the "aria-level" attribute to indicate the heading level it represents.
  • Ensure that the modifications do not adversely affect the visual presentation or layout.

Additional Information:
To assist with this task, we are offering a free PDF report that details all the elements requiring attention, along with full instructions on how to correct these issues. This report is available upon request and will be sent directly to your email.

Neutral Score Explanation:
This ticket is created as a proactive measure to enhance our application's accessibility and semantic structure. The requirement for correct semantic tagging or roles may not have been previously enforced, which might have resulted in these elements being overlooked. Therefore, this task may not be applicable to all elements previously considered as titles but aims to standardize our approach to ensure accessibility and compliance moving forward.

Please prioritize this task as it is fundamental to our commitment to providing an accessible digital environment for all users.

@IngridFuentes
Copy link
Contributor

Hi @jeromehardaway , can you send me the pdf? Thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: In Progress
Development

No branches or pull requests

2 participants