← Gesamte Dokumentation

Textteilsprache

Markiert die Sprache eines Wortes oder einer Passage, die sich vom Rest des Dokuments unterscheidet, indem es umbrochen wird<span lang="…">. Verwendung von Screenreadernlangum zur richtigen Stimme und Aussprache zu wechseln, sodass ein französisches Zitat auf einer englischen Seite auf Französisch gelesen wird, anstatt falsch ausgesprochen zu werden.WCAG2.1 Erfolgskriterium 3.1.2 (Sprache der Teile, Stufe AA) erfordert dieses Markup.

Der Editor mit den ausgewählten Wörtern „bonjour tout le monde“ und geöffnetem Menü „Sprache“ listet „Sprache entfernen“ auf, dann „Arabisch ar“, „Chinesisch (vereinfacht)“ zh-Hans, „Chinesisch (traditionell)“ zh-Hant, „Tschechisch cs“, „Niederländisch nl“, „Englisch en“, „Französisch fr“ mit Tastaturfokus, „Deutsch de“ und „Griechisch el“.
Das Sprachmenü wurde für eine ausgewählte Phrase geöffnet. Der Fokus der Pfeiltasten wurde auf Französisch verschoben.
Zwei Sätze im Herausgeber; Die Phrase „bonjour tout le monde“ und das hebräische Wort „shalom“ sind mit einer gepunkteten Linie unterstrichen
Markierte Phrasen werden beim Bearbeiten punktiert unterstrichen. Die Unterstreichung ist nicht Teil des gespeicherten HTML.

Schalten Sie es ein

Die Funktion ist dietextpartlanguage.jsPlugin (auch inplugins/all_plugins.js). Das Symbolleistenelement isttextpartlanguage ( "Language"), eine Menütaste. Es ist in derfullUndofficeSymbolleisten; Fügen Sie es für Ihre eigene Symbolleiste der Zeichenfolge hinzu:

<link rel="stylesheet" href="/richtexteditor/rte_theme_default.css">
<script src="/richtexteditor/rte.js"></script>
<script src="/richtexteditor/plugins/textpartlanguage.js"></script>

<div id="editor"><p>The French say bonjour tout le monde when they greet a room.</p></div>
<script>
var editor = new RichTextEditor("#editor", { toolbar_default: "{bold,italic}|{textpartlanguage}" });
</script>

Optionen

OptionStandardWas es bewirkt
textPartLanguages24 Sprachen: ar, zh-Hans, zh-Hant, cs, nl, en, fr, de, el, he, hi, it, ja, ko, fa, pl, pt, ru, es, sv, tr, uk, ur, viDas Menü. Jeder Eintrag ist{ code, label, dir }; Satzdir: "rtl"für Sprachen mit Schreibrichtung von rechts nach links (die Standardeinstellungen gelten für Arabisch, Hebräisch, Persisch und Urdu).
textPartLanguageHighlighttrueGepunktete Unterstreichung markierter Phrasen im Bearbeitungsbereich. Nur für Herausgeber;falseschaltet es aus.
text_textpartlanguage, text_removelanguage "Language" , "Remove language" Schaltflächenbeschriftung und die erste Menüzeile.

Eine kürzere Liste mit Regionalcode:

textPartLanguages: [
  { code: "en", label: "English" },
  { code: "fr-CA", label: "French (Canada)" },
  { code: "ar", label: "Arabic", dir: "rtl" }
]

Wenn ein Sprachpaket geladen ist, werden die integrierten Einträge in der Sprache dieses Pakets benannt (durchIntl.DisplayNames); AlabelDie von Ihnen selbst eingestellte Einstellung wird wie geschrieben angezeigt.

Benutze es

  • Wählen Sie den Text aus, öffnen Sie „Sprache“ und wählen Sie eine Sprache aus. Wenn Sie die Sprache auswählen, die bereits in der Auswahl enthalten ist, wird diese wieder entfernt.
  • Wenn sich die Einfügemarke innerhalb einer markierten Phrase befindet (keine Auswahl), ändert die Auswahl einer anderen Sprache diese Phrase und"Remove language"packt es aus. Ein Caretzeichen außerhalb einer markierten Phrase bewirkt nichts: Das Plugin erstellt niemals einen leeren Bereich.
  • Eine Auswahl über mehrere Absätze, Listenelemente oder Tabellenzellen wird Block für Block markiert, jeweils ein Bereich, sodass die Blöcke nicht geteilt werden.
  • Tastatur: Wenn das Menü geöffnet wird, wechselt der Fokus auf die aktuelle Sprache oder auf"Remove language". Pfeil-nach-oben und Pfeil-nach-unten bewegen und umbrechen, Pos1 und Ende springen zu den Enden, Eingabetaste oder Leertaste wählen aus und Escape schließt das Menü und setzt den Fokus wieder auf den Bearbeitungsbereich. Jede Zeile hatrole="menuitemradio"Undaria-checked.
  • Mit „Rückgängig“ wird eine festgelegte Sprache in einem Schritt aus dem Menü oder der API entfernt.

API für Ihre eigene Benutzeroberfläche:

VerfahrenWas es bewirkt
editor.setTextLanguage("fr")Markiert die Auswahl, wie das Menü auch.
editor.removeTextLanguage()Entfernt die Sprache an der Einfügemarke oder in der Auswahl.
editor.getTextLanguage()Die Sprache am Caretzeichen, z.B."fr", odernull.
editor.getMarkedLanguages()Jede im Dokument verwendete Sprache, z.B.[{"code":"fr","label":"French"},{"code":"he","label":"Hebrew"}].
editor.listTextLanguages()Eine Kopie der Menüliste.

Wissenswertes

Der gespeicherte HTML-Code ist ein einfacher Bereich ohne Klasse und hängt daher nicht von einem Stylesheet ab. Von rechts nach links geschriebene Sprachen erhalten auch dir="rtl", da lang allein die Richtung nicht ändert. Aus dem oben gezeigten Lauf:

<p>The French say <span lang="fr">bonjour tout le monde</span> when they greet a room.</p>
<p>The Hebrew word shalom is written <span lang="he" dir="rtl">שלום</span>.</p>
  • Desinfektionsmittel müssen lang und dir auf span behalten. Wenn Ihr Server sie entfernt, verliert das Dokument stillschweigend sein Sprachmarkup.
  • Die Sprache des gesamten Dokuments ist eine separate Einstellung (der lang der Seite, die den Inhalt anzeigt). Dieses Plugin markiert nur die Teile, die davon abweichen.
  • Verwenden Sie setTextLanguage() aus dem Code, nicht execCommand("textpartlanguage", "de"): In 2.6.12 erreicht der Wert das Plugin nicht, sodass dieser Aufruf die Sprache entfernt, anstatt sie festzulegen.
  • Markierte Bereiche innerhalb einer neuen Auswahl werden zuerst entpackt, sodass eine Phrase niemals mit zwei verschachtelten Sprachen endet.
  • Im Vorschlagsmodus (Änderungen verfolgen) kann die Sprache nicht geändert werden: Die Änderung kann noch nicht verfolgt werden, daher lehnt das Plugin sie mit einer Meldung ab.

Verwandt: Erklärung zur Barrierefreiheit, Barrierefreiheitsprüfung, Rechts-nach-links-Schnittstelle, Demo zu Barrierefreiheit und Sprachen.