NCA Social Media
Erstellt:
Aktualisiert:
Autor:
Roland Golla
ANDI: Röntgenbrille zeigt den versteckten Namen eines Buttons

Was ist ANDI (Accessible Name & Description Inspector)?

ANDI, kurz für Accessible Name & Description Inspector, ist ein kostenloses Bookmarklet, mit dem du Webseiten von Hand auf Barrierefreiheit prüfst. Es zeigt für jedes Element, welchen Namen und welche Beschreibung ein Screenreader vorlesen sollte.

Entwickelt hat ANDI das Accessible Solutions Branch der Social Security Administration, der US Sozialversicherungsbehörde. Das Werkzeug ist Open Source. Du legst es als Lesezeichen im Browser ab, klickst es auf der Seite an, die du testen willst, und ANDI blendet sich über der Seite ein.

ANDI läuft in Chrome, Edge, Firefox und Safari. Es aktualisiert sich selbst, du musst es also nur einmal einrichten.

Inhalt
NCA Cypress Workshop mit Cypress Ambassador Roland Golla

E2E Tests, die euer Team selbst schreibt

Ein Tag inhouse mit Roland Golla, offizieller Cypress Ambassador und seit über 20 Jahren in Testing und Refactoring zu Hause. Auf unserem YouTube Kanal zeigt er in über 70 Live Coding Tutorials, wie Cypress in echten Projekten läuft. Dazu kommt unser Open Source Plugin NCA TESTIFY: Basistests für jede Website, mit einer Zeile im CI/CD Setup. Im Workshop lernt euer Team Setup, stabile Selektoren, Custom Commands und Tests in der Pipeline.

  1. 1
    Kostenloses Vorgespräch
    Projekt, Stack und Teststand klären
  2. 2
    Workshoptag bei euch
    Setup, Patterns und erste Tests im Team
  3. 3
    Praxistag optional
    Tests im eigenen Projekt und in CI
Roland Golla
Roland Golla
Fullstack Developer
Zum Cypress Workshop arrow_forward

Vom ANDI Befund zum sauberen Code im Frontend

ANDI zeigt dir eine Lücke. Schließen musst du sie im Code. Genau dort arbeiten wir täglich: Wir bauen Frontends mit Astro, React und Vue und sichern sie mit Cypress Tests ab. Wenn ANDI einen Button ohne Namen meldet, wissen wir, in welcher Komponente der Fehler steckt und wie ein Test ihn dauerhaft fernhält.

Wir nutzen ANDI als einen Baustein im Accessibility Audit. Die Befunde ordnen wir den Kriterien der WCAG zu und beheben sie im barrierefreien Webdesign. Oft geht es um fehlende Namen an Steuerelementen, also um Name, Rolle und Zustand, um falsch eingesetztes ARIA oder um eine wacklige Keyboard Navigation.

Eine Röntgenbrille für deine Webseite

Du siehst ein Lupen Symbol oben rechts und weißt sofort: Hier geht es zur Suche. Ein Screenreader sieht kein Symbol. Er liest nur, was im Code steht. Fehlt dort ein Name, hört der Mensch am anderen Ende nur „Schaltfläche“ und muss raten.

ANDI ist wie eine Röntgenbrille. Du setzt sie auf, fährst mit der Maus über ein Element oder springst mit der Tab Taste dorthin, und ANDI zeigt dir im Feld Output, was ein Screenreader über dieses Element sagen sollte. Laut SSA beruht diese Ausgabe auf der Accessible Name and Description Computation des W3C.

Plötzlich wird sichtbar, was vorher verborgen war: der Link „Mehr“, der fünfmal auf der Seite steht. Das Bild, dessen Alternativtext nur der Dateiname ist. Das Formularfeld, dessen Label nirgends verknüpft ist. Du musst dafür keinen Screenreader bedienen können. Genau das macht ANDI so wertvoll für Entwickler und Redakteure.

Acht Module, drei Warnstufen

