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

CKTIS / JavaScript

DOMRect: свойства width и height

Прочети ширината и височината на правоъгълник, разбери дробните и отрицателните стойности и различавай измерените размери на елемент от зададените в CSS.

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

Синтаксис

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

rect.width и rect.height са числови свойства на обекта: означават съответно ширина и височина, а не координати на позицията. Чети ги без скоби. В DOMRect могат да се променят, а в DOMRectReadOnly са само за четене.

Размерите могат да са дробни. При правоъгълник, който създаваш сам, могат да са и отрицателни. Ако width е отрицателна, left е x + width; иначе е x. Ако height е отрицателна, top е y + height; иначе е y. Отрицателният знак променя посоката от точката (x, y), а не абсолютната големина на размера.

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

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

Примери

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

Резултат

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

Изпълни кода в конзолата на браузър, за да използваш вградения `DOMRect`. В Node.js без `DOMRect` примерът използва опростен геометричен модел. Промяната на знака на `width` премества `left` от `-20.5` на `10`; `height` остава непроменена.

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

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

Източници