Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / CSS

offset-position — position de départ du chemin

Pour une fonction de chemin qui utilise la position de départ du mouvement, comme `ray()`, `offset-position` peut fournir cette position lorsque l’argument de position facultatif est omis. `inset()` ne prend pas cet argument et détermine le contour du chemin à partir de la boîte de référence.

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

Syntaxe

offset-position: normal | auto | <position>;

offset-position s’applique aux éléments transformables et n’est pas héritée. Sa valeur initiale est normal : aucune position de départ n’est fournie ; ray() commence alors par défaut au centre.

auto sélectionne le coin supérieur gauche de la boîte propre de l’élément. En revanche, <position>, par exemple left top ou 25% 50%, sélectionne un point par rapport au bloc conteneur. Les pourcentages utilisent ses dimensions, sans soustraire la taille de l’élément.

Un at <position> explicite dans ray() est prioritaire. offset-distance définit la distance parcourue le long du chemin ; offset-anchor sélectionne le point de l’élément placé à cet endroit. Avec offset-path: none, aucune transformation de décalage n’a lieu.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Setting a motion path starting position</title>
  <style>
    .stage { position: relative; width: 200px; height: 120px; background: #eee; }
    #dot {
      position: absolute;
      top: 0;
      left: 0;
      width: 10px;
      height: 10px;
      background: #064;
      offset-path: ray(90deg);
      offset-position: 25% 50%;
      offset-distance: 20px;
      offset-anchor: left top;
      offset-rotate: 0deg;
    }
  </style>
</head>
<body>
  <p>The ray omits an explicit starting position so that <code>offset-position</code> can supply one. This example checks syntax and computed style, not the ray's rendered origin.</p>
  <div class="stage" aria-hidden="true"><div id="dot"></div></div>
  <script>
    if (CSS.supports('offset-position', '25% 50%')) {
      const value = getComputedStyle(document.getElementById('dot')).getPropertyValue('offset-position');
      console.log(`offset-position syntax: supported; computed value: ${value}`);
    } else {
      console.log('offset-position syntax: unsupported');
    }
  </script>
</body>
</html>

Résultat

offset-position syntax: supported; computed value: 25% 50%

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources