WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

offset-position — Startposition des Pfads

Bei einer Pfadfunktion, die die Startposition der Bewegung verwendet, etwa `ray()`, kann `offset-position` diese Position vorgeben, wenn das optionale Positionsargument fehlt. `inset()` hat kein solches Argument und leitet den Umriss des Pfads aus der Referenzbox ab.

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

Syntax

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

offset-position gilt für transformierbare Elemente und wird nicht vererbt. Der Anfangswert ist normal: Es wird keine Startposition vorgegeben; ray() beginnt dann standardmäßig in der Mitte.

auto wählt die obere linke Ecke des eigenen Elementrahmens. <position>, zum Beispiel left top oder 25% 50%, legt dagegen einen Punkt relativ zum umgebenden Block fest. Prozentwerte beziehen sich auf dessen Abmessungen, ohne die Größe des Elements abzuziehen.

Ein explizites at <position> in ray() hat Vorrang. offset-distance legt die Entfernung entlang des Pfads fest; offset-anchor bestimmt den Punkt des Elements, der dort platziert wird. Bei offset-path: none gibt es keine Pfadtransformation.

Beispiele

<!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>

Ergebnis

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

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen