cubic-bezier()

Syntax

cubic-bezier(0.25, 0.1, 0.25, 1)
cubic-bezier(0.1, -0.6, 0.2, 0)
cubic-bezier(0, 0, 1, 1)

Parameter

Die Funktion akzeptiert die folgenden vier Parameter, die die Koordinaten von zwei Kontrollpunkten darstellen:

<x1>

Eine <number>, die die x-Achsen-Koordinate des ersten Kontrollpunkts darstellt. Sie muss im Bereich [0, 1] liegen.

<y1>

Eine <number>, die die y-Achsen-Koordinate des ersten Kontrollpunkts darstellt.

<x2>

Eine <number>, die die x-Achsen-Koordinate des zweiten Kontrollpunkts darstellt. Sie muss im Bereich [0, 1] liegen.

<y2>

Eine <number>, die die y-Achsen-Koordinate des zweiten Kontrollpunkts darstellt.

Beschreibung

Die kubischen Bézier-Funktionen, oft als "sanfte" Easing-Funktionen bezeichnet, korrelieren einen Eingabefortschritt mit einem Ausgabefortschritt, beide ausgedrückt als <number>s, wobei 0.0 den Anfangszustand und 1.0 den Endzustand darstellt. Wenn die kubische Bézier-Kurve ungültig ist, ignoriert CSS die gesamte Eigenschaft.

Eine kubische Bézier-Kurve wird durch vier Punkte definiert: P0, P1, P2 und P3. Die Punkte P0 und P3 stellen den Anfang und das Ende der Kurve dar. Im CSS ist der Startpunkt P0 fest bei (0, 0) und der Endpunkt P3 fest bei (1, 1), während die Zwischenpunkte P1 und P2 durch die Funktionsparameter (<x1>, <y1>) und (<x2>, <y2>) definiert werden. Die x-Achse repräsentiert den Eingabefortschritt und die y-Achse den Ausgabefortschritt.

Nicht alle kubischen Bézier-Kurven sind als Easing-Funktionen geeignet, weil nicht alle mathematische Funktionen sind; d.h. Kurven, die für eine gegebene x-Achsen-Koordinate null oder einen Wert haben. Mit P0 und P3 wie von CSS definiert fixiert, ist eine kubische Bézier-Kurve eine Funktion und daher gültig, wenn und nur wenn die x-Achsen-Koordinaten von P1 und P2 beide im Bereich [0, 1] liegen.

Kubische Bézier-Kurven mit der Ordinate von P1 oder P2 außerhalb des Bereichs [0, 1] können dazu führen, dass der Wert über den Endzustand hinausgeht und dann zurückkehrt. In Animationen erzeugt dies eine Art "Federungs-" Effekt.

Bestimmte Eigenschaften schränken jedoch die Ausgabe ein, wenn sie außerhalb eines zulässigen Bereichs liegt. Zum Beispiel wird eine Farbkomponente, die größer als 255 oder kleiner als 0 in rgb() ist, auf den nächstgelegenen zulässigen Wert (255 bzw. 0) gekappt. Einige cubic-bezier()-Werte weisen diese Eigenschaft auf.

Formale Syntax

<cubic-bezier()> = 
  cubic-bezier( [ <number [0,1]> , <number> ]#{2} )  

Beispiele

Federungseffekt

In diesem Beispiel springt die rote Kugel aus der Box, wenn sie von ihrer ursprünglichen Position verschoben wird. Dies liegt daran, dass einer der P2-Werte, 2.3, über den Bereich [0, 1] hinausgeht.

<div tabindex="0">
  <span></span>
</div>

div {
  margin: 8px auto;
  padding: 8px;
  width: 256px;
  border-radius: 40px;
  background-color: wheat;
}

span {
  display: block;
  width: 64px;
  height: 64px;
  border-radius: 50%;
  background: tomato;
}

div:hover span,
div:focus span {
  translate: 192px 0;
}

span {
  transition: translate 0.3s cubic-bezier(0.3, 0.8, 0.3, 2.3);
}

Verwendung der cubic-bezier() Funktion

Diese kubischen Bézier-Kurven sind zur Verwendung in CSS gültig:

/* The canonical Bézier curve with four <number> in the [0,1] range */
cubic-bezier(0.1, 0.7, 1.0, 0.1)

/* Using <integer> is valid because any <integer> is also a <number> */
cubic-bezier(0, 0, 1, 1)

/* Negative values for ordinates are valid, leading to bouncing effects */
cubic-bezier(0.1, -0.6, 0.2, 0)

/* Values greater than 1.0 for ordinates are also valid */
cubic-bezier(0, 1.1, 0.8, 4)

Diese Definitionen der kubischen Bézier-Kurven sind ungültig:

/* Parameters must be numbers */
cubic-bezier(0.1, red, 1.0, green)

/* X coordinates must be in the [0, 1] range */
cubic-bezier(2.45, 0.6, 4, 0.1)

/* There must be exactly four parameters */
cubic-bezier(0.3, 2.1)

/* X coordinates must be in the [0, 1] range */
cubic-bezier(-1.9, 0.3, -0.2, 2.1)

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Andere Easing-Funktionen: linear() und steps()
• CSS Easing-Funktionen-Modul
• cubic-bezier.com von Lea Verou