background-origin

Définit à partir de quelle zone de l’élément la position de l’image d’arrière-plan est calculée.

Valeur initiale
padding-box
Héritée
Non
Animable
non
S’applique à
tous les éléments
JavaScript
element.style.backgroundOrigin = "content-box"
Sur cette page

Exemple

#
CSS
.quote {
  padding: 24px;
  background: url("/icons/quote.svg") no-repeat left top / 24px;
  background-origin: content-box;
}
Aperçu

Définition et utilisation

#

La propriété background-origin définit le point de référence de background-position. Par défaut (padding-box), la position 0 0 désigne le coin supérieur gauche de la zone de marge intérieure, c’est-à-dire le bord intérieur de la bordure.

Avec content-box, l’image part du bord du contenu : la marge intérieure crée donc un espace autour d’elle. Avec border-box, l’image commence directement sous la bordure.

La propriété ne concerne que les images d’arrière-plan et n’affecte pas la couleur de fond. On l’utilise souvent avec background-clip.

Syntaxe

#
Syntaxe
background-origin: padding-box | border-box | content-box;

Valeurs

#
  • padding-box

    L’image commence au bord intérieur de la bordure.
  • border-box

    L’image commence sous la bordure.
  • content-box

    L’image commence au bord du contenu, après la marge intérieure.

Valeurs en pratique

#

padding-box

L’image commence au bord intérieur de la bordure.
.demo { background-origin: padding-box; }

border-box

L’image commence sous la bordure.
.demo { background-origin: border-box; }

content-box

L’image commence au bord du contenu, après la marge intérieure.
.demo { background-origin: content-box; }

Compatibilité des navigateurs

#

Largement disponible

Fonctionne dans tous les navigateurs modernes, y compris sur mobile. Vous pouvez l’utiliser sans crainte.

  • Chrome
  • Edge
  • Firefox
  • Safari

Bonnes pratiques

#
  • Si une icône d’arrière-plan doit garder une distance par rapport au bord, réglez content-box au lieu de calculer la position en pixels.
  • Dans la propriété raccourcie background, indiquer une seule boîte, par exemple content-box, définit à la fois origin et clip.

Entrées associées

#

Vous voyez une erreur ou il manque un exemple ? Écrivez-nous.