offset

Baseline 2023

Newly available

Since August 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

Experimental: Esta é uma tecnologia experimental (en-US)
Verifique a tabela de compatibilidade entre Navegadores cuidadosamente antes de usar essa funcionalidade em produção.

A propriedade CSS offset é uma propriedade abreviada para animar um elemento ao longo de um caminho definido.

Nota: As primeiras versões da especificação chamam essa propriedade de motion.

Initial valueas each of the properties of the shorthand:
Aplica-se aqualquer elemento transformavel
Inheritednão
Percentagesas each of the properties of the shorthand:
Computed valueas each of the properties of the shorthand:
Animation type (en-US)as each of the properties of the shorthand:
Creates stacking contextyes

Sintaxe

css
/* Posição do offset */
offset: auto
offset: 10px 30px;
offset: none;

/* Caminho do offset */
offset: ray(45deg closest-side);
offset: path(M 100 100 L 300 100 L 200 300 z);
offset: url(arc.svg);

/* Caminho do offset com distância e/ou rotação */
offset: url(circle.svg) 100px;
offset: url(circle.svg) 40%;
offset: url(circle.svg) 30deg;
offset: url(circle.svg) 50px 20deg;

/* Incluindo âncora no offset */
offset: ray(45deg closest-side) / 40px 20px;
offset: url(arc.svg) 2cm / 0.5cm 3cm;
offset: url(arc.svg) 30deg / 50px 100px;

Sintaxe formal

offset = 
  [ (en-US) <'offset-position'>? (en-US) [ (en-US) <'offset-path'> [ (en-US) <'offset-distance'> || (en-US) <'offset-rotate'> ] (en-US)? (en-US) ] (en-US)? (en-US) ]! [ (en-US) / <'offset-anchor'> ] (en-US)? (en-US)

Exemplo

HTML

html
<div id="offsetElement"></div>

CSS

css
@keyframes move {
  from {
    offset-distance: 0%;
  }

  to {
    offset-distance: 100%;
  }
}

#offsetElement {
  width: 50px;
  height: 50px;
  background-color: blue;
  offset: path("M 100 100 L 300 100 L 200 300 z") auto;
  animation: move 3s linear infinite;
}

Resultado

Especificações

Specification
Motion Path Module Level 1
# offset-shorthand

Compatibilidade com navegadores

BCD tables only load in the browser