ANDI prüft nicht alles auf einmal. Jedes Modul schaut auf eine Sorte von Elementen. Auf der Hilfeseite der SSA stehen diese acht:

  • ANDI: fokussierbare Elemente wie Buttons, Links und Formularfelder.
  • lANDI: Links und Buttons, geprüft auf eindeutige und vollständige Namen.
  • gANDI: Grafiken und Bilder, etwa ob ein Alternativtext da ist.
  • tANDI: Tabellen, also Spaltenköpfe und welche Zelle zu welchem Kopf gehört.
  • sANDI: Strukturen wie semantische Tags und ARIA Rollen.
  • cANDI: Farbkontrast von Text und Hintergrund.
  • hANDI: versteckte Inhalte, die per CSS ausgeblendet sind.
  • iANDI: Inhalte in iframes.

Findet ANDI ein Problem, zeigt es eine Meldung in einer von drei Stufen: Danger (rot, fast sicher ein Fehler), Warning (orange, wahrscheinlich ein Fehler oder uneinheitlich in Screenreadern) und Caution (gelb, genauer hinsehen).

Wichtig: Der Output zeigt nur den Text, den ein Screenreader nutzt. Wörter wie „Schaltfläche“ oder „Grafik“, die ein Screenreader selbst ergänzt, fehlen dort. Und wie ein Screenreader den Text am Ende wirklich vorliest, siehst du nur im echten Test.

Wo ANDI zwischen Scanner und Screenreader steht

ANDI ist ein Werkzeug unter mehreren. Ein Scanner wie axe findet viele Fehler in Sekunden, versteht aber keinen Zusammenhang. Ein Screenreader zeigt das echte Erlebnis, braucht aber Übung. ANDI liegt dazwischen. Die Tabelle zeigt, wie die Stufen aufeinander aufbauen.

Vier Stufen der Prüfung

Stufe Werkzeug Was du erfährst
1: Automatischer Scan axe, Browser Erweiterungen Viele technische Fehler in Sekunden, ohne Kontext
2: Inspektion von Hand ANDI Was ein Screenreader über jedes Element sagen sollte
3: Echter Screenreader Test NVDA, VoiceOver, JAWS Wie sich die Seite beim Zuhören wirklich anfühlt
4: Regressionstest Cypress mit cypress-axe Gefundene Fehler kommen nicht unbemerkt zurück

Was ANDI findet, hält Cypress fest

Jeden Fund einmal festnageln. ANDI prüfst du von Hand. Beim nächsten Release kann der Fehler still zurückkommen. Deshalb schreiben wir jeden Fund als Cypress Test fest. Der erste Test prüft genau die Namen, die du vorher im ANDI Output gesehen hast. Selektoren und Texte passt du an deine Seite an.

Code:
          

describe('Namen aus dem ANDI Check bleiben erhalten', () => {
  beforeEach(() => {
    cy.visit('/')
  })

  it('Such Button hat einen Namen', () => {
    cy.get('header button.search-toggle')
      .should('have.attr', 'aria-label', 'Suche öffnen')
  })

  it('Logo hat einen sprechenden Alternativtext', () => {
    cy.get('header img.logo')
      .should('have.attr', 'alt')
      .and('not.be.empty')
      .and('not.match', /\.(png|jpe?g|svg|webp)$/i)
  })

  it('Kein Link heißt nur Mehr', () => {
    cy.get('main a').each(($a) => {
      expect($a.text().trim()).not.to.eq('Mehr')
    })
  })
})

Die ganze Seite im Blick behalten. Mit cypress-axe prüfst du dazu gezielt die Regeln, die zu den ANDI Modulen für Links, Buttons, Bilder und Formulare passen. So meldet der Test jeden neuen Button ohne Namen, auch in Komponenten, die du nie von Hand angeschaut hast.

Code:
          

import 'cypress-axe'

it('Buttons, Links, Bilder und Felder haben Namen', () => {
  cy.visit('/')
  cy.injectAxe()
  cy.checkA11y(null, {
    runOnly: {
      type: 'rule',
      values: ['button-name', 'link-name', 'image-alt', 'label']
    }
  })
})

