NCA Social Media
Erstellt:
Aktualisiert:
Autor:
Roland Golla
Grünes Mikrofon, eine Nachricht auf allen Geräten: Headless

Was bedeutet Headless und was hat es mit Barrierefreiheit zu tun?

Headless heißt, dass ein CMS oder Shopsystem nur Inhalte verwaltet und über eine Schnittstelle ausliefert. Die Darstellung, der Kopf, wird getrennt davon gebaut, etwa als Website, App oder Sprachausgabe.

Stell dir einen Container voller Inhalte vor, aus dem Leitungen zu Website, Smartphone, Smartwatch und Lautsprecher führen. Ein Text wird einmal gepflegt und landet überall. Das ist der große Vorteil von Headless, und für die Barrierefreiheit Chance und Risiko zugleich.

Denn ein Headless CMS ist weder barrierefrei noch unzugänglich. Ob Menschen mit Screenreader, Tastatur oder Vergrößerung die Inhalte nutzen können, entscheidet sich an zwei Stellen: im Inhaltsmodell des CMS und im Frontend, das die Inhalte darstellt.

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

Wir verbinden Sulu und Astro zu einem barrierefreien Headless Setup

Headless ist bei NCA Alltag. Wir arbeiten täglich mit Sulu als CMS und Astro, React und Vue im Frontend. Dabei sehen wir, wo Barrierefreiheit in entkoppelten Systemen verloren geht: im Inhaltsmodell, in der Übergabe von Rich Text und in Komponenten, die jedes Frontend neu erfindet.

Wir helfen Teams, Barrierefreiheit in beide Hälften einzubauen. Im CMS legen wir Pflichtfelder für Alternativtexte, Sprachangaben und Untertitel an. Im Frontend setzen wir die Inhalte mit semantischem HTML und barrierefreien Astro Komponenten um. Für Inhalte, die als Sprachausgabe oder in Apps landen, denken wir Text to Speech und eine saubere Lesereihenfolge gleich mit. Die Qualität halten wir über automatisiertes Accessibility Testing in der Pipeline, eingebettet in unsere Arbeit im barrierefreien Webdesign.

Bei einem Inhalt mit vielen Köpfen entsteht Barrierefreiheit an mehreren Stellen

Bei einem klassischen CMS liefert das System das fertige HTML gleich mit. Bei Headless teilt sich die Verantwortung auf zwei Seiten auf:

  • Das Inhaltsmodell im CMS: Gibt es ein Feld für den Alternativtext, und ist es Pflicht? Werden Überschriften als Ebenen gespeichert oder nur als fett formatierter Text? Lässt sich bei einem Zitat in einer anderen Sprache die Sprache angeben? Hat ein Video ein Feld für die Untertiteldatei?
  • Das Frontend: Macht aus den Daten echtes HTML mit Überschriften, Listen, Buttons und Landmarks. Setzt den Alternativtext ins richtige Attribut. Führt den Fokus bei Seitenwechseln ohne Neuladen.

Fehlt etwas im Inhaltsmodell, kann das beste Frontend es nicht herzaubern. Ist das Inhaltsmodell perfekt, aber das Frontend baut alles aus div Elementen, kommt beim Nutzer trotzdem nichts an. Barrierefreiheit braucht bei Headless beide Hälften.

Der Lohn: Wer es einmal sauber aufsetzt, bekommt Barrierefreiheit auf jedem Kanal. Derselbe Alternativtext landet auf der Website, in der App und in der Sprachausgabe.

Was ein barrierefreies Inhaltsmodell braucht

Ein gutes Inhaltsmodell macht Barrierefreiheit zur Standardeinstellung statt zur Zusatzaufgabe. Diese Felder und Regeln haben sich bewährt:

  • Alternativtext als Pflichtfeld an jedem Bild, mit der Option „dekorativ“, die bewusst angehakt werden muss.
  • Strukturierter Rich Text mit echten Überschriften Ebenen, Listen und Links, nicht nur Schriftgröße und Fettdruck.
  • Sprachangabe pro Seite und für einzelne Abschnitte in anderen Sprachen, damit Screenreader die richtige Aussprache wählen.
  • Untertitel und Transkript als Felder an jedem Video.
  • Linktexte statt „hier klicken“: Redaktionshinweise direkt im Feld helfen, aussagekräftige Linktexte zu schreiben.
  • Kurzfassung in Einfacher Sprache als optionales Feld für wichtige Inhalte.

In Sulu lassen sich solche Felder direkt in den Seitenvorlagen anlegen und als Pflicht markieren. Andere Headless Systeme bieten vergleichbare Validierungen.

Wie weit trägt Barrierefreiheit durch euer Headless Setup?

In vielen Headless Projekten ist die Website barrierefrei, aber die App oder der Newsletter nicht. Die Tabelle zeigt, wie weit Barrierefreiheit in einem entkoppelten Setup reicht und was es für die nächste Stufe braucht.

Barrierefreiheit im Headless Setup

Ausbau Merkmal Was als Nächstes kommt
1 Zufällig Barrierefreiheit hängt davon ab, ob die Redaktion an Alternativtexte denkt Pflichtfelder im Inhaltsmodell anlegen
2 Im CMS verankert Alt Texte, Sprache und Untertitel sind Pflicht, Rich Text ist strukturiert Frontend Komponenten auf semantisches HTML umstellen
3 Im Frontend umgesetzt Komponenten geben Struktur und Alternativtexte korrekt aus Weitere Kanäle wie App und Sprachausgabe einbeziehen
4 Auf allen Kanälen geprüft Jeder Kanal nutzt dieselben Daten, Tests laufen bei jedem Release Cypress Tests pro Kanal in der Pipeline halten

Vom API Feld zum barrierefreien HTML

Das Bild aus der API. Ein gutes Inhaltsmodell liefert neben der Bildadresse auch den Alternativtext und die Angabe, ob das Bild dekorativ ist.

Code:
          

{
  "image": {
    "url": "/media/laufschuh-aero.jpg",
    "alt": "Grüner Laufschuh von der Seite mit weißer Sohle",
    "decorative": false
  },
  "locale": "de"
}

Eine Astro Komponente, die nichts vergisst. Ist das Bild dekorativ, bekommt es ein leeres alt. Fehlt der Alternativtext bei einem inhaltlichen Bild, bricht der Build ab, statt eine Lücke auszuliefern.

Code:
          

---
const { image } = Astro.props
if (!image.decorative && !image.alt?.trim()) {
  throw new Error(`Alternativtext fehlt für ${image.url}`)
}
---
<img src={image.url} alt={image.decorative ? '' : image.alt} loading="lazy" />

Alle Kanäle prüfen. Der Cypress Test lädt die Inhalte direkt aus der API und kontrolliert, dass jedes nicht dekorative Bild einen Alternativtext hat, bevor das Frontend sie überhaupt anzeigt.

Code:
          

describe('Inhaltsmodell Barrierefreiheit', () => {
  it('jedes inhaltliche Bild hat einen Alternativtext', () => {
    cy.request('/api/pages?locale=de').then(({ body }) => {
      body.items
        .flatMap((page) => page.images ?? [])
        .filter((img) => !img.decorative)
        .forEach((img) => expect(img.alt, img.url).to.be.a('string').and.not.be.empty)
    })
  })
})

Wo Inhalte auf dem Weg zum Nutzer etwas verlieren

  1. Alternativtext gepflegt, aber nicht ausgegeben. Das Feld existiert im CMS, das Frontend nutzt nur die Bildadresse.
  2. Rich Text als HTML Brei. Die API liefert Fließtext mit Inline Styles statt strukturierter Überschriften und Listen.
  3. Überschriften frei wählbar. Redakteure nehmen H4, weil die Schrift schöner aussieht, und brechen die Gliederung.
  4. Kein Fokus nach Seitenwechsel. Das Frontend lädt Seiten ohne Neuladen, aber Screenreader erfahren nichts davon.
  5. Jeder Kanal baut eigene Komponenten. Website, App und Kiosk lösen dieselbe Aufgabe dreimal, mit drei verschiedenen Barrieren.
  6. Sprache fehlt. Die API liefert keinen Sprachcode, das Frontend setzt kein lang Attribut.

Both monolithic and headless solutions are not inherently accessible, unfortunately.

Josefine Schaefer, Developer Relations Engineer bei Storyblok – Headless In Times Of Accessibility, Smashing Magazine

Einmal richtig gepflegt, überall barrierefrei

Der größte Hebel bei Headless liegt im Inhaltsmodell. Eine Stunde, in der Entwicklung und Redaktion gemeinsam festlegen, welche Felder Pflicht sind, spart später hunderte Korrekturen in jedem einzelnen Kanal. Danach braucht es nur noch Komponenten, die diese Felder sauber ausgeben.

Headless berührt viele Themen der Barrierefreiheit. Bilder brauchen gute Regeln für Nicht-Text-Inhalte, Überschriften folgen den Grundsätzen barrierefreier Headlines, und Videos kommen mit Untertiteln. Für verständliche Kurzfassungen helfen die Regeln der Leichten und Einfachen Sprache.

Wie Inhalte im Browser zum Accessibility Tree werden, erklärt die Seite zum Document Object Model. Für Single Page Frontends ist die logische Reihenfolge der Fokusführung besonders wichtig. Den Bezug zu Sulu im Detail zeigt unser Sulu CMS Glossar.

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 Headless und Barrierefreiheit

Inhaltsmodell, Frontend, Sulu und mehrere Kanäle: was Teams bei entkoppelten Systemen beachten sollten.

Was bedeutet Headless im Zusammenhang mit Barrierefreiheit 2026?

Headless bedeutet, dass ein CMS oder Shopsystem Inhalte nur verwaltet und über eine Schnittstelle ausliefert. Die Darstellung baut ein getrenntes Frontend. Für die Barrierefreiheit heißt das 2026: Sie entsteht im Inhaltsmodell und im Frontend gemeinsam. Fehlt eine der beiden Hälften, kommen Inhalte bei Menschen mit Behinderung nicht vollständig an.

