CKTIS / JavaScript
HTMLElement.offsetWidth — larghezza di layout di un elemento
HTMLElement.offsetWidth restituisce la larghezza intera di un elemento in pixel CSS. Include padding e bordi, ma esclude i margini. Ignora le trasformazioni CSS.
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
element.offsetWidthHTMLElement.offsetWidth è una proprietà di sola lettura di CSSOM View, non una funzione ECMAScript. Restituisce un numero intero in pixel CSS. Per una normale singola casella, include contenuto, padding, bordi e lo spazio occupato da una barra di scorrimento verticale, ma esclude i margini.
Più precisamente, misura la larghezza del rettangolo allineato agli assi che racchiude tutti i frammenti generati dalla casella principale dell’elemento, bordi compresi. Se un discendente a livello di blocco divide la casella principale in linea dell’elemento, la misura include anche i frammenti generati da quel discendente con larghezza e altezza entrambe diverse da zero. Ignora le trasformazioni applicate all’elemento e ai suoi antenati. Se non è presente una casella, per esempio con display: none, il risultato è 0.
Nell’esempio, box-sizing: content-box fa sì che il risultato sia 100 + 2 * 10 + 2 * 2 = 124. Né margin: 30px né transform: scale(2) lo modificano. Il codice richiede un documento del browser; una versione di Node.js da sola non dimostra il supporto di questa API.
Esempi
const box = document.createElement('div');
box.style.cssText = 'all: initial; display: block; position: fixed; box-sizing: content-box; width: 100px; height: 20px; padding: 10px; border: 2px solid; margin: 30px; overflow: hidden; transform: scale(2);';
document.body.append(box);
console.log(box.offsetWidth);
box.style.display = 'none';
console.log(box.offsetWidth);
box.remove();Risultato
124 0
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.