Sechs Irrtümer rund um ANDI

  1. „ANDI ersetzt den Screenreader Test.“ Nein. ANDI zeigt, was ein Screenreader sagen sollte. Wie NVDA oder VoiceOver es wirklich vorlesen und wie sich die Bedienung anfühlt, merkst du nur im echten Test.
  2. „Keine Meldung heißt barrierefrei.“ ANDI meldet nur, was es erkennen kann. Ob ein Name sinnvoll ist, musst du selbst beurteilen.
  3. „Ein Durchlauf reicht.“ Jedes Modul schaut auf etwas anderes. Wer nur das Standard Modul startet, übersieht Tabellen, Kontraste und versteckte Inhalte.
  4. „Versteckte Inhalte zählen nicht.“ Menüs, Dialoge und Akkordeons sind auch Inhalt. Die SSA rät, sie über ihren normalen Auslöser zu öffnen und dann zu prüfen.
  5. „iframes werden mitgeprüft.“ Inhalte in iframes testest du laut SSA separat in einem eigenen Fenster.
  6. „Gefunden ist erledigt.“ Ohne Test kommt der Fehler mit dem nächsten Release zurück. Erst der Regressionstest macht den Fund dauerhaft.

It is the piece of information used by Assistive Technologies (AT) to identify the element.

Léonie Watson, Mitgründerin und Direktorin von TetraLogical – What is an accessible name?, TPGi (heute Vispero)

Die meisten Funde beginnen im Markup

ANDI liest den Code so, wie ihn der Browser an assistive Technik weitergibt. Was dort fehlt, fehlt auch beim Zuhören. Deshalb lohnt sich der Blick auf die Grundlagen: Semantic HTML liefert viele Namen von selbst, und das Document Object Model entscheidet, was ein Screenreader überhaupt zu sehen bekommt.

Typische Baustellen sind Buttons mit reinem Symbol, wie sie die Seite zu barrierefreien Icons beschreibt, und Eingabefelder ohne verknüpftes Label aus dem Thema barrierefreie Formulare. Für Kontraste hilft dir neben cANDI auch der Farbkontrast Rechner.

ANDI ist nur ein Werkzeug im Koffer. Einen Überblick über weitere Helfer gibt die Seite zu Accessibility Testing Tools, einen automatischen Ansatz zeigt der Silktide Accessibility Checker. Wie die Werkzeuge zu einer Methode werden, erklärt die Seite zum Accessibility Testing. Den rechtlichen Rahmen in Deutschland setzt das BFSG.

CYPRESS.IO Ambassador und IT Consultant für QA Engenieering und Qualität in PHP Projekten.
Erreichen Sie unsere Spezialisten zu barrierefreien Webdesign

Wir sind hier, um Ihnen zu helfen. Gemeinsam meistern wir Ihre digitalen Herausforderungen und fördern die Inklusion im Internet. Lassen Sie uns Ihre Projekte mit barrierefreiem Webdesign erfolgreich machen.

Häufige Fragen zu ANDI

Einrichtung, Module, Grenzen und das Zusammenspiel mit automatischen Tests: die wichtigsten Antworten zu ANDI.

Was ist ANDI 2026?

ANDI ist ein kostenloses Bookmarklet der US Sozialversicherungsbehörde SSA für die Prüfung von Webseiten von Hand. Es zeigt für jedes Element, welchen Namen und welche Beschreibung ein Screenreader vorlesen sollte. Dazu meldet es mögliche Probleme in drei Stufen. ANDI ist Open Source und steht 2026 auf der Seite der SSA bereit.

Ist ANDI 2026 kostenlos?

Ja. ANDI kostet nichts und braucht kein Konto. Du ziehst den Link von der Seite der SSA in deine Lesezeichenleiste und startest ihn auf jeder Seite, die du prüfen willst. ANDI aktualisiert sich selbst, du musst es also nicht neu installieren, wenn eine neue Version erscheint.

In welchen Browsern läuft ANDI 2026?

