CKTIS / CSS
ray(): um percurso reto a partir de uma origem
Posicione um elemento numa direção com offset-distance, tendo opcionalmente em conta o seu tamanho.
Versão: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required
Sintaxe
offset-path: ray(90deg closest-side contain at 50% 50%); offset-distance: 100%;ray() define um percurso reto para offset-path; por si só não inicia uma animação. O ângulo começa para cima em 0deg e roda no sentido dos ponteiros do relógio, pelo que 90deg aponta para a direita. at estabelece a origem e offset-distance escolhe a posição no percurso. offset-anchor escolhe o ponto do elemento móvel colocado aí; offset-rotate controla a sua orientação.
A palavra-chave de tamanho determina a distância representada por 100%. closest-side usa a distância ao lado mais próximo; outras palavras usam diferentes distâncias a lados ou cantos. contain encurta o percurso em metade da maior dimensão do elemento, nunca abaixo de zero. É útil para o quadrado ancorado ao centro deste exemplo, mas não garante que todas as formas, âncoras e rotações permaneçam dentro do contentor.
O exemplo mede primeiro um contentor de 200×200 e depois acrescenta um quadrado de 20×20 com âncora central e rotação fixa em 0deg. Nas distâncias 0%, 50% e 100%, o seu centro fica respetivamente em (100,100), (150,100) e (200,100). Acrescentar contain leva o centro final para (190,100), mantendo este quadrado dentro do limite direito. Medir o contentor antes de inserir o quadrado estabelece a geometria de referência para a primeira leitura.
Exemplos
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%)'));Resultado
start=100,100; half=150,100; end=200,100; contain-end=190,100; size=20x20; supported=true
Verificado no Chromium 157.0.8103.51. Disponibilize posicionamento normal como alternativa em browsers incompatíveis; o teste verifica distâncias estáticas, não a fluidez da animação nem todas as variantes de tamanho.