box-shadow

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die box-shadow CSS Eigenschaft fügt Schattierungseffekte um den Rahmen eines Elements hinzu. Sie können mehrere Effekte durch Kommata getrennt festlegen. Ein Kastenschatten wird durch X- und Y-Abstände relativ zum Element, Unschärfe- und Ausbreitungsradius sowie Farbe beschrieben.

Probieren Sie es aus

box-shadow: 10px 5px 5px red;
box-shadow: 60px -16px teal;
box-shadow: 12px 12px 2px 1px rgb(0 0 255 / 0.2);
box-shadow: inset 5em 1em gold;
box-shadow:
  3px 3px red,
  -1em 0 0.4em olive;
<section id="default-example">
  <div class="transition-all" id="example-element">
    <p>This is a box with a box-shadow around it.</p>
  </div>
</section>
#example-element {
  margin: 20px auto;
  padding: 0;
  border: 2px solid #333;
  width: 80%;
  text-align: center;
}

Die box-shadow-Eigenschaft ermöglicht es, einen Schlagschatten vom Rahmen fast jedes Elements zu werfen. Wenn ein border-radius-Attribut auf ein Element mit einem Kastenschatten angewendet wird, übernimmt der Kastenschatten die gleichen abgerundeten Ecken. Die z-Ordnung mehrerer Kastenschattierungen ist dieselbe wie bei mehreren Textschatten (der zuerst angegebene Schatten liegt oben).

Box-shadow Generator ist ein interaktives Tool, das Ihnen ermöglicht, einen box-shadow zu erstellen.

Syntax

css
/* Keyword values */
box-shadow: none;

/* A color and two length values */
/* <color> | <length> | <length> */
box-shadow: red 60px -16px;

/* Three length values and a color */
/* <length> | <length> | <length> | <color> */
box-shadow: 10px 5px 5px black;

/* Four length values and a color */
/* <length> | <length> | <length> | <length> | <color> */
box-shadow: 2px 2px 2px 1px rgb(0 0 0 / 20%);

/* inset, length values, and a color */
/* <inset> | <length> | <length> | <color> */
box-shadow: inset 5em 1em gold;

/* Any number of shadows, separated by commas */
box-shadow:
  3px 3px red inset,
  -1em 0 0.4em olive;

/* Global values */
box-shadow: inherit;
box-shadow: initial;
box-shadow: revert;
box-shadow: revert-layer;
box-shadow: unset;

Geben Sie einen einzelnen Kastenschatten an durch:

  • Zwei, drei oder vier <length> Werte.

    • Wenn nur zwei Werte angegeben sind, werden sie als <offset-x> und <offset-y> Werte interpretiert.
    • Wird ein dritter Wert angegeben, wird dieser als <blur-radius> interpretiert.
    • Wird ein vierter Wert angegeben, wird dieser als <spread-radius> interpretiert.
  • Optional das inset Schlüsselwort.

  • Optional ein <color>-Wert.

Um mehrere Schatten anzugeben, geben Sie eine durch Kommata getrennte Liste von Schatten an.

Werte

<color> Optional

Gibt die Farbe für den Schatten an. Siehe <color> Werte für mögliche Schlüsselwörter und Notationen. Falls nicht angegeben, wird der Wert der color Eigenschaft des Elternelements verwendet.

<length>

Gibt die Versatzlänge des Schattens an. Dieser Parameter akzeptiert zwei, drei oder vier Werte. Der dritte und vierte Wert sind optional. Sie werden wie folgt interpretiert:

  • Wenn zwei Werte angegeben sind, werden sie als <offset-x> (horizontaler Versatz) und <offset-y> (vertikaler Versatz) interpretiert. Ein negativer <offset-x> Wert platziert den Schatten links vom Element. Ein negativer <offset-y> Wert platziert den Schatten oberhalb des Elements.
    Falls nicht angegeben, wird der Wert 0 für die fehlende Länge verwendet. Wenn sowohl <offset-x> als auch <offset-y> auf 0 gesetzt sind, wird der Schatten hinter dem Element platziert (und kann einen Unschärfeeffekt erzeugen, wenn <blur-radius> und/oder <spread-radius> gesetzt ist).

  • Falls drei Werte angegeben sind, wird der dritte Wert als <blur-radius> interpretiert. Je größer dieser Wert ist, desto größer wird die Unschärfe, sodass der Schatten größer und heller wird. Negative Werte sind nicht erlaubt. Falls nicht angegeben, wird er auf 0 gesetzt (bedeutet, dass die Kante des Schattens scharf ist). Die Spezifikation enthält keinen genauen Algorithmus, wie der Unschärferadius berechnet werden soll; sie erläutert jedoch Folgendes:

    …für eine lange, gerade Schattenkante sollte dies einen Farbverlauf in der Länge der Unschärfestrecke erzeugen, der senkrecht dazu verläuft und zentriert auf die Schattenkante ist, und der von der vollen Schattenfarbe am Radiusendpunkt innerhalb des Schattens bis zur vollständigen Transparenz am Endpunkt außerhalb davon reicht.

  • Wenn vier Werte angegeben sind, wird der vierte Wert als <spread-radius> interpretiert. Positive Werte lassen den Schatten größer werden, negative Werte lassen den Schatten schrumpfen. Falls nicht angegeben, wird er auf 0 gesetzt (d.h. der Schatten hat die gleiche Größe wie das Element).

