Rgaa Mandatory Elements

RGAA Mandatory Elements Accessibility Audit (Theme 8)

Audits a web page against the 10 criteria of RGAA v4.1.2 Theme 8: Mandatory Elements.

Audit procedure

Step 1: Gather page metadata

(() => {
  const html = document.documentElement;
  const results = {
    doctype: document.doctype ? `` : null,
    htmlLang: html.getAttribute('lang'),
    htmlXmlLang: html.getAttribute('xml:lang'),
    htmlDir: html.getAttribute('dir'),
    title: document.title,
    charset: document.characterSet,
    metaCharset: document.querySelector('meta[charset]')?.getAttribute('charset'),

    // Language changes
    langChanges: [],

    // Tags used for presentation only
    presentationTags: {
      hasInlineStyles: document.querySelectorAll('[style]').length,
      bTags: document.querySelectorAll('b').length,
      iTags: document.querySelectorAll('i').length,
      sTags: document.querySelectorAll('s').length,
      uTags: document.querySelectorAll('u').length,
      fontTags: document.querySelectorAll('font').length,
      centerTags: document.querySelectorAll('center').length,
      bigTags: document.querySelectorAll('big').length,
      smallUsedForStyle: 0,
      brSequences: 0
    },

    // Direction changes
    dirChanges: []
  };

  // Language changes in content
  document.querySelectorAll('[lang], [xml\\:lang]').forEach(el => {
    if (el !== html) {
      results.langChanges.push({
        tag: el.tagName.toLowerCase(),
        lang: el.getAttribute('lang'),
        xmlLang: el.getAttribute('xml:lang'),
        text: el.textContent.trim().substring(0, 60)
      });
    }
  });

  // Check for consecutive  (presentational use)
  const walker = document.createTreeWalker(document.body, NodeFilter.SHOW_ELEMENT);
  let node;
  while (node = walker.nextNode()) {
    if (node.tagName === 'BR' && node.nextElementSibling?.tagName === 'BR') {
      results.presentationTags.brSequences++;
    }
  }

  // Direction changes
  document.querySelectorAll('[dir]').forEach(el => {
    if (el !== html) {
      results.dirChanges.push({
        tag: el.tagName.toLowerCase(),
        dir: el.getAttribute('dir'),
        text: el.textContent.trim().substring(0, 60)
      });
    }
  });

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

Step 2: Evaluate criteria

Criterion 8.1 – Page has a doctype. The page must start with `` (HTML5) or a valid DTD reference.

Criterion 8.2 – Generated source code is valid. Check for critical validity issues:

• No duplicate id attributes
• Tags are properly opened and closed
• Tags are properly nested
• Attributes are not duplicated on the same element

// Quick duplicate ID check
(() => {
  const ids = {};
  const duplicates = [];
  document.querySelectorAll('[id]').forEach(el => {
    const id = el.id;
    if (ids[id]) duplicates.push(id);
    ids[id] = (ids[id] || 0) + 1;
  });
  return JSON.stringify({ duplicateIds: duplicates, totalIds: Object.keys(ids).length });
})()

Criterion 8.3 – Default language is present. ` must have a lang attribute (and/or xml:lang` for XHTML).

Criterion 8.4 – Language code is valid and relevant. The lang value must be a valid ISO 639-1/639-2 code and match the actual language of the page content. Common codes: fr, en, de, es, it, pt, nl, ar, zh, ja.

Criterion 8.5 – Page has a title. `` element must exist and not be empty.

Criterion 8.6 – Page title is relevant. The title should identify the page content and ideally include the site name. It should be unique across the site. Check that it is not generic like "Home" or "Untitled".

Criterion 8.7 – Language changes are indicated in the code. Any passage of text in a different language than the page default must have a lang attribute on a surrounding element. This requires visual/content inspection.

Criterion 8.8 – Language change codes are valid. Each lang attribute on sub-elements must be a valid ISO language code.

Criterion 8.9 – Tags are not used for presentation only. HTML tags must be used according to their semantic meaning:

• No `-` used just for visual styling
• No `` used just for indentation
• No ` used just for layout without role="presentation"`
• No consecutive `` used for spacing
• No deprecated presentational elements (`, , `, etc.)

Criterion 8.10 – Reading direction changes are signaled. Content in right-to-left scripts (Arabic, Hebrew) must use dir="rtl". Content in left-to-right scripts within an RTL context must use dir="ltr".

Step 3: Generate report

For each criterion, report the status and any issues found. Language-related criteria (8.7, 8.8) and semantic misuse (8.9) may require content analysis beyond pure code inspection.

WCAG references: 9.1.3.1 (A), 9.2.4.2 (A), 9.3.1.1 (A), 9.3.1.2 (AA), 9.4.1.1 (A), 9.4.1.2 (A)

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.