WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

offset-path — Positionierungspfad

offset-path legt einen geometrischen Pfad fest, entlang dessen ein Element positioniert wird. Das Festlegen eines Pfads startet weder eine Animation noch zeichnet es den Pfad.

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

Syntax

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

offset-path definiert einen Pfad für ein Element, auf das Transformationen angewendet werden können. Der Anfangswert none deaktiviert die Offset-Transformation; die Eigenschaft wird nicht vererbt. Eine Positionsänderung führt nicht dazu, dass das Layout benachbarter Elemente neu berechnet wird.

Der Pfad kann ray(), eine url()-Referenz auf eine SVG-Form oder eine <basic-shape> wie path() oder circle() sein. Ein optionales <coord-box> gibt den Bezugsrahmen an; standardmäßig ist dies border-box. Ein Rahmen allein bedeutet einen Pfad entlang seines Umfangs, einschließlich abgerundeter Ecken.

offset-distance wählt einen Punkt auf dem Pfad aus; Prozentwerte beziehen sich auf dessen Länge. offset-anchor wählt den Punkt des Elements aus, der auf dem Pfad platziert wird. Standardmäßig ist offset-rotate auf auto gesetzt und dreht das Element entsprechend der Pfadrichtung; 0deg deaktiviert diese Drehung. Um Bewegung zu erzeugen, animiere offset-distance, statt lediglich einen Pfad festzulegen.

Beispiele

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

Ergebnis

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.

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