← Toda la documentación

editor.getSelectedControl()

Devuelve el elemento de control seleccionado: normalmente una imagen en la que el usuario ha hecho clic, que se muestra con controladores de redimensionamiento. Devuelve null cuando la selección es texto normal o un cursor. Úsalo para crear acciones contextuales para un objeto seleccionado, como un botón “editar imagen” o “definir texto alternativo”.

Sintaxis

editor.getSelectedControl()

Parámetros

Ninguno.

Valor devuelto

El elemento de control seleccionado, o null si no hay ningún control seleccionado.

Notas de comportamiento

  • La selección de un control es distinta de la selección de texto. Al hacer clic en una imagen, se selecciona como control; arrastrar sobre unas palabras crea un rango de texto. Solo lo primero hace que getSelectedControl() devuelva un elemento.
  • Devuelve null para un cursor o un rango de texto. Comprueba si es null antes de usar el resultado.
  • Determina el comportamiento específico de cada objeto. El propio editor comprueba el control seleccionado en operaciones como delete(), que elimina la imagen seleccionada en lugar de texto.

Ejemplo de uso

Activa una acción “editar imagen” solo cuando haya una imagen seleccionada:

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

Lee la URL de origen de la imagen seleccionada:

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

Relacionado