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

CKTIS / JavaScript

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

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

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

rect.width
rect.width = value

DOMRect.width описва ширината на правоъгълника, представен от обект DOMRect. Това е свойство на екземпляр: прочетете го чрез rect.width и го променете чрез rect.width = value. Типът му в Web IDL е unrestricted double, представен в JavaScript като number. Стойността не е задължително да е цяло или положително число; този тип допуска и NaN, Infinity и -Infinity.

Конструкторът new DOMRect(x, y, width, height) приема ширината като трети аргумент. Отрицателната ширина не се преобразува автоматично в положителна стойност. Когато x и width са крайни и width е отрицателна, left е x + width, а right е x. Това опростено правило невинаги важи за безкрайни стойности: при x = Infinity и width = -Infinity сумата x + width е NaN, затова изчисляването на максимума за right връща NaN, а не x.

При точна аритметика с крайни стойности на x и width и отрицателна стойност на width разликата right - left би била равна на абсолютната стойност на width, но закръглянето при изчисления с плаваща запетая в JavaScript може да промени резултата. Например при x = 1e20 и width = -8 сумата x + width се закръгля до x, така че right - left е 0, а не 8.

DOMRect наследява от DOMRectReadOnly, но позволява записване в width. Какво представя правоъгълникът зависи от API, който го е върнал; само свойството не уточнява какъв вид област се измерва.

Това е функция на Web API, описана в Geometry Interfaces Module Level 1, а не функция на конкретно издание на ECMAScript. MDN я отбелязва като широко достъпна в браузърите от януари 2020 г., включително в Web Workers. Примерът използва изрично зададени координати, затова не зависи от оформлението на страницата.

Примери

const rect = new DOMRect(10, 20, 30.5, 40);
console.log(rect.width);

rect.width = -8;
console.log(rect.width);
console.log(rect.left, rect.right);

Резултат

30.5
-8
2 10

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници