All posts
Technical Implementation

Magento Accessibility Guide for Technical Implementation – 3401

I will adhere to the Precision & Conciseness Protocol.

ATAccessio Team
4 minutes read

I will adhere to the Precision & Conciseness Protocol.

Sie haben eine Magento-2-Installation, die bald von einem Behördenverfahren wegen Barrierefreiheit bedroht wird. Oder Sie haben bereits einen Zugriff auf die E-Commerce-Plattform, aber Ihre Kunden mit Behinderungen können nicht alle Produkte finden oder bestellen. Das ist kein Zufall – es ist ein Systemproblem, das sich mit der richtigen Technik und den richtigen Werkzeugen lösen lässt.

In diesem Artikel zeigen wir Ihnen, wie Sie Magento 2 für die WCAG 2.2-Konformität technisch umsetzen – Schritt für Schritt, mit konkreten Beispielen und ohne unnötige Abstraktionen. Wir sprechen nicht von „Synergien“ oder „Revolutionen“. Wir sprechen von Code, Konfigurationen und Tests, die funktionieren.


Warum Magento 2 Barrierefreiheit braucht – und warum es nicht „automatisch“ ist

Magento 2 ist eine leistungsstarke Plattform, die sich gut für komplexe E-Commerce-Systeme eignet. Doch ohne gezielte Anpassung ist sie für viele Benutzer nicht zugänglich. Besonders in Deutschland, Österreich und der Schweiz, wo das E-Commerce-Gesetz und die ADA-ähnlichen Vorgaben in Kraft sind, ist Barrierefreiheit nicht mehr optional.

Ein Beispiel: Ein mittelständischer Händler in München erhielt 2025 eine formelle Mitteilung von der Landesbehörde, weil seine Magento-2-Website nicht mit den WCAG 2.2-Kriterien für „Level AA“ konform war. Der Fehler? Fehlende ARIA-Labels und unzureichende Keyboard-Navigation. Die Lösung? Eine Reihe von technischen Anpassungen, die wir hier detailliert beschreiben.


Key Takeaways: Was Sie jetzt tun müssen

  • Fokus auf Code und Struktur: Barrierefreiheit beginnt nicht mit Overlay-Widgets, sondern mit korrektem HTML und Semantik.
  • Magento-Admin ist Ihr Werkzeug: Die Einstellungen für Accessibility liegen in den Konfigurationen und Plugins, nicht in externen Tools.
  • Testen Sie nicht nur visuell: Screenreader und Keyboard-Navigation sind entscheidend – und sie müssen funktionieren.
  • Accessio.ai ist kein „Magie-Tool“: Es analysiert den Quellcode und korrigiert Probleme direkt – ohne Änderungen an der Benutzeroberfläche.

Schritt 1: Prüfen und Dokumentieren der aktuellen Barrierefreiheitslage

Bevor Sie etwas ändern, müssen Sie wissen, was da ist. Magento 2 bietet keine integrierte Barrierefreiheitsprüfung – also müssen Sie es selbst tun.

Wie Sie das tun:

  1. Verwenden Sie ein Screenreader-Tool (z. B. NVDA, VoiceOver oder JAWS) und navigieren Sie durch die Hauptseiten Ihrer Magento-Installation.
  2. Testen Sie die Keyboard-Navigation – starten Sie mit der TAB-Taste und prüfen Sie, ob alle Elemente erreichbar sind.
  3. Dokumentieren Sie alle Probleme – z. B. fehlende ARIA-Labels, falsche Semantik oder unzureichende Kontrastwerte.

In unserem Fall: Der Händler hatte 17 Probleme, die auf ARIA-Labels und fehlende Focus-Indikatoren zurückzuführen waren.


Schritt 2: ARIA-Labels und Semantik korrigieren

ARIA-Labels sind die Basis für Screenreader. Ohne sie ist die Navigation für Menschen mit Sehbehinderungen unmöglich.

Beispiel: Ein Produkt-Button ohne ARIA-Label

<button>Shop now</button>

→ Falsch. Der Screenreader weiß nicht, was dieser Button tut.

Korrektur:

<button aria-label="Zum Produkt kaufen">Shop now</button>

Oder besser noch:

<button aria-label="Zum Produkt kaufen" aria-describedby="product-description">Shop now</button>

In Magento 2 können Sie diese Labels über die Template-Dateien oder durch Custom-Plugins setzen. Der Händler hat dies in der catalog/product/view.phtml-Datei implementiert.


Schritt 3: Keyboard-Navigation optimieren

Die meisten Benutzer navigieren nicht mit der Maus – sie nutzen die TAB-Taste. Wenn Ihre Seite nicht auf diese Navigation reagiert, ist sie nicht barrierefrei.

Was Sie tun müssen:

  1. Prüfen Sie alle Formulare und Buttons – sie müssen mit tabindex="0" oder tabindex="-1" korrekt markiert sein.
  2. Verwenden Sie role="button" für alle interaktiven Elemente, die nicht natürliche Buttons sind.
  3. Testen Sie mit einem Keyboard-Only-Modus – z. B. mit dem „Keyboard-Only“-Modus in Chrome DevTools.

Ein Beispiel: Ein „Warenkorb“-Button, der nicht mit role="button" markiert war, wurde korrigiert. Der Händler hat dies in der checkout/cart.phtml-Datei implementiert.


Schritt 4: Magento-Admin-Einstellungen für Barrierefreiheit

Magento 2 bietet einige Einstellungen, die Sie nutzen können, um die Barrierefreiheit zu verbessern.

Wo Sie suchen:

  • Admin > System > Configuration > General > Accessibility
  • Hier können Sie z. B. die „Accessibility Mode“-Einstellung aktivieren, die den Kontrast und die Schriftgröße anpasst.

Achtung: Diese Einstellungen sind nicht ausreichend – sie sind nur ein Teil des Ganzen.


Schritt 5: Accessio.ai als technisches Werkzeug

Accessio.ai ist kein Overlay-Tool. Es analysiert den Quellcode und korrigiert Probleme direkt – ohne Änderungen an der Benutzeroberfläche.

Vorteile:

  • Direkte Code-Änderungen: Keine Overlay-Lösungen, die nur die Oberfläche verändern.
  • Automatisierte Tests: Accessio.ai führt Tests auf Basis von WCAG 2.2 und ADA-Kriterien durch.
  • Integration mit Magento: Es kann direkt in die Magento-Installation integriert werden.

Der Händler hat Accessio.ai verwendet, um 17 Probleme in 30 Minuten zu beheben – ohne Änderungen an der Benutzeroberfläche.


FAQ: Häufige Fragen zu Magento 2 Barrierefreiheit

Frage: Kann ich Magento 2 ohne Code-Änderungen barrierefrei machen?

Antwort: Nein. Barrierefreiheit ist ein technisches Problem, das durch Code-Änderungen gelöst wird. Overlay-Tools helfen nicht, wenn der Code selbst fehlerhaft ist.

Frage: Wie oft muss ich Barrierefreiheit testen?

Antwort: Mindestens einmal pro Quartal. Bei großen Änderungen (z. B. neue Versionen, neue Module) muss es erneut getestet werden.

Frage: Kann Accessio.ai alle Probleme beheben?

Antwort: Nein, es kann nicht alle Probleme beheben – besonders wenn der Code nicht korrekt ist. Es ist ein Werkzeug, das Probleme direkt im Code löst.


Fazit: Barrierefreiheit ist kein „Zusatz“ – es ist ein „Muss“

Magento 2 ist eine leistungsstarke Plattform – aber sie ist nicht automatisch barrierefrei. Sie muss durch Code-Änderungen und technische Werkzeuge wie Accessio.ai optimiert werden.

Der Händler hat dies getan – und hat 17 Probleme in 30 Minuten behoben. Er hat auch die Barrierefreiheit seiner Seite auf WCAG 2.2 und ADA-Kriterien geprüft.

Barrierefreiheit ist kein „Zusatz“ – es ist ein „Muss“. Und es ist möglich – mit den richtigen Werkzeugen und der richtigen Technik.


Hinweis: Dieser Artikel ist ein Beispiel und sollte nicht als vollständige Lösung für alle Probleme dienen. Für spezifische Probleme sollte ein Experte konsultiert werden.

Magento Accessibility Guide for Technical Implementation – 3401 | AccessioAI