WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

box-shadow — CSS-Box-Schatten

Die Eigenschaft box-shadow fügt der Box eines Elements einen oder mehrere äußere oder innere Schatten hinzu, ohne ihre Abmessungen im Layout zu verändern. Für jeden Schatten lassen sich Versatz, Unschärfe, Ausdehnung und Farbe festlegen.

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

Syntax

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

box-shadow zeichnet Schatten der Box, nicht die Umrisse von Buchstaben oder die undurchsichtigen Pixel eines Bildes. Der Anfangswert ist none; die Eigenschaft wird nicht vererbt. Schatten nehmen keinen Platz im Layout ein. Ihre Form berücksichtigt border-radius.

In der hier gezeigten Level-3-Syntax geben die zwei erforderlichen Längen den horizontalen und vertikalen Versatz an: Positive Werte verschieben den Schatten nach rechts und unten. Die dritte Länge ist der Unschärferadius und darf nicht negativ sein; die vierte ist die Ausdehnung und darf negativ sein. Wird Unschärfe oder Ausdehnung weggelassen, beträgt der Wert 0. Prozentwerte sind nicht zulässig. Ohne angegebene Farbe gilt currentColor. Das optionale Schlüsselwort inset macht aus einem äußeren einen inneren Schatten.

Trenne Schatten durch Kommas; der erste wird über den übrigen gezeichnet. Äußere Schatten liegen unter dem Hintergrund des Elements, innere Schatten dagegen über dem Hintergrund, aber unter dem Inhalt. Unschärfe garantiert nicht in allen Implementierungen identische Pixel; deshalb verwendet das Beispiel scharfe Kanten.

Level 4 beschreibt box-shadow als Kurzschreibweise für Komponenteneigenschaften und erweitert die Grammatik. Dieser Eintrag und das Beispiel verwenden bewusst die Level-3-Syntax; die Aufnahme in einen Spezifikationsentwurf belegt keine Browserunterstützung für Erweiterungen. Das Beispiel muss weiterhin lokal überprüft werden.

Beispiele

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

Ergebnis

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.

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