CKTIS / CSS
background-size — dimensionner les images d’arrière-plan
La propriété background-size définit les dimensions des images d’arrière-plan, et non celles de l’élément. Indiquez des dimensions, utilisez auto ou adaptez l’image avec contain ou cover.
Version : CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Syntaxe
background-size: <bg-size>#;
<bg-size> = [ <length-percentage [0,∞]> | auto ]{1,2} | cover | containbackground-size définit la taille de chaque image d’arrière-plan, et non celle de l’élément. Sa valeur initiale est auto auto et la propriété n’est pas héritée.
Dans la syntaxe largeur/hauteur, la première valeur indique la largeur et la seconde la hauteur. Si seule la largeur est indiquée dans cette syntaxe, la hauteur vaut auto. Les longueurs et les pourcentages doivent être non négatifs. Les pourcentages se rapportent aux dimensions correspondantes de la zone de positionnement de l’arrière-plan, généralement déterminée par background-origin. auto utilise les proportions et dimensions naturelles de l’image lorsqu’elles sont disponibles ; cela ne signifie pas toujours la taille du fichier d’origine.
contain et cover sont des modes de dimensionnement à part entière qui déterminent les deux dimensions de l’image. contain conserve les proportions naturelles, si elles existent, et fait tenir toute l’image dans la zone. cover les conserve également et couvre toute la zone ; une partie de l’image peut être coupée. 100% 100% définit les deux dimensions indépendamment et peut déformer l’image.
Les virgules séparent les tailles des couches successives de background-image ; une liste trop courte est répétée et les valeurs en trop sont ignorées. La répétition est contrôlée séparément par background-repeat. Dans la propriété raccourcie background, la taille suit la position et /, par exemple background: none center / cover no-repeat.
Exemples
<!doctype html>
<meta charset="utf-8">
<title>background-size</title>
<style>
.sample {
width: 200px;
height: 120px;
background-color: #ddd;
background-image: linear-gradient(to right, #06c 50%, #fc0 50%);
background-size: 50% 50%;
background-position: center;
background-repeat: no-repeat;
}
</style>
<div class="sample"></div>Résultat
A 200 × 120 CSS-pixel gray rectangle contains a centered 100 × 60 CSS-pixel image: its left half is blue and its right half is yellow.
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.