CKTIS / JavaScript
Range: contenitore comune, offset e stato compresso
Leggi i punti di confine di un intervallo DOM, trova il loro nodo comune più vicino e verifica se i due confini coincidono.
Versione: Current web platform; runtime support varies
Sintassi
range.commonAncestorContainer
range.startOffset
range.endOffset
range.collapsedRange è un’interfaccia del DOM, non una funzionalità di ECMAScript 2024. La disponibilità di queste proprietà dipende dall’implementazione del DOM nell’ambiente di esecuzione, non dall’edizione di ECMAScript. Non dare per scontato che siano disponibili in un ambiente senza DOM. Ogni punto di confine è una coppia composta da un nodo e un offset. Leggi startOffset insieme a startContainer ed endOffset insieme a endContainer.
Un offset è una posizione a partire da zero, non l’indice dell’ultimo carattere incluso. In un nodo CharacterData come Text, conta le unità di codice UTF-16 prima del confine, non i caratteri percepiti dall’utente. In un contenitore come Element, conta i nodi figli diretti prima del confine, compresi testo e commenti, come in childNodes. 0 precede la prima unità o il primo figlio; la lunghezza totale si trova dopo l’ultimo.
commonAncestorContainer restituisce il nodo più profondo che, per ciascun contenitore di confine, è il contenitore stesso o un suo antenato. Se i due contenitori sono lo stesso nodo, restituisce quel nodo, anche se è un Text. collapsed è true solo se entrambi i confini hanno lo stesso nodo e lo stesso offset. Offset uguali in nodi diversi non bastano.
Tutte e quattro le proprietà di istanza sono di sola lettura; startOffset, endOffset e collapsed sono ereditate da AbstractRange. Usa setStart() e setEnd() per spostare i confini. collapse(true) riduce l’intervallo al punto iniziale; collapse(false) o collapse() lo riduce al punto finale. Un Range è dinamico: le modifiche al DOM possono adeguarne i confini.
Esempi
<!doctype html>
<meta charset="utf-8">
<title>DOM Range boundary points</title>
<script>
{
const container = document.createElement('div');
const text = document.createTextNode('A😀B');
container.appendChild(text);
const range = document.createRange();
range.setStart(text, 3);
range.setEnd(container, 1);
const logRange = (expectedAncestor) => {
console.log(JSON.stringify([
range.commonAncestorContainer === expectedAncestor,
range.startOffset,
range.endOffset,
range.collapsed,
range.toString(),
]));
};
logRange(container);
range.collapse(true);
logRange(text);
}
</script>Risultato
[true,3,1,false,"B"] [true,3,3,true,""]
Salva l’esempio come file HTML, aprilo in un browser e controlla l’output nella console degli strumenti di sviluppo. L’offset `3` nel nodo di testo è subito dopo l’emoji, che occupa due unità di codice UTF-16. L’offset `1` nell’elemento è dopo il suo unico figlio. L’intervallo contiene quindi `B`. Dopo `collapse(true)`, entrambi i confini sono all’offset `3` nel nodo di testo, che diventa il contenitore comune.
Lezioni correlate
- JavaScript · Lezione 33 · Intermedio · Versione: 3