Rgaa Information Structure

RGAA Information Structure Accessibility Audit (Theme 9)

Audits a web page against the 4 criteria of RGAA v4.1.2 Theme 9: Information Structure.

Audit procedure

Step 1: Gather structural data

(() => {
  const structure = {};

  // Headings hierarchy
  structure.headings = [];
  document.querySelectorAll('h1,h2,h3,h4,h5,h6,[role="heading"]').forEach(el => {
    const level = el.tagName?.match(/H(\d)/)?.[1] || el.getAttribute('aria-level');
    structure.headings.push({
      level: parseInt(level),
      text: el.textContent.trim().substring(0, 80),
      tag: el.tagName.toLowerCase(),
      ariaLevel: el.getAttribute('aria-level'),
      isHidden: getComputedStyle(el).display === 'none' || getComputedStyle(el).visibility === 'hidden',
      ariaHidden: el.getAttribute('aria-hidden')
    });
  });

  // Landmark regions
  structure.landmarks = [];
  const landmarkSelectors = {
    'banner': 'header, [role="banner"]',
    'navigation': 'nav, [role="navigation"]',
    'main': 'main, [role="main"]',
    'contentinfo': 'footer, [role="contentinfo"]',
    'complementary': 'aside, [role="complementary"]',
    'search': '[role="search"], search',
    'form': '[role="form"]',
    'region': '[role="region"]'
  };

  Object.entries(landmarkSelectors).forEach(([type, selector]) => {
    document.querySelectorAll(selector).forEach(el => {
      structure.landmarks.push({
        type: type,
        tag: el.tagName.toLowerCase(),
        role: el.getAttribute('role'),
        ariaLabel: el.getAttribute('aria-label'),
        ariaLabelledby: el.getAttribute('aria-labelledby'),
        text: el.textContent.trim().substring(0, 40)
      });
    });
  });

  // Lists
  structure.lists = {
    ul: document.querySelectorAll('ul').length,
    ol: document.querySelectorAll('ol').length,
    dl: document.querySelectorAll('dl').length,
    liOutsideList: document.querySelectorAll('li:not(ul > li):not(ol > li):not(menu > li)').length,
    dtOutsideDl: document.querySelectorAll('dt:not(dl > dt)').length,
    ddOutsideDl: document.querySelectorAll('dd:not(dl > dd)').length,
    roleList: document.querySelectorAll('[role="list"]').length,
    roleListitem: document.querySelectorAll('[role="listitem"]').length
  };

  // Quotations
  structure.quotations = {
    blockquote: document.querySelectorAll('blockquote').length,
    q: document.querySelectorAll('q').length,
    cite: document.querySelectorAll('cite').length
  };

  return JSON.stringify(structure, null, 2);
})()

Step 2: Evaluate criteria

Criterion 9.1 – Information is structured by appropriate use of headings.

Check heading hierarchy:

• There should be at least one `` on the page
• Heading levels should not skip (e.g., h1 → h3 without h2)
• Headings should reflect the actual content organization
• Content sections should start with a heading
• Headings should not be empty

Criterion 9.2 – Document structure is coherent.

Check landmarks/sectioning:

• The page has a ` or [role="banner"]`
• The page has a ` or [role="navigation"]` (at least one)
• The page has a ` or [role="main"]` (exactly one)
• The page has a ` or [role="contentinfo"]`
• Multiple landmarks of the same type have distinguishing aria-label values
• The `` is not nested inside another landmark (except the document itself)
• Content outside landmarks should be minimal

Criterion 9.3 – Lists are correctly structured.

• Unordered lists use ` > `
• Ordered lists use ` > `
• Definition lists use ` > + `
• No ` outside of , , or `
• No ` or outside of `
• [role="list"] contains [role="listitem"] children
• Visual lists (items separated by line breaks or commas) that represent a list of items should use proper list markup

Criterion 9.4 – Quotations are correctly marked up.

• Block quotations use ``
• Inline quotations use ``
• ` and ` are not used for non-quotation purposes (like indentation)
• The cite attribute references the source when applicable

Step 3: Generate report

Present the heading tree visually (indented by level), list all landmarks, and flag any structural issues.

WCAG references: 9.1.3.1 (A), 9.2.4.1 (A), 9.2.4.6 (AA), 9.2.4.10 (AAA)

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: MTeelokee
• Source: MTeelokee/rgaa-accessibility-audit
• License: MIT

Install and usage instructions live in the source repository linked above.