Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

box-shadow — cienie pudełka CSS

Właściwość box-shadow dodaje jeden lub więcej cieni zewnętrznych albo wewnętrznych do pudełka elementu, bez zmiany jego wymiarów w układzie. Pozwala ustawić przesunięcie, rozmycie, rozrost i kolor każdego cienia.

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

Składnia

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

box-shadow rysuje cienie pudełka, a nie konturów liter lub nieprzezroczystych pikseli obrazu. Wartość początkowa to none; właściwość nie jest dziedziczona. Cienie nie zajmują miejsca w układzie. Ich kształt uwzględnia border-radius.

W pokazanej składni Level 3 dwie wymagane długości oznaczają przesunięcie poziome i pionowe: wartości dodatnie przesuwają cień w prawo i w dół. Trzecia długość to promień rozmycia, który nie może być ujemny; czwarta to rozrost, który może być ujemny. Pominięte rozmycie i rozrost wynoszą 0. Procenty są niedozwolone. Pominięty kolor przyjmuje currentColor. Opcjonalne inset zmienia cień zewnętrzny na wewnętrzny.

Oddzielaj cienie przecinkami; pierwszy jest na wierzchu pozostałych. Cienie zewnętrzne są pod tłem elementu, a wewnętrzne nad tłem, lecz pod zawartością. Rozmycie nie gwarantuje identycznych pikseli w każdej implementacji, dlatego przykład używa ostrych krawędzi.

Level 4 opisuje box-shadow jako skrót właściwości składowych i rozszerza gramatykę. Ten wpis i przykład celowo używają składni Level 3; sam zapis w projekcie specyfikacji nie potwierdza obsługi rozszerzeń w przeglądarce. Przykład nadal wymaga lokalnej weryfikacji.

Przykłady

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

Wynik

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.

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła