Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

HTMLElement.style: transform e height

Imposta la trasformazione e l’altezza di un elemento da JavaScript e distingui le dichiarazioni in linea dai valori risolti dalla cascata CSS.

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

Sintassi

const style = element.style;
style.transform = "translateY(12px)";
style.height = "80px";
style.removeProperty("transform");
style.height = "";

HTMLElement.style restituisce un oggetto che riflette in tempo reale l’attributo style dell’elemento. Anche un riferimento salvato continua a riflettere le modifiche. La specifica attuale restituisce CSSStyleProperties, che eredita da CSSStyleDeclaration; alcuni browser possono ancora restituire CSSStyleDeclaration. Queste API appartengono alla piattaforma web, non a ECMAScript 2024.

Non puoi sostituire l’oggetto: assegnare un valore direttamente a element.style imposta cssText e sostituisce il blocco di dichiarazioni. Usa element.style.transform e element.style.height per leggere o modificare singole dichiarazioni. Assegna stringhe CSS valide come "80px". In modalità standard, un valore diverso da zero e senza unità come "81", assegnato a height, viene ignorato senza generare eccezioni e lascia invariato il valore precedente. In modalità quirks, invece, i browser possono interpretarlo come una lunghezza in pixel.

transform modifica il modo in cui viene disegnato un riquadro trasformabile: translateY(12px) lo sposta verso il basso di 12 pixel CSS senza alterare lo spazio che occupa nel flusso normale. height specifica un’altezza per il layout: per impostazione predefinita dimensiona il riquadro del contenuto; con box-sizing: border-box, quello che include il bordo.

Leggere una dichiarazione in linea assente restituisce "". Assegnare "" o chiamare removeProperty() rimuove quella dichiarazione; non equivale a impostare transform: none o height: auto. Per leggere i valori risolti dopo la cascata, usa l’oggetto di sola lettura restituito da getComputedStyle(element).

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTMLElement.style: transform and height</title>
</head>
<body>
<script>
(() => {
  const element = document.createElement("div");
  const style = element.style;
  const log = () => console.log(JSON.stringify([style.transform, style.height]));

  style.transform = "translateY(12px)";
  style.height = "80px";
  log();

  style.height = "81";
  log();

  style.removeProperty("height");
  log();
})();
</script>
</body>
</html>

Risultato

["translateY(12px)","80px"]
["translateY(12px)","80px"]
["translateY(12px)",""]

Salva l’esempio completo in un file HTML e aprilo in un browser. Mantieni `<!doctype html>` affinché la pagina venga elaborata in modalità standard. Controlla l’output nella console del browser. L’elemento non viene inserito nel documento, quindi l’output mostra le dichiarazioni in linea, non le dimensioni a schermo.

Lezioni correlate

  • JavaScript · Lezione 11 · Avanzato · Versione: 4

Fonti