SamuelChien/mega-skills-collection

Barrierefreiheit & WCAG

Semantisches HTML

<!-- Verwenden Sie semantische Elemente anstelle von generischen Divs -->
<header>
  <nav aria-label="Hauptnavigation">
    <ul>
      <li><a href="/" aria-current="page">Startseite</a></li>
      <li><a href="/produkte">Produkte</a></li>
      <li><a href="/ueber-uns">Über uns</a></li>
    </ul>
  </nav>
</header>

<main>
  <article>
    <h1>Produktdetails</h1>
    <section aria-labelledby="spezifikationen-ueberschrift">
      <h2 id="spezifikationen-ueberschrift">Spezifikationen</h2>
      <dl>
        <dt>Gewicht</dt>
        <dd>1,2 kg</dd>
        <dt>Abmessungen</dt>
        <dd>30 x 20 x 10 cm</dd>
      </dl>
    </section>
  </article>
</main>

<footer>
  <p>&copy; 2024 Firmenname</p>
</footer>

Verwenden Sie <nav>, <main>, <article>, <section>, <aside> anstelle von <div> für Orientierungspunkte. Screenreader nutzen diese, um auf der Seite zu navigieren.

ARIA-Muster

function Modal({ isOpen, onClose, title, children }) {
  if (!isOpen) return null;

  return (
    <div
      role="dialog"
      aria-modal="true"
      aria-labelledby="modal-title"
      onKeyDown={(e) => e.key === "Escape" && onClose()}
    >
      <h2 id="modal-title">{title}</h2>
      <div>{children}</div>
      <button onClick={onClose} aria-label="Dialog schließen">
        <XIcon aria-hidden="true" />
      </button>
    </div>
  );
}

function Tabs({ tabs, activeIndex, onChange }) {
  return (
    <div>
      <div role="tablist" aria-label="Einstellungsbereiche">
        {tabs.map((tab, i) => (
          <button
            key={tab.id}
            role="tab"
            id={`tab-${tab.id}`}
            aria-selected={i === activeIndex}
            aria-controls={`panel-${tab.id}`}
            tabIndex={i === activeIndex ? 0 : -1}
            onClick={() => onChange(i)}
            onKeyDown={(e) => handleArrowKeys(e, i, tabs.length, onChange)}
          >
            {tab.label}
          </button>
        ))}
      </div>
      {tabs.map((tab, i) => (
        <div
          key={tab.id}
          role="tabpanel"
          id={`panel-${tab.id}`}
          aria-labelledby={`tab-${tab.id}`}
          hidden={i !== activeIndex}
          tabIndex={0}
        >
          {tab.content}
        </div>
      ))}
    </div>
  );
}

Tastaturnavigation

function handleArrowKeys(
  event: React.KeyboardEvent,
  currentIndex: number,
  totalItems: number,
  onSelect: (index: number) => void
) {
  let newIndex = currentIndex;

  switch (event.key) {
    case "ArrowRight":
    case "ArrowDown":
      newIndex = (currentIndex + 1) % totalItems;
      break;
    case "ArrowLeft":
    case "ArrowUp":
      newIndex = (currentIndex - 1 + totalItems) % totalItems;
      break;
    case "Home":
      newIndex = 0;
      break;
    case "End":
      newIndex = totalItems - 1;
      break;
    default:
      return;
  }

  event.preventDefault();
  onSelect(newIndex);
}

Alle interaktiven Elemente müssen per Tastatur erreichbar sein. Tab für die Fokusnavigation, Enter/Leertaste zur Aktivierung, Pfeiltasten für die Navigation innerhalb von Komponenten.

Formularzugänglichkeit

function SignupForm() {
  return (
    <form aria-labelledby="form-title" noValidate>
      <h2 id="form-title">Konto erstellen</h2>

      <div>
        <label htmlFor="email">E-Mail-Adresse</label>
        <input
          id="email"
          type="email"
          required
          aria-required="true"
          aria-describedby="email-hinweis email-fehler"
          aria-invalid={hasError ? "true" : undefined}
        />
        <p id="email-hinweis">Wir geben Ihre E-Mail niemals weiter.</p>
        {hasError && (
          <p id="email-fehler" role="alert">
            Bitte geben Sie eine gültige E-Mail-Adresse ein.
          </p>
        )}
      </div>

      <button type="submit">Konto erstellen</button>
    </form>
  );
}

Farbe und Kontrast

:root {
  --text-primary: #1a1a1a;      /* 15,3:1 auf weiß */
  --text-secondary: #595959;    /* 7,0:1 auf weiß */
  --text-on-primary: #ffffff;   /* Stellen Sie 4,5:1 auf Markenfarbe sicher */
  --border-focus: #0066cc;      /* Sichtbarer Fokusring */
}

*:focus-visible {
  outline: 3px solid var(--border-focus);
  outline-offset: 2px;
}

.error-message {
  color: #d32f2f;
  /* Verlassen Sie sich nicht nur auf Farbe – fügen Sie ein Symbol oder Text-Präfix hinzu */
}
.error-message::before {
  content: "Fehler: ";
  font-weight: bold;
}

WCAG AA erfordert 4,5:1 Kontrast für normalen Text, 3:1 für großen Text (18px fett oder 24px normal).

Anti-Muster

• Verwendung von div und span für klickbare Elemente anstelle von button oder a
• Entfernen von Fokusumrandungen ohne alternative Anzeige
• Sich allein auf Farbe verlassen, um Informationen zu vermitteln (rot für Fehler, grün für Erfolg)
• Verwendung von aria-label, wenn sichtbarer Text das Element bereits beschriftet
• Automatisch abspielende Medien ohne Pausenmechanismus
• Fehlender Skip-Navigationslink für Tastaturbenutzer

Checkliste

• Alle interaktiven Elemente sind per Tastatur erreichbar (Tab, Enter, Escape, Pfeiltasten)
• Semantische HTML-Orientierungspunkte verwendet (nav, main, article, section)
• Bilder haben beschreibenden alt-Text (oder alt="" für dekorative)
• Farbkontrast erfüllt WCAG AA (4,5:1 normaler Text, 3:1 großer Text)
• Fokusindikatoren sind auf allen interaktiven Elementen sichtbar
• Formulareingaben haben zugehörige <label>-Elemente
• Fehlermeldungen werden über role="alert"" an Screenreader weitergegeben
• Seite mit Screenreader (VoiceOver, NVDA) und nur mit Tastatur getestet