Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / CSS

ray(): un percorso rettilineo da un’origine

Posiziona un elemento lungo una direzione con offset-distance, tenendo facoltativamente conto delle sue dimensioni.

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

Sintassi

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

ray() definisce un percorso rettilineo per offset-path; da sola non avvia un’animazione. L’angolo parte verso l’alto a 0deg e cresce in senso orario: 90deg punta quindi a destra. at stabilisce l’origine, mentre offset-distance sceglie la posizione sul percorso. offset-anchor sceglie il punto dell’elemento mobile collocato lì; offset-rotate ne controlla l’orientamento.

La parola chiave di dimensione determina la distanza rappresentata dal 100%. closest-side usa la distanza dal lato più vicino; altre parole usano distanze diverse da lati o angoli. contain accorcia il percorso di metà della dimensione maggiore dell’elemento, senza scendere sotto zero. È utile per il quadrato ancorato al centro di questo esempio, ma non garantisce che ogni forma, ancoraggio e rotazione restino nel contenitore.

L’esempio misura prima un contenitore di 200×200, poi aggiunge un quadrato di 20×20 con ancoraggio centrale e rotazione fissa a 0deg. Alle distanze 0%, 50% e 100%, il suo centro si trova rispettivamente in (100,100), (150,100) e (200,100). Aggiungere contain sposta il centro finale a (190,100), mantenendo questo quadrato entro il bordo destro. La misura del contenitore prima dell’inserimento stabilisce la geometria di riferimento per la prima lettura.

Esempi

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%)'));

Risultato

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

Verificato in Chromium 157.0.8103.51. Offri un posizionamento normale alternativo per i browser non compatibili; si verificano distanze statiche, non la fluidità delle animazioni né tutte le varianti di dimensione.

Fonti