---
title: range
slug: Web/API/Range
tags:
  - DOM
  - Gecko
  - Reference_del_DOM_di_Gecko
  - SezioneIncompleta
  - Tutte_le_categorie
translation_of: Web/API/Range
---
<p>{{ ApiRef() }}</p>
<h3 id="Introduzione" name="Introduzione">Introduzione</h3>
<p>L'oggetto <code>Range</code> rappresenta una parte di un documento, che può contenere nodi e parti di nodi testuali del documento dato.</p>
<p>Un range può essere creato usando il metodo <code><a href="it/DOM/document.createRange">createRange</a></code> dell'oggetto <code><a href="it/DOM/document">document</a></code>. Gli oggetti Range possono essere ottenuti anche usando il metodo <code><a href="it/DOM/Selection/getRangeAt">getRangeAt</a></code> dell'oggetto <code><a href="it/DOM/Selection">selection</a></code>.</p>
<h3 id="Propriet.C3.A0" name="Propriet.C3.A0">Proprietà</h3>
<dl>
 <dt>
  <a href="it/DOM/range.collapsed">collapsed</a></dt>
 <dd>
  Restituisce un booleano che indica se i punti d'inizio e di fine del range sono nella stessa posizione.</dd>
 <dt>
  <a href="it/DOM/range.commonAncestorContainer">commonAncestorContainer</a></dt>
 <dd>
  Restituisce il nodo più interno che contiene i nodi startContainer e endContainer.</dd>
 <dt>
  <a href="it/DOM/range.endContainer">endContainer</a></dt>
 <dd>
  Restituisce il nodo nel quale il Range finisce.</dd>
 <dt>
  <a href="it/DOM/range.endOffset">endOffset</a></dt>
 <dd>
  Restituisce un numero che rappresenta il punto preciso in cui il Range finisce, all'interno di endContainer.</dd>
 <dt>
  <a href="it/DOM/range.startContainer">startContainer</a></dt>
 <dd>
  Restituisce il nodo nel quale il Range inizia.</dd>
 <dt>
  <a href="it/DOM/range.startOffset">startOffset</a></dt>
 <dd>
  Restituisce un numero che rappresenta il punto preciso in cui il Range inizia, all'interno di startContainer.</dd>
</dl>
<h3 id="Metodi" name="Metodi">Metodi</h3>
<h4 id="Metodi_di_posizionamento" name="Metodi_di_posizionamento">Metodi di posizionamento</h4>
<p>Questi metodi impostano i punti di inizio e di fine di un range.</p>
<dl>
 <dt>
  <a href="it/DOM/range.setStart">setStart</a></dt>
 <dd>
  Imposta la posizione iniziale di un Range.</dd>
 <dt>
  <a href="it/DOM/range.setEnd">setEnd</a></dt>
 <dd>
  Setta la posizione finale di un Range.</dd>
 <dt>
  <a href="it/DOM/range.setStartBefore">setStartBefore</a></dt>
 <dd>
  Setta la posizione iniziale di un Range nel nodo precedente a quello indicato.</dd>
 <dt>
  <a href="it/DOM/range.setStartAfter">setStartAfter</a></dt>
 <dd>
  Setta la posizione iniziale di un Range nel nodo successivo a quello indicato.</dd>
 <dt>
  <a href="it/DOM/range.setEndBefore">setEndBefore</a></dt>
 <dd>
  Setta la posizione finale di un Range nel nodo precedente a quello indicato.</dd>
 <dt>
  <a href="it/DOM/range.setEndAfter">setEndAfter</a></dt>
 <dd>
  Setta la posizione finale di un Range nel nodo successivo a quello indicato.</dd>
 <dt>
  <a href="it/DOM/range.selectNode">selectNode</a></dt>
 <dd>
  Inserisce all'interno di un Range uno specifico nodo e il suo contenuto.</dd>
 <dt>
  <a href="it/DOM/range.selectNodeContents">selectNodeContents</a></dt>
 <dd>
  Inserisce all'interno di un Range esclusivamente il contenuto di uno specifico nodo.</dd>
 <dt>
  <a href="it/DOM/range.collapse">collapse</a></dt>
 <dd>
  Collassa un Range in uno dei punti estremi.</dd>
</dl>
<h4 id="Metodi_per_modificare_un_Range" name="Metodi_per_modificare_un_Range">Metodi per modificare un Range</h4>
<p>Questi metodi prendono i nodi da un range e ne modificano i contenuti.</p>
<dl>
 <dt>
  <a href="it/DOM/range.cloneContents">cloneContents</a></dt>
 <dd>
  Restituisce un frammento di documento copiando i nodi da un Range.</dd>
 <dt>
  <a href="it/DOM/range.deleteContents">deleteContents</a></dt>
 <dd>
  Rimuove dal documento i contenuti di un Range.</dd>
 <dt>
  <a href="it/DOM/range.extractContents">extractContents</a></dt>
 <dd>
  Muove i contenuti di un Range dall'albero del documento in un frammento del documento.</dd>
 <dt>
  <a href="it/DOM/range.insertNode">insertNode</a></dt>
 <dd>
  Inserisce un nodo all'inizio di un Range.</dd>
 <dt>
  <a href="it/DOM/range.surroundContents">surroundContents</a></dt>
 <dd>
  Muove il contenuto di un Range in un nuovo nodo.</dd>
</dl>
<h4 id="Altri_metodi" name="Altri_metodi">Altri metodi</h4>
<dl>
 <dt>
  <a href="it/DOM/range.compareBoundaryPoints">compareBoundaryPoints</a></dt>
 <dd>
  Compara i punti estremi di due Range.</dd>
 <dt>
  <a href="it/DOM/range.cloneRange">cloneRange</a></dt>
 <dd>
  Restituisce un oggetto Range con i punti estremi identici al Range clonato.</dd>
 <dt>
  <a href="it/DOM/range.detach">detach</a></dt>
 <dd>
  Rilascia un Range dall'uso, per migliorare le performance.</dd>
 <dt>
  <a href="it/DOM/range.toString">toString</a></dt>
 <dd>
  Restituisce il testo di un Range.</dd>
</dl>
<h4 id="Metodi_proprietari_di_Gecko" name="Metodi_proprietari_di_Gecko">Metodi proprietari di Gecko</h4>
<p>Questa sezione descrive metodi di Range implementati in Gecko ma che non fanno parte delle specifiche DOM del W3C.</p>
<dl>
 <dt>
  <a href="it/DOM/range.compareNode">compareNode</a> (obsoleto)</dt>
 <dd>
  Restituisce una costante che rappresenta se il nodo viene prima, dopo o dentro il Range.</dd>
 <dt>
  <a href="it/DOM/range.comparePoint">comparePoint</a></dt>
 <dd>
  Restituisce -1, 0, o 1 per indicare se il punto viene prima, dentro o dopo il range.</dd>
 <dt>
  <a href="it/DOM/range.createContextualFragment">createContextualFragment</a></dt>
 <dd>
  Restituisce un frammento di documento creato a partire da una data stringa di codice.</dd>
 <dt>
  <a href="it/DOM/range.intersectsNode">intersectsNode</a> (obsoleto)</dt>
 <dd>
  Restituisce un booleano che indica se il nodo dato interseca il range.</dd>
 <dt>
  <a href="it/DOM/range.isPointInRange">isPointInRange</a></dt>
 <dd>
  Restituisce un booleano che indica se il punto dato è interno al range.</dd>
</dl>