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

CKTIS / CSS

ray() : une trajectoire droite depuis une origine

Placez un élément dans une direction avec offset-distance, en tenant éventuellement compte de sa taille.

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

Syntaxe

offset-path: ray(90deg closest-side contain at 50% 50%); offset-distance: 100%;

ray() définit une trajectoire droite pour offset-path ; elle ne lance pas d’animation à elle seule. L’angle commence vers le haut à 0deg et tourne dans le sens horaire : 90deg pointe donc à droite. at fixe l’origine et offset-distance choisit la position sur la trajectoire. offset-anchor choisit le point de l’élément placé à cet endroit ; offset-rotate règle son orientation.

Le mot-clé de taille détermine la distance représentée par 100%. closest-side utilise la distance au côté le plus proche ; les autres mots-clés emploient d’autres distances aux côtés ou aux coins. contain raccourcit la trajectoire de la moitié de la plus grande dimension de l’élément, sans descendre sous zéro. Cela convient au carré ancré en son centre de cet exemple, mais ne garantit pas le confinement de toute forme, de tout ancrage ou de toute rotation.

L’exemple mesure d’abord un conteneur de 200×200, puis ajoute un carré de 20×20 avec ancrage central et rotation fixée à 0deg. Aux distances 0%, 50% et 100%, son centre est respectivement (100,100), (150,100) et (200,100). Ajouter contain place le centre final en (190,100), gardant ce carré à l’intérieur du bord droit. Mesurer le conteneur avant l’insertion établit la géométrie de référence pour la première lecture.

Exemples

const stage=document.createElement('div');stage.style.cssText='position:fixed;left:0;top:0;width:200px;height:200px';
document.body.append(stage);stage.getBoundingClientRect();
const box=document.createElement('div');box.style.cssText='position:absolute;left:0;top:0;width:20px;height:20px;offset-anchor:center;offset-rotate:0deg;offset-path:ray(90deg closest-side at 50% 50%)';stage.append(box);
const center=distance=>{box.style.offsetDistance=distance;const r=box.getBoundingClientRect();return (r.x+r.width/2).toFixed(0)+','+(r.y+r.height/2).toFixed(0)};
const start=center('0%'),half=center('50%'),end=center('100%');
box.style.offsetPath='ray(90deg closest-side contain at 50% 50%)';
console.log('start='+start+'; half='+half+'; end='+end+'; contain-end='+center('100%')+'; size='+box.offsetWidth+'x'+box.offsetHeight+'; supported='+CSS.supports('offset-path','ray(90deg closest-side contain at 50% 50%)'));

Résultat

start=100,100; half=150,100; end=200,100; contain-end=190,100; size=20x20; supported=true

Vérifié dans Chromium 157.0.8103.51. Prévoyez un positionnement normal de secours pour les navigateurs incompatibles ; le test couvre des distances statiques, pas la fluidité des animations ni toutes les tailles de trajectoire.

Sources