Wie erstelle ich einen individuellen Button für Translate?
Wie du Translate direkt in deine Seite einbettest
Du kannst, einen individuellen Button oder ein eigenes Interface für Translate zu erstellen und diesen anstelle der vorgefertigten Buttons verwenden.
Wenn du dich dafür entscheidest, führst du die benötigten Funktionen selbst aus, um die Übersetzung zu starten. So kannst du Design, Position und Verhalten der Übersetzung vollständig selbst steuern.
Voraussetzungen für einen individuellen Translate-Button
Damit dein eigener Button funktioniert, musst du einige grundlegende Schritte beachten:
-
Binde die bereitgestellte JavaScript-Datei ein
-
Erstelle kein
<translation-select>Tag - Stattdessen erstellt du ein eigenes individuell gestaltetes HTML-Element
- Füge die Funktion
EA.activateTranslation(tarLang, true)in deinem Code hinzu um die Übersetzung in die gewünschte Zielsprache zu aktivieren- Statt "tarLang" füge den Sprachcode deiner gewünschten Zielsprache zur Funktion hinzu
-
Empfohlen: Führe beim initialen Laden der Seite die Funktion
EA.init_localLang(true)aus
Durch diese Initialisierung kann das System erkennen, ob Nutzende zuvor bereits eine andere Sprache gewählt haben.
Übersetzung über Funktionen steuern
Wenn du einen eigenen Button verwendest, wird die Übersetzung über Funktionen gesteuert.
Zum Starten der Übersetzung verwendest du folgende Funktion:
EA.activateTranslation(tarLang, true)
Diese Funktion startet die Übersetzung der Seite in die gewünschte Zielsprache. Die Zielsprache lässt sich über den Sprachcode definieren, welcher statt "tarLang" in der Funktion eingefügt wird.
Beispiel:
Übersetzung in britisches Englisch: EA.activateTranslation(en-GB, true)
Nutzungsszenario
Eine Person besucht deine Website, beim Laden der Seite wird die Funktion EA.init_localLang(true) ausgeführt.
Wenn Translate auf dieser Seite bereits zuvor ausgeführt worden ist und ein entsprechender Local Storage-Eintrag vorliegt, wird die Website automatisch in die im Local Storage hinterlegte Sprache übersetzt.
Möchte die Person die Seite neu übersetzen, klickt Sie auf den von dir erstellten Button der die Übersetzung startet. Dabei wird die im Button hinterlegte Funktion EA.activateTranslation ausgeführt. Je nachdem welcher Sprachcode in der Funktion eingebunden ist, wird die Übersetzung in diese Sprache vorgenommen und die Seite in der Zielsprache angezeigt.