← Toda la documentación

editor.getSelectedText()

Devuelve el contenido en texto sin formato de la selección actual: el texto que el usuario ha resaltado, sin el formato. Úsalo para recuentos de palabras, búsquedas, acciones del tipo “buscar esta frase en la web” o cualquier cosa que necesite el texto seleccionado y no su marcado.

Sintaxis

editor.getSelectedText()

Parámetros

Ninguno.

Valor devuelto

El texto seleccionado como cadena, o null cuando la selección está contraída (un cursor sin nada resaltado).

Notas de comportamiento

  • Una selección contraída devuelve null. Con solo un cursor y ningún texto resaltado, getSelectedText() devuelve null; compruébalo antes de usar el resultado.
  • Texto sin formato, no HTML. El resultado es solo el texto; usa getHTMLCode() o el rango de la selección si necesitas el contenido con marcado.
  • Refleja la selección real, así que léelo en el momento en que lo necesites (por ejemplo, dentro del controlador de clic de un botón de la barra de herramientas).

Ejemplo de uso

Actúa sobre el texto resaltado, protegiéndote de una selección vacía:

var editor1 = new RichTextEditor("#div_editor1");
var text = editor1.getSelectedText();
if (text) {
    window.open("https://www.google.com/search?q=" + encodeURIComponent(text));
}

Muestra un recuento de caracteres en vivo de la selección actual:

var text = editor1.getSelectedText() || "";
console.log(text.length + " characters selected");

Relacionado