CKTIS / CSS
text-shadow — ombres de texte
La propriété text-shadow ajoute des ombres aux formes des glyphes et aux décorations du texte, plutôt qu’au rectangle de l’élément. Elle permet de définir des décalages, du flou, une couleur et plusieurs couches ; elle est héritée et ne modifie pas la mise en page.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
text-shadow: none | [ <color>? && [ <length>{2} <length [0,∞]>? ] ]#; /* Level 3 subset; Level 4 draft additionally defines spread and inset. */text-shadow crée des ombres pour le texte et ses décorations, comme les soulignements. Sa valeur initiale est none et la propriété est héritée. Définir none sur un descendant supprime les ombres qu’il a héritées. Contrairement à box-shadow, l’effet suit la forme des glyphes et non la boîte de l’élément.
Dans le sous-ensemble Level 3 présenté ici, chaque ombre exige deux longueurs : les décalages horizontal et vertical. Les valeurs positives déplacent l’ombre vers la droite et le bas ; les valeurs négatives, vers la gauche et le haut. Une troisième longueur facultative correspond à un rayon de flou non négatif ; sa valeur par défaut 0 produit un bord net. La couleur peut précéder ou suivre les longueurs ; si elle est omise, elle correspond à currentColor. Les pourcentages ne sont pas autorisés.
Séparez les ombres par des virgules ; la première se trouve au-dessus des autres, mais dans ce sous-ensemble elles sont toutes derrière le texte. Les ombres ne modifient pas la mise en page et n’agrandissent pas la zone défilable. Dans l’exemple, Shadow a deux ombres colorées nettes, tandis que Plain désactive l’effet hérité.
Limite de la spécification : le brouillon Level 4 définit aussi l’extension de l’ombre et inset ; Level 3 ne les autorise pas. Leur présence dans le brouillon ne confirme pas leur prise en charge dans Chromium 152. L’exemple les évite délibérément et nécessite tout de même une vérification locale.
Exemples
<!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>Résultat
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.
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.