CKTIS / JavaScript
DOMRectReadOnly.width — ширина на правоъгълник
Свойството `width` е само за четене и връща запазената ширина на правоъгълника като число, със същия знак и евентуална дробна част.
Версия: ECMAScript 2024 and the current web platform; runtime support varies
Синтаксис
rect.widthDOMRectReadOnly.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