CKTIS / JavaScript
Range: skupni vsebnik, odmiki in skrčeni obseg
Preberi meji obsega v DOM-u, poišči njuno najbližje skupno vozlišče in preveri, ali obe meji označujeta isto točko.
Različica: Current web platform; runtime support varies
Sintaksa
range.commonAncestorContainer
range.startOffset
range.endOffset
range.collapsedRange je vmesnik DOM-a, ne del ECMAScripta 2024. Razpoložljivost teh lastnosti je odvisna od implementacije DOM-a v izvajalnem okolju, ne od izdaje ECMAScripta. Ne predpostavljaj, da so na voljo v okolju brez DOM-a. Vsako mejo določa par: vozlišče in odmik. startOffset beri skupaj s startContainer, endOffset pa skupaj z endContainer.
Odmik je položaj, štet od nič, in ne indeks zadnjega vključenega znaka. V vozlišču CharacterData, kot je Text, šteje kodne enote UTF-16 pred mejo, ne znakov, kot jih zazna uporabnik. V vsebniku, kot je Element, šteje neposredna podrejena vozlišča pred mejo, vključno z besedilom in komentarji, tako kot childNodes. 0 je pred prvo enoto ali prvim podrejenim vozliščem; polna dolžina označuje položaj za zadnjim.
commonAncestorContainer vrne najgloblje vozlišče, ki je za vsak mejni vsebnik bodisi vsebnik sam bodisi njegov prednik. Če sta oba vsebnika isto vozlišče, vrne to vozlišče, tudi če je Text. collapsed je true le, če imata obe meji isto vozlišče in isti odmik. Enaka odmika v različnih vozliščih ne zadoščata.
Vse štiri lastnosti primerka so samo za branje; startOffset, endOffset in collapsed so podedovane iz AbstractRange. Meji premakni z setStart() in setEnd(). collapse(true) skrči obseg na začetno točko; collapse(false) ali collapse() ga skrči na končno točko. Range je živ: spremembe v DOM-u lahko prilagodijo njegovi meji.
Primeri
<!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>Rezultat
[true,3,1,false,"B"] [true,3,3,true,""]
Primer shrani kot datoteko HTML, odpri jo v brskalniku in preveri izpis v konzoli. Odmik `3` v besedilnem vozlišču je takoj za emodžijem, ki zasede dve kodni enoti UTF-16. Odmik `1` v elementu je za njegovim edinim podrejenim vozliščem. Obseg zato vsebuje `B`. Po `collapse(true)` sta obe meji pri odmiku `3` v besedilnem vozlišču, ki je zdaj skupni vsebnik.
Povezane lekcije
- JavaScript · Lekcija 33 · Srednja · Različica: 3