Aller au contenu

Propriété CSS background-position-x

La propriété background-position-x définit la position horizontale d'une couche d'image d'arrière-plan. Une ou plusieurs valeurs peuvent être spécifiées, séparées par des virgules.

Par défaut, une background-image est positionnée dans le coin supérieur gauche de l'élément et répétée à la fois horizontalement et verticalement.

Note

En CSS moderne, il est recommandé d'utiliser la propriété raccourcie background-position à la place, car background-position-x est rarement utilisée isolément.

INFO

Les valeurs négatives sont valides.

Valeur initialeleft
S'applique àTous les éléments.
HéritéeNon.
AnimableNon.
VersionCSS3
Syntaxe DOMobject.style.backgroundPositionX = "right";

Syntaxe

Valeurs CSS background-position-x

css
background-position-x: left | center | right | length | percentage | initial | inherit;

Exemple de la propriété background-position-x :

Exemple de code CSS background-position-x

html
<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      body {
        background: #ccc url("https://fr.w3docs.com/build/images/w3docs-logo-black.png") repeat-y;
        background-position-x: 70%;
      }
    </style>
  </head>
  <body>
    <h2>Background-position-x property example</h2>
  </body>
</html>

Résultat

CSS background-position-x center

Exemple de la propriété background-position-x avec la valeur "center" :

Exemple CSS background-position-x center

html
<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      body {
        background: #ccc url("https://fr.w3docs.com/build/images/w3docs-logo-black.png") repeat-x;
        background-position-x: center;
      }
    </style>
  </head>
  <body>
    <h2>Background-position-x property example</h2>
  </body>
</html>

Exemple de la propriété background-position-x avec la valeur "left" :

Exemple CSS background-position-x left

html
<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      body {
        background: #ccc url("https://fr.w3docs.com/build/images/w3docs-logo-black.png") repeat-y;
        background-position-x: left;
      }
    </style>
  </head>
  <body>
    <h2>Background-position-x property example</h2>
  </body>
</html>

Exemple de la propriété background-position-x avec la valeur "length" :

Exemple de la propriété background-position-x avec la valeur "length" :

html
<!DOCTYPE html>
<html>
  <head>
    <title>Title of the document</title>
    <style>
      body {
        background: #ccc url("https://fr.w3docs.com/build/images/w3docs-logo-black.png") repeat-y;
        background-position-x: 30px;
      }
    </style>
  </head>
  <body>
  </body>
</html>

Valeurs

ValeurDescription
leftSpécifie l'alignement du bord gauche de l'image d'arrière-plan avec le bord gauche de la couche de position d'arrière-plan.
centerSpécifie l'alignement du centre de l'image d'arrière-plan avec le centre de la couche de position d'arrière-plan.
rightSpécifie l'alignement du bord droit de l'image d'arrière-plan avec le bord droit de la couche de position d'arrière-plan.
lengthSpécifie le décalage du bord vertical gauche de l'image d'arrière-plan donnée par rapport au bord vertical gauche de la couche de position d'arrière-plan.
percentageSpécifie le décalage de la position horizontale de l'image d'arrière-plan par rapport au conteneur. 0% aligne le bord gauche de l'image d'arrière-plan avec le bord gauche du conteneur, 100% aligne le bord droit de l'image d'arrière-plan avec le bord droit du conteneur, et 50% centre horizontalement l'image d'arrière-plan.
initialDéfinit la propriété à sa valeur par défaut.
inheritHérite la propriété de son élément parent.

Practice

Quelle est la fonction de la propriété CSS background-position-x ?

Trouvez-vous cela utile?

Aperçu dual-run — comparez avec les routes Symfony en production.