CKTIS / JavaScript
DOMRectReadOnly.width — šírka obdĺžnika
Vlastnosť `width` je iba na čítanie a vracia uloženú šírku obdĺžnika ako číslo so zachovaným znamienkom aj prípadnou desatinnou časťou.
Verzia: ECMAScript 2024 and the current web platform; runtime support varies
Syntax
rect.widthDOMRectReadOnly.width je vlastnosť inštancie určená iba na čítanie. Číta sa zápisom rect.width bez zátvoriek a vracia hodnotu typu number. Jednotku určuje API, ktoré obdĺžnik poskytlo. Napríklad pri prvku HTML udáva entry.contentRect.width objektu ResizeObserverEntry šírku oblasti obsahu v pixeloch CSS.
Keď obdĺžnik vytváraš priamo, hodnotu width určuje tretí argument konštruktora DOMRectReadOnly. Záporná šírka zostáva záporná: pri konečných súradniciach a zápornej šírke sa left rovná x + width a right sa rovná x. Na získanie nezáporného vodorovného rozmeru obdĺžnika s konečnou šírkou použi Math.abs(rect.width).
Priradenie do width inštanciu DOMRectReadOnly nezmení: v striktnom režime vyvolá výnimku TypeError, inak sa ignoruje. Ak potrebuješ inú šírku, vytvor nový obdĺžnik alebo použi zapisovateľnú vlastnosť width objektu DOMRect. DOMRectReadOnly je webové API, nie súčasť ECMAScriptu; over jeho dostupnosť v cieľovom prostredí.
Prí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ýsledok
width=-4.5, left=5.5, right=10 TypeError=true, width=-4.5
Ak chceš použiť natívne API, spusť kód v konzole prehliadača, ktorý podporuje `DOMRectReadOnly`. Ak `DOMRectReadOnly` nie je k dispozícii, ako v Node.js, príklad použije lokálnu náhradu, ktorá napodobňuje iba `width`, `left` a `right`. Záporná šírka zostane `-4.5` a priradenie v striktnom režime vyvolá výnimku `TypeError`, ktorú príklad zachytí.
Súvisiace lekcie
- JavaScript · Lekcia 32 · Stredne pokročilá · Verzia: 3