Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

offset-path — caminho de posicionamento

offset-path define um caminho geométrico para posicionar um elemento. Definir um caminho não inicia uma animação nem desenha o caminho.

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

Sintaxe

offset-path: none | [ <offset-path> || <coord-box> ];
<offset-path> = <ray()> | <url> | <basic-shape>

offset-path define um caminho para um elemento transformável. O seu valor inicial, none, desativa a transformação de offset; a propriedade não é herdada. O reposicionamento não recalcula a disposição dos elementos vizinhos.

O caminho pode ser ray(), uma referência url() a uma forma SVG ou uma <basic-shape>, como path() ou circle(). Um <coord-box> opcional especifica a caixa de referência; por predefinição, é border-box. Uma caixa por si só representa um caminho ao longo do seu perímetro, incluindo os cantos arredondados.

offset-distance seleciona um ponto no caminho; as percentagens referem-se ao seu comprimento. offset-anchor seleciona o ponto do elemento colocado nesse caminho. Por predefinição, offset-rotate é auto e roda o elemento para acompanhar a direção do caminho; 0deg desativa essa rotação. Para produzir movimento, anime offset-distance, em vez de apenas definir um caminho.

Exemplos

<!doctype html>
<meta charset="utf-8">
<title>offset-path</title>
<style>
  .stage {
    position: relative;
    width: 240px;
    height: 100px;
    background: #eee;
  }
  .dot {
    position: absolute;
    left: 0;
    top: 0;
    width: 20px;
    height: 20px;
    background: #0645ad;
    offset-position: 0 0;
    offset-path: path("M 20 50 L 220 50");
    offset-distance: 50%;
    offset-anchor: center;
    offset-rotate: 0deg;
  }
</style>
<div class="stage"><div class="dot"></div></div>

Resultado

A blue 20 × 20 px square is centered at (120, 50) px inside a gray 240 × 100 px stage. The path is not drawn; nothing animates.

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes