Skip to content

h5 element accessibility issue #26

Description

@skyme5

While doing an accessibility test with admonitions, following warning appears on lighthouse

Heading elements are not in a sequentially-descending order

Properly ordered headings that do not skip levels convey the semantic structure of the page, making it easier to navigate and understand when using assistive technologies. Learn more

because of this

<div class="admonition admonition-tip alert alert--success">
  <div class="admonition-heading">
    <h5><span class="admonition-icon"></span>tip</h5> <!-- This has incorrect order -->

According to W3C standard for heading level

documents should not skip levels (for example, from H1 to H3), as converting such documents to other representations is often problematic.

Consider changing h5 to h1 and use css for styling.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions