So übersetzt du die Benutzeroberfläche einer Web-App

So übersetzt du die Benutzeroberfläche einer Web-App

Zuletzt aktualisiert: 12. September 2026

Für die Übersetzung der Benutzeroberfläche einer Webanwendung gibt es zwei echte Optionen. Du kannst alle Strings in Locale-Dateien extrahieren, die mit der App ausgeliefert werden, oder eine Ebene über das gerenderte DOM legen, die Text austauscht, sobald er erscheint. Die meisten Teams landen bei einer Mischung aus beidem. Welche der beiden Optionen mehr Arbeit übernimmt, hängt davon ab, wie viel deiner Benutzeroberfläche aus Produkttexten und wie viel aus Inhalten besteht.

In diesem Leitfaden geht es um App-Bildschirme und nicht um Landingpages: Dashboards, Einstellungen, Formulare, Buttons, leere Zustände, Fehlermeldungen und die E-Mails, die deine App versendet. Die Fehlermodi sind anders, und die meisten Ratschläge zum Thema „eine Website übersetzen“ halten dem Kontakt mit einer echten Produktbenutzeroberfläche nicht stand.

Der Aufwand lohnt sich. CSA Research befragte 8.709 Verbraucher in 29 Ländern und stellte fest, dass 40 % niemals auf Websites in anderen Sprachen einkaufen werden. Dr. Donald A. DePalma, Chief Research Officer des Unternehmens, brachte es auf den Punkt: „Wenn sich ein Unternehmen dafür entscheidet, das Einkaufserlebnis nicht zu lokalisieren, riskiert es, 40 % oder mehr des gesamten adressierbaren Marktes zu verlieren.“

Eine App-Oberfläche funktioniert ganz anders als eine Marketingseite

Eine Landingpage ist ein feststehender Textblock, der beim Laden bereits im HTML steht. Eine App ist eine Maschine, die Text erzeugt. Ein Validierungsfehler existiert erst, nachdem jemand ein fehlerhaftes Formular abgeschickt hat. Ein Toast wird vier Sekunden lang angezeigt. Der Inhalt eines Modals befindet sich erst dann im Dokument, wenn ein Klick ihn erzeugt. Ein leerer Zustand erscheint nur bei Konten ohne Daten, was auf deinem eigenen Rechner normalerweise nie der Fall ist.

Das ist wichtig, denn jede Methode muss eine Frage beantworten: Wann wird ein String zu Text? Locale-Dateien beantworten diese Frage zur Build-Zeit. Eine Runtime-Ebene beantwortet sie bei jeder Änderung des DOM. Alles, was diese Frage nur beim Laden der Seite beantwortet, wird den Großteil deines Produkts verpassen.

Die Grammatik macht Probleme, bevor es das Layout tut

Als Erstes gehen Mengenangaben schief. Im Englischen gibt es zwei Pluralformen, und in vielen Codebasen wird stillschweigend angenommen, dass das überall so ist. Unicode CLDR definiert sechs Pluralkategorien: Null, Eins, Zwei, Wenige, Viele und Sonstige. Im Arabischen werden alle sechs für Kardinalzahlen verwendet, im Russischen und Polnischen vier, im Japanischen und Koreanischen eine. Ein String wie {count} items lässt sich nicht einfach durch ein angehängtes „s“ reparieren. Bei falscher Umsetzung wirkt die Benutzeroberfläche kaputt und nicht nur fremd.

Danach kommen Datums- und Zahlenformate. Dieselbe Bestellsumme lautet in den USA 1,299.50, in Deutschland 1.299,50 und in Frankreich 1 299,50. Dafür brauchst du keine Bibliothek, denn Intl.NumberFormat und Intl.DateTimeFormat sind in jedem aktuellen Browser integriert. Die Formatierung ist der einzige Teil der i18n für Apps, den die Plattform tatsächlich für dich gelöst hat.

Übersetzte Beschriftungen passen nicht in die von dir entworfenen Buttons

Texterweiterung ist ein Layoutfehler, der erst in der Produktion sichtbar wird. Die Richtlinien des W3C zur Textlänge in Übersetzungen geben IBMs Tabelle zur Texterweiterung wieder. Ihr Muster ist das Gegenteil dessen, was die meisten erwarten: Bei Ausgangsstrings mit bis zu zehn Zeichen sollte man mit einer Erweiterung um 200 bis 300 Prozent rechnen, während sich Strings mit mehr als siebzig Zeichen bei etwa 130 Prozent einpendeln.

Betrachte das im Kontext einer Benutzeroberfläche. Deine längsten Absätze sind das Sicherste auf der Seite. Deine Buttons, Tab-Beschriftungen und Menüpunkte sind die Stellen, an denen die Probleme auftreten. Auf derselben W3C-Seite wird gemessen, dass das Wort „views“ auf Deutsch 2,8-mal länger ist als auf Englisch. Die Schreibrichtung ist die andere Hälfte: Das W3C zählt zwölf rechtsläufige Schriften in 215 Sprachen, und RTL ist ein CSS-Problem, kein Übersetzungsproblem.

Option eins: eine i18n-Bibliothek zur Build-Zeit

Du umschließt jeden nutzerseitig sichtbaren String mit einem Funktionsaufruf, extrahierst sie pro Locale in JSON-Dateien und lieferst diese mit aus. i18next ist die Standardlösung in JavaScript. Das Kernpaket kommt auf rund 16 Millionen wöchentliche npm-Downloads, dazu kommen weitere 11,6 Millionen für react-i18next (npm, Woche ab dem 5. September 2026). Die eigene Dokumentation beschreibt den Umfang treffend: „i18next bietet mehr als nur die standardmäßigen i18n-Funktionen (wie Pluralformen, Kontext, Interpolation und Formatierung).“

