Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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 = newHeight

rect.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

Zdroje