Inhalte von der Übersetzung ausschließen

Willkommen auf Ihrer Conword-Demoseite. Hier sehen Sie alle Möglichkeiten, Inhalte von der Übersetzung auszuschließen, jeweils mit einem lebenden Beispiel.

Übersetzen Sie die Seite und vergleichen Sie die grau hinterlegten Beispiele mit der Ergebnistabelle am Seitenende. Diese Demoseite ist mit skip_classes: ["legal-text"] konfiguriert.

1. Das Attribut translate="no"

Der HTML-Standard. Das Element und alle Kinder werden übersprungen. Funktioniert ohne Conword-spezifisches Markup und wird auch von Browser-Übersetzern respektiert.

<p translate="no">Dieser Text bleibt in der Originalsprache.</p>

2. Die Klasse cnw_skip_translation

Die Conword-eigene Klasse. Praktisch, wenn Sie Klassen per CMS oder Javascript vergeben.

<p class="cnw_skip_translation">Dieser Text bleibt in der Originalsprache.</p>

3. Das Attribut data-conword-skip-translation

Ein Daten-Attribut ohne Wert. Nützlich, wenn Sie keine Klassen anfassen möchten.

<p data-conword-skip-translation>Dieser Text bleibt in der Originalsprache.</p>

4. Die Klasse notranslate

Wird ebenfalls erkannt, weil viele Systeme diese Klasse bereits verwenden.

<p class="notranslate">Dieser Text bleibt in der Originalsprache.</p>

5. Eigene Klassen über die Option skip_classes

Wenn Ihr CMS Inhalte schon mit eigenen Klassen markiert, tragen Sie diese in die Konfiguration ein. Ein String, ein Array oder mehrere Klassen durch Leerzeichen getrennt.

<script>
  var conword_config = {
    skip_classes: ["legal-text", "no-translate"]
  };
</script>
<script id="conword-root" charset="utf-8" src="https://static.conword.io/js/v2/[client-id]/conword.js"></script>

<div class="legal-text">
  <p>Dieser Rechtstext bleibt in der Originalsprache.</p>
</div>

6. Formulare

Eingaben Ihrer Besucher in input und textarea werden nie übersetzt. Beschriftungen und placeholder-Attribute dagegen schon. Zeigen Sie Nutzereingaben später wieder an, zum Beispiel in einer Zusammenfassung, schließen Sie diesen Bereich mit einer der Methoden oben aus.

<label>Ihr Name <input type="text" placeholder="Vor- und Nachname" value="Max Mustermann"></label>

<!-- Zusammenfassung der Eingaben: ausschließen -->
<div class="formular_zusammenfassung cnw_skip_translation">
  Sie haben eingegeben: Max Mustermann
</div>

7. Per Javascript ausschließen

Sie können Elemente auch nachträglich markieren. Hier bekommen alle Mail-Links, deren Text eine Adresse ist, die Klasse per Javascript. Nutzen Sie dafür das Ereignis Conword:ready: Es wird ausgelöst, bevor eine gespeicherte Sprache die automatische Übersetzung startet. Mit DOMContentLoaded kann die Markierung zu spät kommen.

document.addEventListener("Conword:ready", function () {
  var mailto_links = document.querySelectorAll('a[href^="mailto:"]');
  for (var i = 0; i < mailto_links.length; i++) {
    if (mailto_links[i].innerHTML.indexOf('@') > -1) mailto_links[i].classList.add('cnw_skip_translation');
  }
});

8. Automatisch ausgeschlossen

Ohne Ihr Zutun überspringt Conword Scripte, Stylesheets, SVG-Inhalte, Bilder, noscript und textarea. Leere Elemente werden ebenfalls ignoriert.

9. Die ganze Seite: Conword.lock()

Soll eine Seite gar nicht übersetzt werden, laden Sie Conword dort nicht, oder sperren Sie es per Javascript. Danach bewirken Sprachwechsel nichts mehr, und der Standard-Sprachwähler wird deaktiviert.

Conword.lock();      // Übersetzung auf dieser Seite sperren
Conword.locked();    // true, wenn gesperrt

Probieren Sie es aus

Der markierte Button zeigt die aktuelle Sprache der Seite. Gesperrt: nein

Ereignisse von Conword (zur Nachvollziehbarkeit):