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

CKTIS / JavaScript

DOMRect: horný okraj (`top`) a výška (`height`)

`top` určuje polohu horného okraja obdĺžnika a `height` udáva jeho výšku so znamienkom. Sú to dva rôzne údaje bez ohľadu na to, či vytváraš obdĺžnik alebo meriaš prvok.

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

Syntax

rect.top
rect.height
new DOMRect(x, y, width, height)
element.getBoundingClientRect()

rect.top a rect.height sú vlastnosti inštancie, nie metódy. top je zvislá súradnica horného okraja. height je výška so znamienkom, nie súradnica. Obe hodnoty sú čísla a môžu mať desatinnú časť.

Pre konečné hodnoty y a height sa top rovná y + height, ak height < 0, inak sa rovná y. Záporná výška ručne vytvoreného obdĺžnika zostáva záporná; neprevedie sa na absolútnu hodnotu. V DOMRect môžeš priradiť hodnotu do height a pri čítaní top sa zmena zohľadní. top je v oboch rozhraniach len na čítanie; v DOMRectReadOnly je len na čítanie aj height.

Vo výsledku element.getBoundingClientRect() sú obe hodnoty v pixeloch CSS. top sa meria od horného okraja zobrazovacej oblasti a môže byť záporná, ak je horný okraj obdĺžnika nad ním. height je nezáporná výška ohraničujúceho obdĺžnika, ktorá zahŕňa vnútorné odsadenie (padding) aj orámovanie, nielen obsah. Výsledok sa neaktualizuje automaticky: po posunutí zobrazenia alebo zmene rozloženia zavolaj metódu znova a získaš aktuálne meranie. Úprava vráteného obdĺžnika prvok nezmení.

DOMRect je webové API, nie súčasť ECMAScriptu 2024. Nepredpokladaj, že je dostupné v každom vykonávacom prostredí JavaScriptu.

Príklady

{
  const y = 20;
  const height = 8;

  // Without DOMRect, model only top and signed height for finite values.
  const rect = typeof DOMRect === "function"
    ? new DOMRect(0, y, 10, height)
    : {
        y,
        height,
        get top() {
          return this.height < 0 ? this.y + this.height : this.y;
        },
      };

  console.log(`top=${rect.top}, height=${rect.height}`);

  rect.height = -8;
  console.log(`top=${rect.top}, height=${rect.height}`);
}

Výsledok

top=20, height=8
top=12, height=-8

Príklad nepotrebuje žiadny prvok stránky. `y` zostáva `20`, ale po priradení `height = -8` je horný okraj na súradnici `12`.

Súvisiace lekcie

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

Zdroje