CKTIS / JavaScript
Range: gemeinsamer Vorfahr, Offsets und zusammengeklappter Zustand
Lies die Grenzpunkte eines DOM-Bereichs aus, finde ihren nächsten gemeinsamen Knoten und prüfe, ob beide Grenzen auf denselben Punkt zeigen.
Version: Current web platform; runtime support varies
Syntax
range.commonAncestorContainer
range.startOffset
range.endOffset
range.collapsedRange ist eine DOM-Schnittstelle und kein Teil von ECMAScript 2024. Ob diese Eigenschaften verfügbar sind, hängt von der DOM-Implementierung der Laufzeitumgebung ab, nicht von der ECMAScript-Ausgabe. Setze nicht voraus, dass sie in einer Laufzeitumgebung ohne DOM verfügbar sind. Jeder Grenzpunkt besteht aus einem Knoten und einem Offset. Lies startOffset zusammen mit startContainer und endOffset zusammen mit endContainer.
Ein Offset ist eine nullbasierte Position, nicht der Index des letzten enthaltenen Zeichens. In einem CharacterData-Knoten wie Text zählt er die UTF-16-Codeeinheiten vor der Grenze, nicht die vom Menschen wahrgenommenen Zeichen. In einem Container wie Element zählt er die direkten Kindknoten vor der Grenze, einschließlich Text- und Kommentarknoten, wie bei childNodes. 0 liegt vor der ersten Einheit oder dem ersten Kind; die volle Länge liegt hinter der letzten Einheit oder dem letzten Kind.
commonAncestorContainer liefert den tiefsten Knoten, der für beide Grenzcontainer jeweils der Knoten selbst oder ein Vorfahr ist. Sind beide Container identisch, wird dieser Knoten zurückgegeben, auch wenn er ein Text-Knoten ist. collapsed ist nur dann true, wenn beide Grenzpunkte denselben Knoten und Offset haben. Gleiche Offsets in verschiedenen Knoten reichen nicht aus.
Alle vier Instanzeigenschaften sind schreibgeschützt; startOffset, endOffset und collapsed stammen von AbstractRange. Die Grenzen lassen sich mit setStart() und setEnd() verschieben. collapse(true) klappt den Bereich auf den Anfang zusammen, collapse(false) oder collapse() auf das Ende. Ein Range ist lebend: DOM-Änderungen können seine Grenzen verschieben.
Beispiele
<!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>Ergebnis
[true,3,1,false,"B"] [true,3,3,true,""]
Speichere das Beispiel als HTML-Datei, öffne es im Browser und prüfe die Ausgabe in der Entwicklerkonsole. Offset `3` im Textknoten liegt direkt hinter dem Emoji, das zwei UTF-16-Codeeinheiten belegt. Offset `1` im Element liegt hinter seinem einzigen Kind. Der Bereich enthält daher `B`. Nach `collapse(true)` liegen beide Grenzen bei Offset `3` im Textknoten, der jetzt der gemeinsame Container ist.
Zugehörige Lektionen
- JavaScript · Lektion 33 · Mittlere Stufe · Version: 3