Don't show heading ancestors in the document outline #15034
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).
[Package] Editor
/packages/editor
[Status] In Progress
Tracking issues with work in progress
See #5314 (comment) and #14889 (comment)
When headings are nested within other blocks, the document outline displays the headings ancestors. Example screenshots:
To some extent, I understand the argumentation behind #14889, quoting:
However, I'm not sure displaying the ancestors adds a real value for users. Instead, it makes the UI pretty confusing. Also, the more nested blocks, the more the document outline UI will be confusing.
One more concern is the way the document outline is announced by screen readers: hearing, for example, "Section Column Column H2 My Heading" doesn't help so much.
As a user, I'd expect a tool called "Document Outline" would display just the... outline: headings. Worth also noting there are no known implementations of the HTML5 outline algorithm: as mentioned in #5314 (comment) the current W3C recommendation is: "use heading rank (h1-h6) to convey document structure."
The text was updated successfully, but these errors were encountered: