CKTIS / JavaScript
DOMRectReadOnly.width — šířka obdélníku
Vlastnost `width` je pouze pro čtení a vrací uloženou šířku obdélníku jako číslo se zachovaným znaménkem i případnou desetinnou částí.
Verze: ECMAScript 2024 and the current web platform; runtime support varies
Syntaxe
rect.widthDOMRectReadOnly.width je vlastnost instance určená jen pro čtení. Čte se zápisem rect.width bez závorek a vrací hodnotu typu number. Jednotku určuje API, které obdélník poskytlo. Například u prvku HTML udává entry.contentRect.width objektu ResizeObserverEntry šířku oblasti obsahu v CSS pixelech.
Když obdélník vytváříš přímo, hodnotu width určuje třetí argument konstruktoru DOMRectReadOnly. Záporná šířka zůstává záporná: při konečných souřadnicích a záporné šířce platí, že left je x + width a right je x. Pro nezáporný vodorovný rozměr obdélníku s konečnou šířkou použij Math.abs(rect.width).
Přiřazení do width instanci DOMRectReadOnly nezmění: v přísném režimu vyvolá výjimku TypeError, jinak se ignoruje. Pokud potřebuješ jinou šířku, vytvoř nový obdélník nebo použij zapisovatelnou vlastnost width objektu DOMRect. DOMRectReadOnly patří mezi webová API, nikoli do ECMAScriptu; ověř jeho dostupnost v cílovém prostředí.
Příklady
(() => {
"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}`);
}
})();Výsledek
width=-4.5, left=5.5, right=10 TypeError=true, width=-4.5
Spusť kód v konzoli prohlížeče, který podporuje `DOMRectReadOnly`, abys použil nativní API. Pokud `DOMRectReadOnly` není k dispozici, jako v Node.js, příklad používá místní náhradu, která napodobuje jen `width`, `left` a `right`. Záporná šířka zůstane `-4.5` a přiřazení v přísném režimu vyvolá výjimku `TypeError`, kterou příklad zachytí.
Související lekce
- JavaScript · Lekce 32 · Středně pokročilá · Verze: 3