CKTIS / JavaScript
DOMRectReadOnly.width — širina pravokutnika
Svojstvo `width` samo je za čitanje i vraća pohranjenu širinu pravokutnika kao broj, uz očuvan predznak i eventualni razlomljeni dio.
Verzija: ECMAScript 2024 and the current web platform; runtime support varies
Sintaksa
rect.widthDOMRectReadOnly.width je svojstvo instance samo za čitanje. Čitaš ga izrazom rect.width, bez zagrada. Vraća vrijednost tipa number. Mjerna jedinica ovisi o API-ju koji je dao pravokutnik. Na primjer, za HTML element entry.contentRect.width objekta ResizeObserverEntry daje širinu okvira sadržaja u CSS pikselima.
Kad samostalno stvaraš pravokutnik, treći argument konstruktora DOMRectReadOnly određuje width. Negativna širina ostaje negativna: uz konačne koordinate i negativnu širinu, left je jednak x + width, a right je jednak x. Za nenegativni vodoravni raspon pravokutnika konačne širine upotrijebi Math.abs(rect.width).
Dodjela vrijednosti svojstvu width ne mijenja instancu DOMRectReadOnly: u strogom načinu rada izaziva iznimku TypeError, a inače se zanemaruje. Ako trebaš drugu širinu, stvori novi pravokutnik ili upotrijebi svojstvo width objekta DOMRect, koje dopušta upis. DOMRectReadOnly je web API, a ne dio ECMAScripta; provjeri je li dostupan u ciljnom okruženju.
Primjeri
(() => {
"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}`);
}
})();Rezultat
width=-4.5, left=5.5, right=10 TypeError=true, width=-4.5
Pokreni kôd u konzoli preglednika koji podržava `DOMRectReadOnly` da bi koristio ugrađeni API. Ako `DOMRectReadOnly` nije dostupan, kao u okruženju Node.js, primjer koristi lokalni model koji oponaša samo `width`, `left` i `right`. Negativna širina ostaje `-4.5`, a dodjela u strogom načinu rada izaziva iznimku `TypeError` koju primjer hvata.
Povezane lekcije
- JavaScript · Lekcija 32 · Srednje · Verzija: 3