CKTIS / JavaScript
Range — un intervallo vivo nell’albero DOM
Range descrive un frammento del DOM compreso tra due limiti. Consente di estrarre, eliminare e inserire contenuto, mentre i suoi limiti reagiscono automaticamente alle modifiche dell’albero.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
const range = document.createRange();
range.setStart(node, startOffset);
range.setEnd(node, endOffset);
range.extractContents();
range.insertNode(node);Range è un intervallo vivo definito da due coppie nodo-offset. Si crea con document.createRange() o new Range(). È una Web API dello standard DOM, non una funzionalità di una specifica edizione di ECMAScript; la presenza di Node 24 in un repository non dimostra che sia disponibile. L’esempio richiede un DOM del browser.
Range.startOffset e Range.endOffset contano unità di codice UTF-16 in CharacterData, ma negli elementi contano i nodi figli, non i caratteri. Range.commonAncestorContainer restituisce il nodo condiviso più profondo che contiene entrambi i limiti; può essere il nodo di testo stesso. Range.collapsed significa che i limiti sono identici, non semplicemente che il testo è vuoto.
Range.extractContents() rimuove il contenuto e restituisce un DocumentFragment: i nodi interamente contenuti vengono spostati, mentre le strutture contenute solo in parte vengono copiate quando necessario. Range.deleteContents() rimuove il contenuto senza restituire un frammento. Entrambe le operazioni fanno collassare l’intervallo. Range.insertNode(node) inserisce all’inizio invece di sostituire il contenuto; può dividere un nodo di testo ed espandere un intervallo collassato.
Range.setStartAfter(node) imposta l’inizio dopo il nodo nel suo genitore; il nodo deve avere un genitore. Range.collapse(true) fa collassare l’intervallo all’inizio, mentre Range.collapse(false) o Range.collapse() lo fa collassare alla fine. Range.cloneRange() crea un intervallo vivo separato con gli stessi limiti, non una copia del DOM né un’istantanea immutabile: modifiche successive possono influire su entrambi gli intervalli.
Esempi
(() => {
const host = document.createElement('div');
host.textContent = 'ABCDE';
const range = document.createRange();
range.setStart(host.firstChild, 1);
range.setEnd(host.firstChild, 4);
console.log(range.commonAncestorContainer === host.firstChild);
console.log(range.startOffset, range.endOffset, range.collapsed);
const copy = range.cloneRange();
copy.collapse(true);
console.log(copy.collapsed, range.collapsed);
const fragment = range.extractContents();
console.log(fragment.textContent, host.textContent, range.collapsed);
const mark = document.createElement('mark');
mark.appendChild(fragment);
range.insertNode(mark);
range.setStartAfter(mark);
range.collapse(true);
console.log(host.textContent, range.startOffset, range.endOffset);
range.selectNode(mark);
range.deleteContents();
console.log(host.textContent, range.collapsed);
})();Risultato
true 1 4 false true false BCD AE true ABCDE 2 2 AE true
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.