База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

DOMRect: горен ръб (`top`) и височина (`height`)

`top` показва къде е горният ръб на правоъгълника, а `height` дава височината му със знак. Двете свойства дават различна информация, независимо дали създаваш правоъгълник, или измерваш елемент.

Версия: ECMAScript 2024 and the current web platform; runtime support varies

Синтаксис

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

rect.top и rect.height са свойства на екземпляра, а не методи. top е вертикалната координата на горния ръб. height е височината със знак, а не координата. И двете стойности са числа и могат да имат дробна част.

При крайни стойности на y и height, top е равно на y + height, ако height < 0, и на y в противен случай. Отрицателната височина на ръчно създаден правоъгълник остава отрицателна: тя не се преобразува в абсолютна стойност. В DOMRect можеш да зададеш стойност на height, а при прочитане на top промяната се отчита. top е само за четене и в двата интерфейса; в DOMRectReadOnly и height е само за четене.

В резултата от element.getBoundingClientRect() и двете стойности са в CSS пиксели. top се измерва спрямо горния край на видимата област и може да е отрицателно, ако горният ръб на правоъгълника е над него. height е неотрицателната височина на обхващащия правоъгълник, която отчита вътрешния отстъп (padding) и рамките, а не само съдържанието. Резултатът не се обновява автоматично: след превъртане или промяна в оформлението извикай метода отново за актуално измерване. Промяната на върнатия правоъгълник не променя елемента.

DOMRect е уеб API, а не част от ECMAScript 2024. Не приемай, че е наличен във всяка среда за изпълнение на JavaScript.

Примери

{
  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}`);
}

Резултат

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

Примерът не изисква елемент от страницата. `y` остава `20`, но след присвояването `height = -8` горният ръб е на координата `12`.

Свързани уроци

  • JavaScript · Урок 34 · Средно · Версия: 3

Източници