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 = valueDOMRect.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
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.