Laut SSA läuft ANDI in den Desktop Browsern Chrome, Edge, Firefox und Safari. In Safari gibt es keinen einfachen Weg, das Lesezeichen nur mit der Tastatur zu speichern. Mobile Browser nennt die SSA nicht. Für Prüfungen auf dem Smartphone nutzt du deshalb die Screenreader der Geräte selbst.

Ersetzt ANDI 2026 einen Screenreader Test?

Nein. ANDI zeigt, was ein Screenreader über ein Element sagen sollte. Wie NVDA, JAWS oder VoiceOver den Text wirklich vorlesen und wie sich die Bedienung anfühlt, zeigt nur ein echter Test. ANDI hilft dir, viele Fehler vorher zu finden, damit der Screenreader Test schneller und gezielter läuft.

Welche Module hat ANDI 2026?

Die SSA nennt acht Module: ANDI für fokussierbare Elemente, lANDI für Links und Buttons, gANDI für Grafiken, tANDI für Tabellen, sANDI für Strukturen, cANDI für Farbkontrast, hANDI für versteckte Inhalte und iANDI für iframes. Jedes Modul prüft eine Sorte von Elementen, deshalb lohnt sich ein Durchlauf durch alle.

Was zeigt der ANDI Output?

Der Output zeigt den Namen und die Beschreibung, die ein Screenreader für das gewählte Element nutzen sollte. Die Berechnung folgt laut SSA der Accessible Name and Description Computation des W3C. Wörter, die ein Screenreader selbst ergänzt, etwa die Rolle eines Elements, stehen nicht im Output.

Was ist der Unterschied zwischen ANDI und axe?

axe ist eine Regel Engine, die eine Seite automatisch scannt und Fehler auflistet. ANDI ist ein Werkzeug für die Prüfung von Hand: Du gehst Element für Element durch und siehst, was ein Screenreader sagen sollte. Beide ergänzen sich gut. axe findet viel in Sekunden, ANDI hilft beim Beurteilen.

Was bedeuten die Meldungen Danger, Warning und Caution?

Danger ist rot und steht für ein fast sicheres Problem. Warning ist orange und zeigt ein wahrscheinliches Problem oder ein Verhalten, das in Screenreadern unterschiedlich ausfällt. Caution ist gelb und heißt: genauer hinsehen. Keine Meldung bedeutet nicht automatisch, dass ein Element barrierefrei ist.

Kann ANDI Farbkontraste prüfen?

Ja, mit dem Modul cANDI. Es liest Text und Hintergrundfarbe aus, berechnet das Kontrastverhältnis und meldet, ob der Mindestwert erreicht ist. Bei Hintergründen mit Bild oder Verlauf kann ANDI nicht rechnen und markiert die Stelle für eine Prüfung von Hand. Dazu gibt es eine Graustufen Ansicht.

Wie prüft ANDI versteckte Inhalte?

Das Modul hANDI findet Inhalte, die per CSS ausgeblendet sind, und kann sie sichtbar machen. Die SSA rät aber, solche Inhalte besser über ihren normalen Auslöser zu öffnen, etwa einen Menü Button. Nur so prüfst du die Seite in einem Zustand, den Nutzer auch wirklich erleben.

Wie mache ich ANDI Funde dauerhaft?

Schreib jeden Fund als automatisierten Test fest. Mit Cypress prüfst du gezielt, ob ein Button seinen Namen behält oder ein Bild einen sinnvollen Alternativtext hat. Mit cypress-axe kommen Regeln wie button-name, link-name und image-alt dazu. So fällt ein Rückfall beim nächsten Release sofort auf.

Wer sollte ANDI nutzen?

Alle, die Webseiten bauen oder pflegen. Entwickler sehen sofort, ob ihre Komponenten sprechende Namen haben. Redakteure prüfen Alternativtexte und Linktexte. Tester nutzen ANDI als festen Schritt im Audit. Du brauchst dafür keine Erfahrung mit Screenreadern, nur einen Desktop Browser und etwas Neugier.