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.