CKTIS / JavaScript
Range: gemeenschappelijke voorouder, offsets en samengevouwen toestand
Lees de grenspunten van een DOM-bereik, vind hun dichtstbijzijnde gemeenschappelijke knoop en controleer of beide grenzen samenvallen.
Versie: Current web platform; runtime support varies
Syntax
range.commonAncestorContainer
range.startOffset
range.endOffset
range.collapsedRange is een DOM-interface en maakt geen deel uit van ECMAScript 2024. De beschikbaarheid van deze eigenschappen hangt af van de DOM-implementatie van de uitvoeromgeving, niet van de ECMAScript-editie. Ga er niet van uit dat deze eigenschappen beschikbaar zijn in een omgeving zonder DOM. Elk grenspunt bestaat uit een knoop en een offset. Lees startOffset samen met startContainer en endOffset samen met endContainer.
Een offset is een positie vanaf nul, niet de index van het laatste teken in het bereik. In een CharacterData-knoop zoals Text telt de offset de UTF-16-code-eenheden vóór de grens, niet de tekens die de gebruiker waarneemt. In een container zoals Element telt de offset de directe kindknopen vóór de grens, inclusief tekst en commentaar, zoals in childNodes. 0 ligt vóór de eerste eenheid of kindknoop; de volledige lengte ligt na de laatste.
commonAncestorContainer geeft de diepste knoop terug die voor beide grenscontainers de container zelf of een voorouder ervan is. Zijn beide containers dezelfde knoop, dan krijg je die knoop terug, ook als het een Text-knoop is. collapsed is alleen true als beide grenzen dezelfde knoop én dezelfde offset hebben. Gelijke offsets in verschillende knopen zijn niet genoeg.
Alle vier de instantie-eigenschappen zijn alleen-lezen; startOffset, endOffset en collapsed worden geërfd van AbstractRange. Verplaats de grenzen met setStart() en setEnd(). collapse(true) vouwt het bereik samen tot het beginpunt; collapse(false) of collapse() tot het eindpunt. Een Range is dynamisch: wijzigingen in de DOM kunnen de grenzen aanpassen.
Voorbeelden
<!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>Resultaat
[true,3,1,false,"B"] [true,3,3,true,""]
Sla het voorbeeld op als HTML-bestand, open het in een browser en bekijk de uitvoer in de browserconsole. Offset `3` in de tekstknoop ligt direct na de emoji, die twee UTF-16-code-eenheden inneemt. Offset `1` in het element ligt na zijn enige kindknoop. Het bereik bevat dus `B`. Na `collapse(true)` liggen beide grenzen op offset `3` in de tekstknoop, die nu de gemeenschappelijke container is.
Gerelateerde lessen
- JavaScript · Les 33 · Gemiddeld · Versie: 3