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

CKTIS / CSS

background-position-x : modifier seulement la position horizontale

Définissez une coordonnée horizontale physique par couche de fond sans remplacer sa position verticale.

Version : CSS Modules

Syntaxe

background-position-x: 25%, calc(100% - 10px);

background-position-x contrôle la composante horizontale de la position du fond. Utilisez left, center, right, une longueur ou un pourcentage ; sans bord explicite, left est utilisé. La valeur initiale est 0%. Les pourcentages portent sur la largeur de la zone de positionnement moins la largeur déjà fixée de l’image : center aligne donc les centres, pas le bord gauche de l’image au milieu de la boîte. calc(100% - 10px) laisse 10px au bord droit. Une liste séparée par des virgules définit les couches ; une liste plus courte se répète selon background-image.

Il s’agit de l’axe physique x, pas de l’axe en ligne. Changer direction ou writing-mode ne transforme pas un pourcentage explicitement référencé à gauche en décalage logique de début. Le projet CSS Backgrounds Level 4 aborde aussi de nouvelles directions logiques ; leur présence ne garantit pas leur prise en charge partout. Cette propriété détaillée conserve background-position-y, mais un background-position ou un raccourci background ultérieur peut définir cet axe à nouveau. L’ordre des images compte aussi : la première couche est peinte au-dessus des autres.

L’exemple utilise deux couches sans chevauchement dans une boîte de 200×80px : une rouge de 20×10px à y=10px et une bleue de 30×10px à y=40px. La liste x 25%, calc(100% - 10px) les place à 45px et 160px. La console confirme que la liste y reste 10px, 40px. Une deuxième boîte utilise vertical-rl avec direction rtl et produit les mêmes coordonnées physiques peintes. L’inspection PNG vérifie les deux rectangles colorés indépendamment des chaînes de valeurs calculées.

Exemples

['horizontal-tb','vertical-rl'].forEach((writingMode,i)=>{
  const box=document.createElement('div');box.id='x-'+i;
  box.style.cssText='position:absolute;top:0;width:200px;height:80px;direction:rtl;background-image:linear-gradient(red,red),linear-gradient(blue,blue);background-size:20px 10px,30px 10px;background-repeat:no-repeat;background-position-y:10px,40px';
  box.style.left=(i*220)+'px';box.style.writingMode=writingMode;box.style.backgroundPositionX='25%, calc(100% - 10px)';document.body.append(box);
  const s=getComputedStyle(box);console.log(writingMode+': x='+s.backgroundPositionX+'; y='+s.backgroundPositionY);
});

Résultat

horizontal-tb: x=25%, calc(100% - 10px); y=10px, 40px
vertical-rl: x=25%, calc(100% - 10px); y=10px, 40px

Exécuté dans Chromium 157.0.8103.51 avec deux couches de dégradés, no-repeat explicite et un rapport de pixels de 1. Le test vérifie les positions physiques x dans deux modes d’écriture, pas l’exécution des mots-clés logiques du projet ni la compatibilité entre navigateurs.

Sources