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

CKTIS / JavaScript

DOMRectReadOnly.width — ширина на правоъгълник

Свойството `width` е само за четене и връща запазената ширина на правоъгълника като число, със същия знак и евентуална дробна част.

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

Синтаксис

rect.width

DOMRectReadOnly.width е свойство на екземпляра, достъпно само за четене. Прочети го с rect.width, без скоби. Резултатът е от тип number. Мерната единица зависи от API, което предоставя правоъгълника. Например за HTML елемент entry.contentRect.width на обект ResizeObserverEntry дава ширината на областта на съдържанието в CSS пиксели.

Когато създаваш правоъгълник, третият аргумент на конструктора DOMRectReadOnly задава width. Отрицателната ширина остава отрицателна: при крайни координати и отрицателна ширина left е равно на x + width, а right е равно на x. За неотрицателния хоризонтален размер на правоъгълник с крайна ширина използвай Math.abs(rect.width).

Присвояването на стойност на width не променя екземпляра на DOMRectReadOnly: в строг режим то предизвиква изключение TypeError, а извън него се пренебрегва. Ако ти трябва друга ширина, създай нов правоъгълник или използвай свойството width на обект DOMRect, което позволява запис. DOMRectReadOnly е уеб API, а не част от ECMAScript; провери дали е налично в целевата среда за изпълнение.

Примери

(() => {
  "use strict";

  // Local fallback for runtimes without the Web API. It models only these three properties.
  function demoReadOnlyRect(x, width) {
    return {
      get width() { return width; },
      get left() { return width < 0 ? x + width : x; },
      get right() { return width < 0 ? x : x + width; },
    };
  }

  const rect = typeof DOMRectReadOnly === "function"
    ? new DOMRectReadOnly(10, 0, -4.5, 3)
    : demoReadOnlyRect(10, -4.5);
  console.log(`width=${rect.width}, left=${rect.left}, right=${rect.right}`);

  try {
    rect.width = 8;
  } catch (error) {
    console.log(`TypeError=${error instanceof TypeError}, width=${rect.width}`);
  }
})();

Резултат

width=-4.5, left=5.5, right=10
TypeError=true, width=-4.5

Изпълни кода в конзолата на браузър с поддръжка на `DOMRectReadOnly`, за да използваш вграденото API. Ако `DOMRectReadOnly` не е наличен, както в Node.js, примерът използва локален модел, който възпроизвежда само `width`, `left` и `right`. Отрицателната ширина остава `-4.5`, а присвояването в строг режим предизвиква изключение `TypeError`, което примерът прихваща.

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

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

Източници