mpath

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

O sub elemento mpath do elemento <animateMotion> fornece a habilidade de referenciar um elemento externo <path> como uma definição de um caminho de movimento.

Contexto de uso

Categorias	Elemento de animação
Conteúdo permitido	Qualquer número dos seguintes elementos, em qualquer ordem: Elementos descritivos

Exemplo

html

<svg
  width="100%"
  height="100%"
  viewBox="0 0 500 300"
  xmlns="https://www.w3.org/2000/svg"
  xmlns:xlink="https://www.w3.org/1999/xlink">
  <rect
    x="1"
    y="1"
    width="498"
    height="298"
    fill="none"
    stroke="blue"
    stroke-width="2" />

  <!-- Desenha o contorno da trajetória de movimento em azul, ao longo, com três pequenos círculos: inicio, meio e fim. -->
  <path
    id="path1"
    d="M100,250 C 100,50 400,50 400,250"
    fill="none"
    stroke="blue"
    stroke-width="7.06" />
  <circle cx="100" cy="250" r="17.64" fill="blue" />
  <circle cx="250" cy="100" r="17.64" fill="blue" />
  <circle cx="400" cy="250" r="17.64" fill="blue" />

  <!-- Aqui temos um triângulo que andará sobre o caminho do movimento.
       Define-se com uma orientação vertical com base no triângulo horizontalmente centralizado logo acima da origem. -->
  <path
    d="M-25,-12.5 L25,-12.5 L 0,-87.5 z"
    fill="yellow"
    stroke="red"
    stroke-width="7.06">
    <!-- Define o caminho de movimento da animação -->
    <animateMotion dur="6s" repeatCount="indefinite" rotate="auto">
      <mpath xlink:href="#path1" />
    </animateMotion>
  </path>
</svg>

Resultado:

Atributos

Atributos específicos

xlink:href

Interface DOM

Este elemento implementa a interface do SVGMPathElement.

Relacionado

<animateMotion>