Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

box-shadow — ombres de boîte CSS

La propriété box-shadow ajoute une ou plusieurs ombres extérieures ou intérieures à la boîte d’un élément, sans modifier ses dimensions dans la mise en page. Chaque ombre peut avoir son propre décalage, flou, étalement et couleur.

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

Syntaxe

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

box-shadow dessine les ombres de la boîte, et non le contour des lettres ni les pixels opaques d’une image. Sa valeur initiale est none ; la propriété n’est pas héritée. Les ombres ne prennent pas de place dans la mise en page. Leur forme tient compte de border-radius.

Dans la syntaxe de niveau 3 présentée ici, les deux longueurs requises indiquent les décalages horizontal et vertical : des valeurs positives déplacent l’ombre vers la droite et vers le bas. La troisième longueur est le rayon de flou, qui ne peut pas être négatif ; la quatrième est l’étalement, qui peut l’être. Si le flou ou l’étalement est omis, sa valeur est 0. Les pourcentages ne sont pas autorisés. Si la couleur est omise, la valeur par défaut est currentColor. Le mot-clé facultatif inset transforme une ombre extérieure en ombre intérieure.

Séparez les ombres par des virgules ; la première est dessinée au-dessus des autres. Les ombres extérieures se trouvent sous l’arrière-plan de l’élément, tandis que les ombres intérieures se trouvent au-dessus de l’arrière-plan, mais sous le contenu. Le flou ne garantit pas des pixels identiques dans toutes les implémentations ; l’exemple utilise donc des bords nets.

Le niveau 4 décrit box-shadow comme un raccourci pour des propriétés composantes et étend sa grammaire. Cette entrée et cet exemple utilisent délibérément la syntaxe de niveau 3 ; la présence dans un projet de spécification ne prouve pas la prise en charge des extensions par les navigateurs. L’exemple doit toujours être vérifié localement.

Exemples

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

Résultat

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.

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.

Sources