offset-distance

Experimental

Cette fonction est expérimentale
Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

La propriété offset-distance définit une position le long d'un chemin offset-path.

Syntaxe

/* Valeur par défaut */
offset-distance: 0;

/* La position à la moitié de offset-path */
offset-distance: 50%;

/* Une position absolue le long du chemin */
offset-distance: 40px;
<length-percentage>
Une longueur qui définit l'emplacement de l'élément le long du chemin (défini par offset-path).
La valeur 100% représente la longueur totale du chemin (lorsque offset-path est défini par une forme simple ou grâce à la fonction path()).

Syntaxe formelle

<length-percentage>


<length-percentage> = <length> | <percentage>

Exemples

Animation

La notion de mouvement contenue dans CSS Motion Path vient principalement de la propriété offset-distance. Si on souhaite animer un élément le long du chemin, on définira un chemin avec offset-path et on utilisera une animation qui fera évoluer offset-distance de 0% à 100%.

HTML

<div id="motion-demo"></div>

CSS

#motion-demo {
  offset-path: path('M20,20 C20,100 200,0 200,100');
  animation: move 3000ms infinite alternate ease-in-out;
  width: 40px;
  height: 40px;
  background: cyan;
}

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

Résultat

Spécifications

Spécification État Commentaires
Motion Path Module Level 1
La définition de 'offset-distance' dans cette spécification.
Version de travail Définition initiale.

Valeur initiale0
Applicabilitééléments transformables
Héritéenon
Pourcentagesse rapporte à la longueur totale du chemin
Valeur calculéepour une valeur de type length sa valeur absolue, sinon un pourcentage
Type d'animationune longueur, pourcentage ou calc() ;

Note : Dans les versions antérieures de la spécification, cette propriété était intitulée motion-offset.

Compatibilité des navigateurs

BCD tables only load in the browser