Content lacks semantic markup #15290
Labels
[Feature] Document Outline
An option that outlines content based on a title and headings used in the post/page
[Focus] Accessibility (a11y)
Changes that impact accessibility and need corresponding review (e.g. markup changes).
Content lacks semantic markup
Issue description
The Content Structure panel includes a summary of the content by type,
and some text that's styled and positioned like a heading ("Document
Outline"), however this content does not use appropriate semantic
markup.
Semantic markup is vital for assistive technology users, to convey the
structure and relationships between information. When appropriate
semantic markup is not used, it may be more difficult for such users to
understand what the content means, and to comprehend the structure that
the visual presentation conveys.
Issue Code
Remediation Guidance
Use a structure such as
<ul>
or<dl>
to semanticallyassociate the content type information.
Elements which are styled and positioned like headings should be
marked-up as headings. The Recommended Code uses an
<h2>
on theassumption that the open panel should be treated as standalone context
within the page (i.e. at a level beneath the page's
<h1>
).Recommended Code
Relevant standards
(Level A)
AA)
(Level A)
Note: This issue may be a duplicate with other existing accessibility-related bugs in this project. This issue comes from the Gutenberg accessibility audit, performed by Tenon and funded by WP Campus. This issue is GUT-25 in Tenon's report
The text was updated successfully, but these errors were encountered: