CKTIS / JavaScript
DOMRect.width — larghezza del rettangolo
DOMRect.width è una proprietà di istanza scrivibile che descrive la larghezza di un rettangolo. Contiene un numero in virgola mobile e ammette valori negativi. Non va confusa con la proprietà di sola lettura DOMRectReadOnly.width.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
rect.width
rect.width = valueDOMRect.width descrive la larghezza del rettangolo rappresentato da un oggetto DOMRect. È una proprietà di istanza: leggila come rect.width e modificala con rect.width = value. Il suo tipo Web IDL è unrestricted double, rappresentato in JavaScript come number. Il valore non deve necessariamente essere intero o positivo; questo tipo ammette anche NaN, Infinity e -Infinity.
Il costruttore new DOMRect(x, y, width, height) riceve la larghezza come terzo argomento. Una larghezza negativa non viene convertita automaticamente in un valore positivo. Se x e width sono finiti e width è negativo, left è x + width e right è x. Questa regola semplificata non vale sempre per i valori infiniti: con x = Infinity e width = -Infinity, x + width vale NaN, quindi il calcolo del massimo per right restituisce NaN, non x.
In aritmetica esatta, con valori finiti di x e width e un valore negativo di width, right - left sarebbe uguale al valore assoluto di width, ma l’arrotondamento in virgola mobile in JavaScript può alterare il risultato. Ad esempio, con x = 1e20 e width = -8, x + width viene arrotondato a x, quindi right - left vale 0, non 8.
DOMRect eredita da DOMRectReadOnly, ma consente di scrivere in width. Ciò che rappresenta il rettangolo dipende dall’API che lo ha restituito; la proprietà da sola non specifica il tipo di area misurata.
Questa è una funzionalità della Web API descritta in Geometry Interfaces Module Level 1, non una funzionalità di una specifica edizione di ECMAScript. MDN la indica come ampiamente disponibile nei browser da gennaio 2020, anche nei Web Workers. L’esempio usa coordinate esplicite, quindi non dipende dal layout della pagina.
Esempi
const rect = new DOMRect(10, 20, 30.5, 40);
console.log(rect.width);
rect.width = -8;
console.log(rect.width);
console.log(rect.left, rect.right);Risultato
30.5 -8 2 10
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.