Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / JavaScript

CSSStyleDeclaration: spessori dei bordi e transform

Imposta lo spessore dei singoli lati del bordo e una trasformazione CSS con `element.style`. Distingui le dichiarazioni in linea dai valori risolti dal browser dopo aver applicato la cascata.

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

Sintassi

const style = element.style;
style.borderStyle = "solid";
style.borderWidth = "2px 4px 6px 8px";
style.borderTopWidth = "3px";
style.borderRightWidth = "4px";
style.borderBottomWidth = "6px";
style.borderLeftWidth = "8px";
style.transform = "translateX(12px)";
style.setProperty("border-top-width", "3px");
style.getPropertyValue("border-top-width");
getComputedStyle(element).borderTopWidth;

element.style espone un oggetto che si aggiorna automaticamente e le cui proprietà permettono di leggere e modificare le dichiarazioni dell’attributo style di un elemento. Nel CSSOM attuale è un oggetto CSSStyleProperties, che eredita da CSSStyleDeclaration; nella documentazione meno recente può comparire il nome dell’interfaccia di base. Questa API del browser non fa parte di ECMAScript 2024.

borderWidth corrisponde alla proprietà abbreviata CSS border-width. Un valore vale per tutti i lati; due per alto/basso e destra/sinistra; tre per alto, destra/sinistra e basso; quattro per alto, destra, basso e sinistra. Per modificare un solo lato, usa borderTopWidth, borderRightWidth, borderBottomWidth o borderLeftWidth. Usa stringhe con valori CSS come "3px", "0" o "thin"; il numero 3 non indica tre pixel. Lo spessore da solo non rende visibile il bordo: con uno stile none o hidden il suo spessore si risolve a zero. Imposta ad esempio borderStyle = "solid".

style.transform = "translateX(12px)" sostituisce l’intera dichiarazione in linea transform. Se l’elemento è trasformabile e questa dichiarazione prevale nella cascata, la sua rappresentazione si sposta di 12 pixel CSS verso destra senza cambiare lo spazio che occupa nel flusso normale. Una dichiarazione !important in un foglio di stile dell’autore, se applicabile all’elemento, può prevalere sulla dichiarazione in linea. Per combinare più funzioni, scrivile in un’unica stringa separandole con spazi; l’ordine è importante.

setProperty("border-top-width", "3px") e getPropertyValue("border-top-width") usano il nome CSS con i trattini, a differenza di style.borderTopWidth. Se per quel lato non c’è alcuna dichiarazione in linea, style.borderTopWidth restituisce "". Per leggere il valore risolto dopo la cascata per un elemento nel documento, usa getComputedStyle(element); il risultato si aggiorna automaticamente ma è di sola lettura.

Esempi

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Border widths and transform</title>
</head>
<body>
  <script>
    {
      const box = document.createElement("div");
      const style = box.style;

      style.borderStyle = "solid";
      style.borderWidth = "2px 4px 6px 8px";
      style.setProperty("border-top-width", "3px");
      style.transform = "translateX(12px)";

      console.log([
        style.borderTopWidth,
        style.borderRightWidth,
        style.borderBottomWidth,
        style.borderLeftWidth,
      ].join(" "));
      console.log(style.getPropertyValue("border-top-width"));
      console.log(style.transform);
    }
  </script>
</body>
</html>

Risultato

3px 4px 6px 8px
3px
translateX(12px)

Salva l’esempio come file HTML, aprilo in un browser e controlla la console di sviluppo. La proprietà abbreviata imposta tutti e quattro gli spessori, mentre `setProperty()` modifica solo quello superiore. L’elemento non viene aggiunto al documento: l’output mostra le dichiarazioni in linea, non il risultato visivo.

Lezioni correlate

  • JavaScript · Lezione 35 · Intermedio · Versione: 3

Fonti