inset Optional

Ändert den Schatten von einem äußeren Kastenschatten zu einem inneren Kastenschatten (als ob der Inhalt in die Box gedrückt wird). Eingesetzte Schatten werden innerhalb der Box-Grenzen gezeichnet (selbst wenn der Rand transparent ist) und erscheinen über dem Hintergrund, aber unter dem Inhalt. Standardmäßig verhält sich der Schatten wie ein Schlagschatten, wodurch der Anschein entsteht, dass die Box über ihrem Inhalt schwebt. Dies ist das Standardverhalten, wenn inset nicht angegeben ist.

Interpolation

Beim Animieren von Schatten, wie wenn mehrere Schattenwerte auf einer Box zu neuen Werten bei Hover übergehen, werden die Werte interpoliert. Interpolation bestimmt Zwischenwerte von Eigenschaften, wie z. B. den Unschärferadius, den Streuradius und die Farbe, während sich Schatten ändern. Für jeden Schatten in einer Liste von Schatten übergehen Farbe, x, y, Unschärfe und Ausbreitung; die Farbe als <color> und die anderen Werte als <length>.

Beim Interpolieren mehrerer Schatten zwischen zwei durch Komma getrennten Listen von mehreren Kastenschattierungen werden die Schatten paarweise zugeordnet und die Interpolation erfolgt zwischen gepaarten Schatten. Wenn die Listen unterschiedliche Längen haben, wird die kürzere Liste am Ende mit Schatten aufgefüllt, deren Farbe transparent ist, und X, Y und Unschärfe sind 0, wobei das Vorhandensein oder Fehlen von inset übereinstimmt. Wenn in einem Schattenpaar ein Schatten inset gesetzt hat und der andere nicht, wird die gesamte Schattenliste nicht interpoliert; die Schatten ändern sich zu den neuen Werten ohne animierenden Effekt.

Formale Definition

Anfangswertnone
Anwendbar aufalle Elemente. Auch anwendbar auf ::first-letter.
VererbtNein
Berechneter WertLängen absolut gemacht; angegebene Farben berechnet; ansonsten wie angegeben
Animationstypeine Liste von Schatten

Formale Syntax

box-shadow = 
<spread-shadow>#

<spread-shadow> =
<'box-shadow-color'>? &&
[ <'box-shadow-offset'> [ <'box-shadow-blur'> <'box-shadow-spread'>? ]? ] &&
<'box-shadow-position'>?

<box-shadow-color> =
<color>#

<box-shadow-offset> =
[ none | <length>{2} ]#

<box-shadow-blur> =
<length [0,∞]>#

<box-shadow-spread> =
<length>#

<box-shadow-position> =
[ outset | inset ]#

Beispiele

Drei Schatten setzen

In diesem Beispiel fügen wir drei Schatten hinzu: einen eingesetzten Schatten, einen regulären Schlagschatten und einen 2px Schatten, der einen Rahmen-Effekt erzeugt (wir hätten dafür auch ein outline verwenden können).

HTML

html
<blockquote>
  <q>
    You may shoot me with your words,<br />
    You may cut me with your eyes,<br />
    You may kill me with your hatefulness,<br />
    But still, like air, I'll rise.
  </q>
  <p>&mdash; Maya Angelou</p>
</blockquote>

CSS

css
blockquote {
  padding: 20px;
  box-shadow:
    inset 0 -3em 3em rgb(0 200 0 / 30%),
    0 0 0 2px white,
    0.3em 0.3em 1em rgb(200 0 0 / 60%);
}

Ergebnis

Null für Versatz und Unschärfe setzen

Wenn der x-Versatz, y-Versatz und die Unschärfe alle auf Null gesetzt sind, ist der Kastenschatten eine einfarbige Umrandung in gleicher Größe auf allen Seiten. Die Schatten werden von vorne nach hinten gezeichnet, sodass der erste Schatten oberhalb der nachfolgenden Schatten liegt. Wenn der border-radius auf 0 gesetzt ist, was der Standard ist, werden die Ecken des Schattens Ecken sein. Hätten wir einen border-radius von einem anderen Wert eingefügt, wären die Ecken abgerundet.

Wir haben einen Rand in der Größe des breitesten Kastenschattens hinzugefügt, um sicherzustellen, dass der Schatten keine angrenzenden Elemente überlappt oder über den Rand der umgebenden Box hinausgeht. Ein Kastenschatten beeinflusst nicht die Box-Modell-Dimensionen.

HTML

html
<div><p>Hello World</p></div>

CSS

css
p {
  box-shadow:
    0 0 0 2em #f4aab9,
    0 0 0 4em #66ccff;
  margin: 4em;
  padding: 1em;
}

Ergebnis

Spezifikationen

Specification
CSS Backgrounds and Borders Module Level 3
# box-shadow

Browser-Kompatibilität

Siehe auch