← Toda la documentación

editor.getSelection()

Devuelve el objeto de selección real del editor: la selección dentro del área de edición, no el window.getSelection() de la página exterior. Úsalo para examinar lo que está seleccionado, leer rangos o implementar lógica de selección de bajo nivel en comandos personalizados.

Sintaxis

editor.getSelection()

Parámetros

Ninguno.

Valor devuelto

El objeto de selección del editor.

Notas de comportamiento

  • Limitado al iframe de edición. Es la selección dentro del contenido del editor, así que sus rangos apuntan a nodos de editor.getDocument(), no de la página que lo rodea.
  • Es la selección real. Léela en el momento en que la necesites; refleja dónde estén en ese momento el cursor o el resaltado.
  • Para las necesidades habituales hay funciones de más alto nivel. Usa getSelectedText() para el texto y getSelectionElement() para el elemento contenedor en lugar de recorrer la selección a mano.

Ejemplo de uso

Comprueba si hay algo seleccionado:

var editor1 = new RichTextEditor("#div_editor1");
var sel = editor1.getSelection();
if (sel && !sel.isCollapsed) {
    // there is a highlighted range to act on
}

Lee el rango actual de la selección:

var sel = editor1.getSelection();
if (sel && sel.rangeCount) {
    var range = sel.getRangeAt(0);
    console.log(range.toString());
}

Relacionado