Selection

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since March 2017.

Introducción

Selección es la clase de objeto devuelto por window.getSelection() y otros métodos.

Un objeto de selección representa los rangos que el usuario ha seleccionado. Suele llevar un sólo rango, accesado como sigue:

range = sel.getRangeAt(0);

Llamar al método toString() devuelve el texto contenido en la selección, ej:

selObj = window.getSelection();
window.alert(selObj.toString());

Glosario

Otros términos claves usados en esta parte.

anchor

El ancla de una selección es el punto inicial de ésta. Cuando se hace una selección con el ratón, el ancla es el punto donde se presionó por primera vez el botón del ratón. Cuando el usuario mueve la selección utilizando el ratón o el teclado, el ancla no se mueve.

focus

El foco de una selección es el punto último de ésta. Cuando se hace la selección con el ratón, el foco es el punto donde se suelta el botón del ratón. Cuando el usuario mueve la selección utilizando el "mouse" o el teclado, el foco es el final de la selección que el usuario está moviendo.

range

Un rango es una parte contigua de un documento. Un rango puede contener un nodo entero así como porciones de nodos, por ejemplo una parte de un nodo de texto. Normalmente un usuario seleccionará únicamente un solo rango a la vez, pero también le es posible seleccionar múltiples rangos (por ejemplo, utilizando la tecla controlCtrl ). Un rango puede ser recuperado de una selección como un objeto de rango. Los objetos de rango también pueden ser creados vía el DOM y programadamente adheridos o removidos de una selección.

Propiedades

anchorNode

Devuelve el nodo en el cual empieza la selección.

anchorOffset

Devuelve el número de caracteres en que el ancla de la selección es colocada dentro de anchorNode.

focusNode

Devuelve el nodo en el cual acaba la selección.

focusOffset

Devuelve el número de caracteres en que el foco de la selección es colocado dentro de focusNode.

isCollapsed

Devuelve un valor boleano verdadero si los puntos de inicio y fin de la selección están en la misma posición.

rangeCount

Devuelve el número de los rangos que hay en la selección.

Métodos

getRangeAt

Devuelve un objeto de rango representando uno de los rangos seleccionados.

collapse

Pliega la selección a un simple punto.

extend

Traslada el foco de la selección a un punto especificado.

collapseToStart

Traslada el foco de la selección al mismo punto que el ancla.

collapseToEnd

Traslada el ancla hasta el mismo punto del foco. El foco no se mueve.

selectAllChildren

Añadirá todos los "hijos" del nodo especificado a la selección.

addRange

Añade un objeto de rango a la selección.

removeRange

Quita un rango de la selección.

removeAllRanges

Quita todos los rangos de la selección.

deleteFromDocument

Elimina del documento el contenido de la selección.

selectionLanguageChange

NO IMPLEMENTADA, Cambia la direccion de la seleccion de Izquierda a Derecha a Derecha a Izquierda

toString

Devuelve una cadena de caracteres (texto), la cual es representada por el objeto de selección, es decir, el texto seleccionado.

containsNode

Indica si tal nodo es parte de la selección.

Ver también

Enlaces externos