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.