Znalostná bázaCentrum skúšok
SKSlovenčina
Vybrať jazyk13

CKTIS / JavaScript

DOMRect: vlastnosti width a height

Prečítaj šírku a výšku obdĺžnika, interpretuj zlomkové a záporné hodnoty a odlíš namerané rozmery prvku od jeho rozmerov nastavených v CSS.

Verzia: ECMAScript 2024 and the current web platform; runtime support varies

Syntax

rect.width
rect.height
rect.width = newWidth
rect.height = newHeight

rect.width a rect.height sú číselné vlastnosti inštancie: označujú šírku a výšku, nie súradnice polohy. Čítaj ich bez zátvoriek. V objekte DOMRect sa dajú meniť, kým v DOMRectReadOnly sú len na čítanie.

Rozmery nemusia byť celé čísla. Pri obdĺžniku, ktorý vytvoríš, môžu byť aj záporné. Ak je width záporná, left má hodnotu x + width; inak má hodnotu x. Ak je height záporná, top má hodnotu y + height; inak má hodnotu y. Záporné znamienko mení smer od bodu (x, y), nie absolútnu veľkosť rozmeru.

element.getBoundingClientRect() vráti obdĺžnik, ktorý obopína neprázdne boxy prvku po vonkajšiu hranu ich orámovania, teda vrátane vnútorných odsadení (padding) a orámovania, no bez vonkajších okrajov (margin). Ak existujú neprázdne boxy, prázdne sa ignorujú. Ak sú všetky boxy prázdne, metóda vráti obdĺžnik s nulovou šírkou a výškou v počiatku prvého boxu. Rozmery sú v pixeloch CSS a zohľadňujú transformácie CSS. Nemusia sa teda zhodovať s hodnotami width a height prvku v CSS. Zmena vráteného objektu nezmení prvok. Ak chceš získať nové meranie, zavolaj metódu znova.

DOMRect je webové API, nie súčasť ECMAScriptu 2024. Dostupnosť závisí od prostredia, v ktorom kód beží.

Prí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ýsledok

width=-30.5, height=12.25, left=-20.5
width=30.5, height=12.25, left=10

Spusť kód v konzole prehliadača, aby si použil vstavaný `DOMRect`. V Node.js bez `DOMRect` používa príklad zjednodušený geometrický model. Zmena znamienka `width` posunie `left` z `-20.5` na `10`; `height` sa nezmení.

Súvisiace lekcie

  • JavaScript · Lekcia 35 · Stredne pokročilá · Verzia: 3

Zdroje