WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

text-shadow — Textschatten

Die Eigenschaft text-shadow fügt Schatten zu Glyphenformen und Textdekorationen hinzu, nicht zum rechteckigen Elementkasten. Sie unterstützt Versatz, Unschärfe, Farbe und mehrere Ebenen, wird vererbt und verändert das Layout nicht.

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

Syntax

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

text-shadow erzeugt Schatten für Text und seine Dekorationen, etwa Unterstreichungen. Der Anfangswert ist none, und die Eigenschaft wird vererbt. Wird bei einem Nachfahren none gesetzt, entfernt das dessen geerbte Schatten. Anders als box-shadow folgt der Effekt den Glyphenformen und nicht dem Elementkasten.

Im hier gezeigten Level-3-Teilbereich benötigt jeder Schatten zwei Längen: den horizontalen und den vertikalen Versatz. Positive Werte verschieben den Schatten nach rechts und unten, negative nach links und oben. Eine optionale dritte Länge ist ein nichtnegativer Unschärferadius; der Standardwert 0 ergibt eine scharfe Kante. Die Farbe kann vor oder nach den Längen stehen; wird sie weggelassen, entspricht sie currentColor. Prozentwerte sind nicht zulässig.

Trenne mehrere Schatten durch Kommas; der erste liegt über den anderen, in diesem Teilbereich liegen jedoch alle hinter dem Text. Schatten verändern weder das Layout noch vergrößern sie den scrollbaren Bereich. Im Beispiel hat Shadow zwei scharfe, farbige Schatten, während Plain den geerbten Effekt deaktiviert.

Grenze der Spezifikation: Der Level-4-Entwurf definiert zusätzlich Ausbreitung und inset; Level 3 lässt diese nicht zu. Dass sie im Entwurf vorkommen, bestätigt keine Unterstützung in Chromium 152. Das Beispiel verwendet sie bewusst nicht und muss dennoch lokal überprüft werden.

Beispiele

<!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>

Ergebnis

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.

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen