← Gesamte Dokumentation

editor.getSelectedControl()

Gibt das gerade ausgewählte Steuerelement zurück – typischerweise ein Bild, auf das der Benutzer geklickt hat und das mit Ziehpunkten zur Größenänderung angezeigt wird. Ist die Auswahl gewöhnlicher Text oder ein Cursor, gibt die Methode null zurück. Damit bauen Sie Kontextaktionen für ein ausgewähltes Objekt, etwa eine Schaltfläche „Bild bearbeiten“ oder „Alt-Text setzen“.

Syntax

editor.getSelectedControl()

Parameter

Keine.

Rückgabewert

Das ausgewählte Steuerelement oder null, wenn kein Steuerelement ausgewählt ist.

Hinweise zum Verhalten

  • Die Auswahl eines Steuerelements ist etwas anderes als eine Textauswahl. Ein Klick auf ein Bild wählt es als Steuerelement aus; das Ziehen über Wörter ergibt einen Textbereich. Nur im ersten Fall gibt getSelectedControl() ein Element zurück.
  • Gibt null bei einem Cursor oder Textbereich zurück. Prüfen Sie auf null, bevor Sie das Ergebnis verwenden.
  • Davon hängt objektspezifisches Verhalten ab. Der Editor selbst prüft das ausgewählte Steuerelement bei Operationen wie delete(), das dann das ausgewählte Bild statt Text entfernt.

Anwendungsbeispiel

Eine Aktion „Bild bearbeiten“ nur aktivieren, wenn ein Bild ausgewählt ist:

var editor1 = new RichTextEditor("#div_editor1");
var control = editor1.getSelectedControl();
if (control && control.tagName === "IMG") {
    openImageOptions(control);   // e.g. resize, alt text, replace
}

Die Quell-URL des gerade ausgewählten Bildes lesen:

var control = editor1.getSelectedControl();
var src = control && control.tagName === "IMG" ? control.src : null;

Siehe auch