Ist ein Headless CMS 2026 automatisch barrierefrei?

Nein. Ein Headless CMS ist weder barrierefrei noch unzugänglich, weil es selbst kein HTML ausliefert. Entscheidend ist 2026, ob das Inhaltsmodell alle nötigen Informationen wie Alternativtexte und Sprache erfasst und ob das Frontend daraus semantisches HTML erzeugt. Die Verantwortung liegt also beim Team, das beides baut.

Welche Felder braucht ein barrierefreies Inhaltsmodell 2026?

Bewährt haben sich Pflichtfelder für Alternativtexte mit einer bewussten Option für dekorative Bilder, strukturierter Rich Text mit echten Überschriften Ebenen, eine Sprachangabe pro Seite und Abschnitt sowie Felder für Untertitel und Transkripte an Videos. 2026 kommt bei vielen Teams eine optionale Kurzfassung in Einfacher Sprache dazu.

Gilt das BFSG 2026 auch für Headless Shops?

Ja. Das BFSG fragt nicht, wie ein Shop technisch gebaut ist, sondern ob Verbraucher ihn barrierefrei nutzen können. Ein Headless Shop muss 2026 dieselben Anforderungen erfüllen wie ein klassischer. Weil Frontend und Backend getrennt sind, sollte die Prüfung beide Seiten und alle Kanäle wie Website und App umfassen.

Wie teste ich ein Headless Setup 2026 auf Barrierefreiheit?

Auf zwei Ebenen. Zuerst prüft ihr die Daten aus der API, etwa ob jedes inhaltliche Bild einen Alternativtext hat. Danach prüft ihr jedes Frontend mit axe, Tastatur und Screenreader. 2026 lassen sich beide Ebenen mit Cypress in einer Pipeline kombinieren, sodass fehlende Daten und fehlerhafte Ausgabe früh auffallen.

Ist Sulu ein Headless CMS?

Sulu kann beides. Es liefert klassisch gerenderte Seiten über Twig und bietet mit dem Headless Bundle eine Schnittstelle für entkoppelte Frontends. So lassen sich Inhalte in Sulu pflegen und zum Beispiel mit Astro, React oder Vue ausspielen. Die Barrierefreiheit hängt in beiden Fällen von Vorlagen, Feldern und Komponenten ab.

Ist Headless besser für Barrierefreiheit als ein klassisches CMS?

Nicht automatisch. Headless gibt mehr Kontrolle über das Frontend, damit aber auch mehr Verantwortung. Ein Team, das barrierefreie Komponenten baut, kann mit Headless sehr gute Ergebnisse auf vielen Kanälen erreichen. Ein Team ohne diese Erfahrung erzeugt mit Headless schneller Barrieren als mit einem fertigen Theme.

Wie gehe ich mit Rich Text aus der API um?

Am besten liefert die API Rich Text als strukturierte Daten, etwa Absätze, Überschriften mit Ebene, Listen und Links mit Text. Das Frontend wandelt diese Struktur in semantisches HTML um. Kommt nur fertiges HTML mit Inline Styles, gehen Überschriften Ebenen oder Listen oft verloren.

Was ist bei Single Page Frontends wichtig?

Viele Headless Frontends laden Seiten ohne vollständiges Neuladen. Screenreader bemerken den Wechsel dann nicht. Nach jedem Seitenwechsel sollte der Fokus auf die neue Hauptüberschrift springen und der Seitentitel aktualisiert werden. Astro mit klassischen Seitenwechseln umgeht das Problem in vielen Fällen ganz.

Helfen Headless Systeme bei Sprachassistenten?

Ja, wenn das Inhaltsmodell gut strukturiert ist. Kurze, klar gegliederte Inhalte mit Sprachangabe lassen sich direkt für Sprachausgaben nutzen. Lange Fließtexte mit Layout Anweisungen eignen sich dagegen schlecht. Wer Inhalte für mehrere Kanäle plant, schreibt automatisch strukturierter.

Wer ist bei Headless für Barrierefreiheit verantwortlich?

Alle drei Gruppen gemeinsam. Die Entwicklung baut Inhaltsmodell und Komponenten, die Redaktion füllt Felder wie Alternativtexte sinnvoll, und das Design legt Kontraste, Fokusstile und Zielgrößen fest. Klare Pflichtfelder und Tests helfen, dass niemand eine Lücke an die nächste Gruppe weiterreicht.

Lohnt sich Barrierefreiheit bei Headless doppelt?

Ja. Einmal sauber gepflegte Inhalte mit Alternativtexten, Struktur und Sprache funktionieren auf jedem Kanal. Website, App, Kiosk und Sprachausgabe profitieren gleichzeitig. Auch Suchmaschinen und KI Systeme verstehen strukturierte Inhalte besser, was die Sichtbarkeit verbessert.