Das ist das eigentliche Argument dafür. Du erhältst Pluralkategorien, Interpolation, Kontextvarianten, Namespaces mit verzögertem Laden und, was besonders wichtig ist, Übersetzungen außerhalb des Browsers. So greifen E-Mails, PDFs und API-Fehler auf denselben Katalog zu. Der Preis dafür ist Entwicklungszeit: Jemand muss die Strings umschließen und verhindern, dass unübersetzte Texte in jeden Pull Request gelangen.

Option zwei: eine Übersetzungsschicht zur Laufzeit

Der andere Ansatz lässt deinen Code unangetastet. Ein Skript beobachtet das gerenderte DOM, erfasst sichtbaren Text und ersetzt ihn, sobald neue Knoten erscheinen. Da es auf Änderungen statt auf Seitenaufrufe reagiert, erfasst es auch Modals, Toasts und Zeilen, die nachträglich über eine API geladen werden.

Der überzeugendste Vorteil ist die Geschwindigkeit. Innerhalb eines Nachmittags erhältst du eine übersetzte Benutzeroberfläche, ohne eine Komponente anzufassen. Das eignet sich für interne Tools, Admin-Panels und Produkte in der Anfangsphase. Außerdem verarbeitet der Ansatz nutzergenerierte Inhalte, was mit Locale-Dateien grundsätzlich nicht möglich ist, denn kein Build-Schritt weiß, was deine Kunden schreiben werden.

Die Einschränkungen sind noch wichtiger. Der Ansatz kann keine Zeichenfolge übersetzen, die nie im DOM landet. Transaktions-E-Mails, Push-Benachrichtigungen und API-Antworten bleiben daher unverändert. Beim ersten Rendern kommt ein Netzwerkaufruf hinzu, also solltest du mit einem kurzen Moment rechnen, in dem Inhalte noch nicht übersetzt sind.

Wo die Grenze zwischen den beiden Ansätzen verläuft

In der Praxis hängt die Grenze von der Zuständigkeit ab, nicht von der Technologie. Gehört eine Zeichenfolge zur Produktspezifikation und wird ihr Wortlaut geprüft und freigegeben, gehört sie in Locale-Dateien. Mozillas Project Fluent bringt es besser auf den Punkt als alle anderen: „Übersetzer sollten die gesamte Ausdruckskraft ihrer Sprache nutzen können, ohne Entwickler um Erlaubnis bitten zu müssen.“ Das ist mit einem System, das nur gerendertes Englisch sieht, nicht möglich.

Alles andere sind Inhalte: Hilfetexte, Änderungsprotokolle, In-App-Marketing und alles, was Nutzer selbst geschrieben haben. Genau dafür ist WeLocale gedacht: mit einem Script-Tag, Übersetzung mit KI direkt im Live-DOM, einschließlich Inhalten, die nach dem Laden der Seite erscheinen, und einem Editor, mit dem du fehlerhafte maschinelle Übersetzungen korrigieren kannst. WeLocale ist tatsächlich das falsche Tool, wenn deine übersetzten Zeichenfolgen Teil deiner Produktspezifikation sind.

Die Stolperfallen, die in der zweiten Woche auffallen

Lege das lang-Attribut fest und ändere es, wenn sich die Sprache ändert. Screenreader verwenden es, um die Ausspracheregeln zu bestimmen. Erfolgskriterium 3.1.2 der WCAG 2.2 verlangt, dass „die menschliche Sprache jedes Abschnitts oder jeder Formulierung im Inhalt programmatisch bestimmt werden kann“. Genau für solche App-Bildschirme mit mehreren Sprachen wurde es formuliert.

Ignoriere SEO für alles, was hinter einer Anmeldung liegt. Crawler sehen diese Seiten nie, daher sind hreflang und indexierbare Sprach-URLs dort vergebliche Arbeit. Sie sind nur für deine öffentlichen Seiten relevant.

Setze Caching bewusst ein. Locale-Bundles sollten unveränderlich sein und einen Fingerabdruck tragen. Übersetzungen zur Laufzeit sollten lokal zwischengespeichert werden, damit sie für wiederkehrende Nutzer nicht erneut abgerufen werden müssen. Und schreibe einen Test, der deine längste deutsche Zeichenfolge in deinem schmalsten Button rendert.

FAQ

Kann ich eine React- oder Vue-App übersetzen, ohne die Komponenten neu zu schreiben? Ja, mit einer Laufzeitschicht, die das DOM überwacht und Text ersetzt, nachdem dein Framework ihn gerendert hat. Sie erfasst Modals, Toasts und Daten, die über eine API eintreffen. Zeichenfolgen, die nie im Browser gerendert werden, kann sie nicht abdecken, zum Beispiel Transaktions-E-Mails oder API-Fehlermeldungen.

Was ist mit Text, den Nutzer selbst eingeben? Locale-Dateien helfen dabei nicht, weil kein Build-Schritt weiß, was ein Nutzer schreiben wird. Nutzergenerierte Inhalte müssen zur Laufzeit übersetzt werden, entweder durch eine Schicht auf DOM-Ebene oder indem du vor der Anzeige über deinen eigenen Code eine Übersetzungs-API aufrufst.

Brauche ich hreflang-Tags für ein App-Dashboard? Nein. Seiten hinter einer Anmeldung werden nie gecrawlt, daher haben hreflang und indexierbare Sprach-URLs dort keine Wirkung. Füge sie stattdessen zu deinen öffentlichen Seiten hinzu: Marketing-Website, Dokumentation, Preise und die Anmeldeseite selbst.

Möchtest du das auf deiner eigenen Website? Füge mit einem einzigen Snippet mehr als 50 Sprachen hinzu, ohne Änderungen am Code.

WeLocale kostenlos testen