Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

box-shadow — ombre delle box CSS

La proprietà box-shadow aggiunge una o più ombre esterne o interne alla box di un elemento, senza modificarne le dimensioni nel layout. Ogni ombra può avere un proprio spostamento, sfocatura, espansione e colore.

Versione: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Sintassi

box-shadow: none | <shadow>#;
<shadow> = <color>? && [<length>{2} <length [0,∞]>? <length>?] && inset?

box-shadow disegna le ombre della box, non i contorni delle lettere o i pixel opachi di un’immagine. Il valore iniziale è none e la proprietà non è ereditata. Le ombre non occupano spazio nel layout. La loro forma tiene conto di border-radius.

Nella sintassi di livello 3 mostrata qui, le due lunghezze obbligatorie indicano gli spostamenti orizzontale e verticale: i valori positivi spostano l’ombra a destra e in basso. La terza lunghezza è il raggio di sfocatura, che non può essere negativo; la quarta è l’espansione, che può esserlo. Se la sfocatura o l’espansione è omessa, il valore è 0. Le percentuali non sono ammesse. Se il colore è omesso, il valore predefinito è currentColor. La parola chiave facoltativa inset trasforma un’ombra esterna in interna.

Separa le ombre con virgole; la prima viene disegnata sopra le altre. Le ombre esterne si trovano sotto lo sfondo dell’elemento, mentre quelle interne sono sopra lo sfondo ma sotto il contenuto. La sfocatura non garantisce pixel identici in tutte le implementazioni, quindi l’esempio usa bordi netti.

Il livello 4 descrive box-shadow come una forma abbreviata per proprietà componenti e ne amplia la grammatica. Questa voce e l’esempio usano intenzionalmente la sintassi di livello 3; la presenza in una bozza di specifica non dimostra il supporto del browser per le estensioni. L’esempio richiede comunque una verifica locale.

Esempi

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>box-shadow</title>
<style>
  body { margin: 40px; background: white; }
  .box {
    width: 120px;
    height: 80px;
    background: white;
    box-shadow: inset 0 0 0 4px navy, 8px 8px 0 0 teal;
  }
</style>
<div class="box"></div>
</html>

Risultato

A white 120 × 80 CSS-pixel box with a 4px navy inner edge and a sharp teal outer shadow offset 8px right and 8px down. No text or console output.

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.

Fonti