← Gesamte Dokumentation

editor.collapse(bStart)

LĂ€sst die aktuelle Auswahl auf eine einzelne EinfĂŒgemarke zusammenfallen (einen Cursor ohne markierten Text). Verwenden Sie die Methode nach einer Auswahl per Code oder einem Befehl, der auf einen Bereich gewirkt hat, wenn der Cursor an einem Rand der Auswahl stehen soll, statt dass der ganze Bereich markiert bleibt.

Syntax

editor.collapse(bStart)

Parameter

bStart – boolescher Wert. true lĂ€sst die Auswahl auf ihren Anfang zusammenfallen, false auf ihr Ende. Ohne Angabe verhĂ€lt sich die Methode wie bei false (Zusammenfallen auf das Ende).

RĂŒckgabewert

Nichts (undefined).

Hinweise zum Verhalten

  • Bereits zusammengefallene Auswahlen bleiben unverĂ€ndert. Ist die Auswahl schon ein Cursor, kehrt collapse() sofort zurĂŒck, ohne ihn zu verschieben.
  • Ohne aktiven Bereich wird zuerst das Dokument ausgewĂ€hlt. Gibt es ĂŒberhaupt keinen Auswahlbereich (etwa weil der Editor noch keinen Fokus hatte), wĂ€hlt collapse() ersatzweise das gesamte Dokument aus, sodass der Aufruf trotzdem eine klar definierte Auswahl hinterlĂ€sst.
  • Die Methode arbeitet auf der aktuellen Auswahl, derselben, die der Benutzer sieht – es gibt keinen separaten Cursor, der synchron gehalten werden muss.

Anwendungsbeispiel

Einen Befehl auf das gesamte Dokument anwenden und den Cursor dann ans Ende setzen, damit das Tippen dahinter weitergeht:

var editor1 = new RichTextEditor("#div_editor1");
editor1.setHTMLCode("<b>hello world</b>");
editor1.selectDoc();
editor1.execCommand("forecolor", "red");
editor1.collapse(false);   // caret lands after the colored text

Stattdessen auf den Anfang zusammenfallen lassen, um den Cursor vor die Auswahl zu setzen:

editor1.selectDoc();
editor1.collapse(true);    // caret lands at the very beginning

Siehe auch