--- title: Selection slug: Web/API/Selection tags: - DOM - Gecko - Reference_del_DOM_di_Gecko - Tutte_le_categorie translation_of: Web/API/Selection ---

{{ ApiRef() }}

Sommario

E' la classe dell'oggetto restituito da window.getSelection ed altri metodi.

Descrizione

L'oggetto selection rappresenta i range che l'utente ha selezionato. In una selezione fatte dall'utente col mouse possono esserci più range, ad esempio perchè tramite posizionamento assoluto nei CSS due contenitori(DIV) distanti fra di loro nel flusso del documento appaiono vicini sul display e vengono selezionati insieme. Per accedere ai diversi Range che formano una selezione, si usa il metodo getRangeAt().

In JavaScript, l'oggetto selection può venire modificato come se fosse una stringa, ad esempio vi si può concatenare una stringa, perchè in questi casi viene automaticamente applicato il metodo toString. Ad esempio, con il codice seguente, nell'alert apparirà una stringa:

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

ma la variabile selObj rimane un oggetto di tipo selection e non di tipo String, solo che all'occorrenza gli viene applicato il metodo toString().

Glossario

Altre parole chiave usate in questa sezione.

anchor
Rappresenta il punto in cui inizia una selezione. Quando si fa una selezione con il mouse, l'anchor è il punto in cui il mouse è stato premuto e non cambia mentre si muove il mouse.
focus
Rappresenta il punto in cui finisce una selezione. Quando si fa una selezione con il mouse, il focus si muove in corrispondenza del mouse(mentre il tasto è premuto), e quando il tasto viene rilasciato, rappresenta il punto in cui finisce la selezione.
range
Rappresenta un insieme di nodi contigui del documento. Un range può contenere interi nodi come anche porzioni di nodi(nel caso di nodi testuali). Un range può essere recuperato da una selezione attraverso l'oggetto range, oppure può essere creato via script e aggiunto o rimosso da una selezione.

Proprietà

anchorNode
Restituisce il nodo in cui inizia la selezione.
anchorOffset
Restituisce il numero di caratteri fra l'inizio del nodo testuale e l'anchor, all'interno dell'anchorNode.
focusNode
Restituisce il nodo in cui finisce la selezione.
focusOffset
Restituisce il numero di caratteri fra l'inizio del nodo testuale e il focus, all'interno del focusNode.
isCollapsed
Restituisce un valore booleano che indica se l'anchor e il focus di una selezione si trovano nella stessa posizione.
rangeCount
Restituisce il numero di range di cui è composta una selezione.

Metodi

getRangeAt
Restituisce un oggetto range che rappresenta uno dei range attualmente selezionati.
collapse
Collassa la selezione corrente in un singolo punto.
extend
Muove il focus della selezione in uno specifico punto.
collapseToStart
Muove il focus della selezione nel punto in cui c'è l'anchor (che non viene spostata).
collapseToEnd
Muove il focus della selezione nel punto in cui c'è il focus (che non viene spostato).
selectAllChildren
Aggiunge tutti i figli del nodo specificato alla selezione.
addRange
Aggiunge un oggetto range alla selezione..
removeRange
Rimuove un range dalla selezione.
removeAllRanges
Rimuove tutti i range dalla selezione.
deleteFromDocument
Elimina dal documento il contenuto della selezione.
selectionLanguageChange
 
toString
Restituisce una stringa che rappresenta l'oggetto selection (cioè il testo attualmente selezionato).
containsNode
Indica se un certo nodo fa parte dell'oggetto selection.

Guarda anche

window.getSelection, Range

 

{{ languages( { "en": "en/DOM/Selection", "es": "es/DOM/Selection", "pl": "pl/DOM/Selection" } ) }}