Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

Larghezza e altezza in linea: `style.width` e `style.height`

Usa `element.style.width` e `element.style.height` per leggere, impostare e rimuovere dichiarazioni CSS in linea. Leggere una dichiarazione non equivale a misurare l’elemento.

Versione: ECMAScript 2024 and the current web platform; runtime support varies

Sintassi

element.style.width
 element.style.height
 element.style.width = cssWidth
 element.style.height = cssHeight
 element.style.width = ""
 element.style.height = ""

element.style.width e element.style.height leggono e modificano le dichiarazioni CSS nell’attributo style di un elemento HTML, non gli attributi HTML width e height. element.style restituisce un oggetto che riflette le modifiche alle dichiarazioni in tempo reale, non una copia statica. Ogni proprietà restituisce testo CSS o "" se non c’è una dichiarazione in linea, anche se un foglio di stile fornisce un valore.

Assegna stringhe come "120px", "50%" o "auto". Aggiungi px per indicare una misura in pixel: l’API non attribuisce un’unità di misura a un numero. Un valore non valido come "invalid" lascia invariata la dichiarazione esistente. "" elimina la dichiarazione in linea e lascia che sia la cascata a determinare il valore; "auto" imposta invece una dichiarazione.

Una dichiarazione in linea non garantisce la dimensione finale. La cascata, il layout e vincoli come max-width possono influenzarla. Queste proprietà non si applicano agli elementi in linea non sostituiti, come un normale span. box-sizing determina se la dimensione riguarda il riquadro del contenuto (content-box) o include anche padding e bordi (border-box).

Per un elemento che partecipa al layout, leggi getComputedStyle(element).width o .height per ottenere il valore CSS risolto come testo. Per le dimensioni del rettangolo di delimitazione in pixel CSS, chiama element.getBoundingClientRect() e leggi i valori numerici width e height. Il rettangolo include padding e bordi e tiene conto delle trasformazioni CSS. Sono API del browser, non fanno parte di ECMAScript 2024 e richiedono un ambiente con un DOM.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>Inline width and height</title>
<script>
  const element = document.createElement("div");
  const style = element.style;
  const log = () => console.log(JSON.stringify([style.width, style.height]));

  log();
  element.style.width = "50%";
  element.style.height = "80px";
  log();

  element.style.width = "invalid";
  log();

  element.style.width = "";
  element.style.height = "auto";
  log();
</script>

Risultato

["",""]
["50%","80px"]
["50%","80px"]
["","auto"]

Salva l’esempio come file `.html`, aprilo in un browser e controlla la console di sviluppo. Il `div` non viene inserito nel documento, quindi le quattro righe mostrano dichiarazioni, non misure del layout.

Lezioni correlate

  • JavaScript · Lezione 12 · Avanzato · Versione: 4

Fonti