Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / CSS

text-shadow — cienie tekstu

Właściwość text-shadow dodaje cienie do kształtów znaków i dekoracji tekstu, a nie do prostokątnego pudełka elementu. Pozwala określić przesunięcia, rozmycie, kolor i wiele warstw; jest dziedziczona i nie zmienia układu.

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

Składnia

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

text-shadow tworzy cienie tekstu oraz jego dekoracji, na przykład podkreślenia. Wartość początkowa to none, a właściwość jest dziedziczona. Ustawienie none na potomku usuwa jego odziedziczone cienie. W przeciwieństwie do box-shadow efekt podąża za kształtem znaków, nie za pudełkiem elementu.

W pokazanym podzbiorze Level 3 każdy cień wymaga dwóch długości: przesunięcia poziomego i pionowego. Wartości dodatnie przesuwają cień w prawo i w dół, ujemne — w lewo i w górę. Opcjonalna trzecia długość oznacza nieujemny promień rozmycia; domyślne 0 daje ostrą krawędź. Kolor można umieścić przed długościami lub po nich; pominięty odpowiada currentColor. Procenty są niedozwolone.

Kolejne cienie oddzielaj przecinkami; pierwszy znajduje się nad pozostałymi, lecz w tym podzbiorze wszystkie są za tekstem. Cienie nie zmieniają układu ani nie powiększają obszaru przewijania. W przykładzie Shadow ma dwa ostre, kolorowe cienie, natomiast Plain wyłącza odziedziczony efekt.

Granica specyfikacji: projekt Level 4 dodatkowo definiuje rozszerzenie cienia i inset; Level 3 ich nie dopuszcza. Ich obecność w projekcie nie potwierdza obsługi w Chromium 152. Przykład celowo ich nie używa i nadal wymaga lokalnej weryfikacji.

Przykłady

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

Wynik

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.

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

Źródła