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

CKTIS / JavaScript

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

`top` udává polohu horního okraje obdélníku, zatímco `height` udává jeho výšku se znaménkem. Jde o dva různé údaje, ať už obdélník vytváříš, nebo měříš prvek.

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

Syntaxe

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

rect.top a rect.height jsou vlastnosti instance, nikoli metody. top je svislá souřadnice horního okraje. height je výška se znaménkem, nikoli souřadnice. Obě hodnoty jsou čísla a mohou mít desetinnou část.

Pro konečné hodnoty y a height se top rovná y + height, pokud height < 0, jinak se rovná y. Záporná výška ručně vytvořeného obdélníku zůstává záporná; nepřevádí se na absolutní hodnotu. U DOMRect můžeš přiřadit hodnotu do height a při čtení top se změna zohlední. top je v obou rozhraních jen pro čtení; v DOMRectReadOnly je jen pro čtení také height.

Ve výsledku element.getBoundingClientRect() jsou obě hodnoty v pixelech CSS. top se měří od horního okraje zobrazovací oblasti a může být záporná, pokud je horní okraj obdélníku nad ním. height je nezáporná výška ohraničujícího obdélníku, která zahrnuje vnitřní odsazení (padding) a rámečky, nejen obsah. Výsledek se neaktualizuje automaticky: po posunutí zobrazení nebo změně rozvržení zavolej metodu znovu, abys získal aktuální měření. Úprava vráceného obdélníku prvek nezmění.

DOMRect je webové API, není součástí ECMAScriptu 2024. Nepředpokládej, že je k dispozici v každém běhovém prostředí JavaScriptu.

Pří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ýsledek

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

Příklad nepotřebuje žádný prvek stránky. `y` zůstává `20`, ale po přiřazení `height = -8` je horní okraj na souřadnici `12`.

Související lekce

  • JavaScript · Lekce 34 · Středně pokročilá · Verze: 3

Zdroje