Headings and structure
This page is for editors who write pages and designers who build page templates. Screen reader users move through a page by its headings; a sensible heading outline is the single most useful thing an editor can give them. WCAG 2.2 covers this under 1.3.1 Info and relationships and 2.4.6 Headings and labels (https://www.w3.org/TR/WCAG22/).
Contents
How headings come out of Exponential
- The object's name or title field is usually printed by the full view template as the page's
h1. - Rich text is stored as XML. A heading in rich text has a level; in the standard design the template
design/standard/templates/content/datatype/view/ezxmltags/header.tplturns level 1 intoh2, level 2 intoh3, and so on, because the page already has itsh1. - Each rich text heading also gets an anchor (
eztoc...), which a table of contents can link to.
Check what your own design does: a design may override header.tpl.
Rules for editors
- Use the editor's heading formats for headings, never bold or a larger font.
- Start with the first heading level and do not skip levels going down (a level 3 heading belongs under a level 2).
- Make headings descriptive: "Opening hours" rather than "Information".
- Use the editor's list buttons for lists, not dashes typed by hand.
- Keep one topic per section; long pages with clear headings are easier to use than many short pages.
Rules for designers
- One
h1per page (the page name); landmarks (header,nav,main,footer); headings in block templates that fit under the page's outline (Accessibility for site builders). - Do not use heading elements for visual effects in blocks (a teaser title in a list can be an
h2orh3according to the outline, not by its look). - Landing pages built with the layouts editor: check that the block templates produce a logical outline (Landing pages with layouts).
Page titles
WCAG 2.4.2 asks for descriptive page titles. The <title> is built by your pagelayout from the content's name and
the site name (The pagelayout). Editors control the first part:
give every object a clear, unique name. The administration's own titles are built by page_head.tpl.
Related pages
- Accessible content for editors
- Editing content
- The pagelayout
- Free documentation: this page is free to copy, translate and improve under the GNU FDL 1.3.
Become an Exponential Partner
Partners share their information, provide funding, contribute back and develop the products with us, and that is how Exponential grows. A partner website and dashboard are planned for mid-2027: please become a partner today to speed up our growth rate and land new features faster.