CKTIS / JavaScript
DOMRectReadOnly.width — larghezza di un rettangolo
La proprietà di sola lettura `width` restituisce la larghezza memorizzata del rettangolo come numero, conservandone il segno e l’eventuale parte frazionaria.
Versione: ECMAScript 2024 and the current web platform; runtime support varies
Sintassi
rect.widthDOMRectReadOnly.width è una proprietà di istanza di sola lettura. Si legge con rect.width, senza parentesi, e restituisce un valore di tipo number. L’unità dipende dall’API che fornisce il rettangolo. Ad esempio, per un elemento HTML, entry.contentRect.width di un oggetto ResizeObserverEntry indica la larghezza del riquadro del contenuto in pixel CSS.
Quando crei un rettangolo, il terzo argomento di DOMRectReadOnly imposta width. Una larghezza negativa resta negativa: con coordinate finite e larghezza negativa, left vale x + width e right vale x. Per ottenere l’estensione orizzontale non negativa di un rettangolo con larghezza finita, usa Math.abs(rect.width).
Assegnare un valore a width non modifica un’istanza di DOMRectReadOnly: in modalità rigorosa l’assegnazione genera un TypeError, altrimenti viene ignorata. Se ti serve una larghezza diversa, crea un nuovo rettangolo o usa la proprietà scrivibile width di un DOMRect. DOMRectReadOnly è un’API Web e non fa parte di ECMAScript; verifica che sia disponibile nell’ambiente di esecuzione di destinazione.
Esempi
(() => {
"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}`);
}
})();Risultato
width=-4.5, left=5.5, right=10 TypeError=true, width=-4.5
Esegui il codice nella console di un browser che supporta `DOMRectReadOnly` per usare l’API nativa. Se `DOMRectReadOnly` non è disponibile, come in Node.js, l’esempio usa un modello locale che riproduce solo `width`, `left` e `right`. La larghezza negativa resta `-4.5` e l’assegnazione in modalità rigorosa genera un `TypeError` che l’esempio intercetta.
Lezioni correlate
- JavaScript · Lezione 32 · Intermedio · Versione: 3