Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

text-shadow — ombre del testo

La proprietà text-shadow aggiunge ombre alle forme dei glifi e alle decorazioni del testo, non al riquadro rettangolare dell’elemento. Consente di specificare spostamenti, sfocatura, colore e più livelli; è ereditata e non modifica il layout.

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

Sintassi

text-shadow: none | [ <color>? && [ <length>{2} <length [0,∞]>? ] ]#; /* Level 3 subset; Level 4 draft additionally defines spread and inset. */

text-shadow crea ombre per il testo e le sue decorazioni, come le sottolineature. Il valore iniziale è none e la proprietà è ereditata. Impostare none su un discendente rimuove le ombre ereditate. A differenza di box-shadow, l’effetto segue la forma dei glifi e non il riquadro dell’elemento.

Nel sottoinsieme Level 3 mostrato qui, ogni ombra richiede due lunghezze: gli spostamenti orizzontale e verticale. I valori positivi spostano l’ombra a destra e in basso; quelli negativi a sinistra e in alto. Una terza lunghezza facoltativa è un raggio di sfocatura non negativo; il valore predefinito 0 produce un bordo netto. Il colore può precedere o seguire le lunghezze; se omesso, corrisponde a currentColor. Le percentuali non sono consentite.

Separa le ombre con virgole; la prima si trova sopra le altre, ma in questo sottoinsieme sono tutte dietro al testo. Le ombre non modificano il layout né ampliano l’area scorrevole. Nell’esempio, Shadow ha due ombre colorate e nette, mentre Plain disattiva l’effetto ereditato.

Limite della specifica: la bozza Level 4 definisce anche l’espansione e inset; Level 3 non li consente. La loro presenza nella bozza non conferma il supporto in Chromium 152. L’esempio li evita intenzionalmente e richiede comunque una verifica locale.

Esempi

<!doctype html>
<meta charset="utf-8">
<title>text-shadow</title>
<style>
  body { background: white; }
  .sample {
    color: black;
    font: bold 48px/1.5 monospace;
    text-shadow: 3px 2px 0 #b00020, -3px -2px 0 #005fcc;
  }
  .plain { text-shadow: none; }
</style>
<p class="sample">Shadow <span class="plain">Plain</span></p>

Risultato

Shadow: black text with a sharp #b00020 shadow offset 3px right and 2px down, and a sharp #005fcc shadow offset 3px left and 2px up. Plain: black text without shadows.

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