CKTIS / JavaScript
DOMRect: vlastnosti width a height
Přečti šířku a výšku obdélníku, interpretuj zlomkové a záporné hodnoty a rozlišuj naměřené rozměry prvku od jeho rozměrů nastavených v CSS.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
rect.width
rect.height
rect.width = newWidth
rect.height = newHeightrect.width a rect.height jsou číselné vlastnosti instance: udávají šířku a výšku, nikoli souřadnice polohy. Čti je bez závorek. V objektu DOMRect je lze měnit, zatímco v DOMRectReadOnly jsou jen pro čtení.
Rozměry nemusí být celočíselné. U obdélníku, který vytvoříš, mohou být i záporné. Je-li width záporná, left je x + width; jinak je left rovna x. Je-li height záporná, top je y + height; jinak je top rovna y. Záporné znaménko mění směr od bodu (x, y), ne absolutní velikost rozměru.
element.getBoundingClientRect() vrací obdélník obepínající neprázdné boxy prvku po jejich vnější hranu ohraničení, tedy včetně vnitřních odsazení (padding) a ohraničení, ale bez vnějších okrajů (margin). Pokud existují neprázdné boxy, prázdné se ignorují. Jsou-li všechny boxy prázdné, metoda vrátí obdélník s nulovou šířkou a výškou v počátku prvního boxu. Rozměry jsou v CSS pixelech a zohledňují CSS transformace. Nemusejí se tedy shodovat s hodnotami width a height prvku v CSS. Změna vráceného objektu nezmění prvek. Pro nové měření zavolej metodu znovu.
DOMRect je webové API, nikoli součást ECMAScriptu 2024. Jeho dostupnost závisí na běhovém prostředí.
Příklady
{
const x = 10, y = 20, width = -30.5, height = 12.25;
// Without native DOMRect, model only the geometry used in this example.
const rect = typeof globalThis.DOMRect === "function"
? new globalThis.DOMRect(x, y, width, height)
: {
x, y, width, height,
get left() {
return this.width < 0 ? this.x + this.width : this.x;
},
};
console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
rect.width = 30.5;
console.log(`width=${rect.width}, height=${rect.height}, left=${rect.left}`);
}Výsledek
width=-30.5, height=12.25, left=-20.5 width=30.5, height=12.25, left=10
Spusť kód v konzoli prohlížeče, abys použil vestavěný `DOMRect`. V Node.js bez `DOMRect` používá příklad zjednodušený geometrický model. Změnou znaménka `width` se `left` posune z `-20.5` na `10`; `height` zůstane stejná.
Související lekce
- JavaScript · Lekce 35 · Středně pokročilá · Verze: 3