steps() CSS-Funktion

Syntax

/* Different intervals */
steps(2, end)
steps(4, jump-end)
steps(12, end)

/* Different jump positions */
steps(3, jump-start)
steps(3, jump-end)
steps(3, jump-none)
steps(3, jump-both)

Parameter

Die Funktion akzeptiert die folgenden Parameter:

<integer>

Repräsentiert die Anzahl der gleichmäßigen Intervalle oder 'Schritte'. Es muss eine positive ganze Zahl größer als 0 sein, es sei denn, der zweite Parameter ist jump-none, in diesem Fall muss es eine positive ganze Zahl größer als 1 sein.

<step-position>

Gibt an, wann der Sprung zwischen den Werten erfolgt. Wenn dieser Parameter ausgelassen wird, ist der Standardwert end. Die möglichen Schlüsselwortwerte sind:

jump-start oder start

Gibt an, dass der erste Schritt erfolgt, wenn die Animation beginnt.

jump-end oder end

Gibt an, dass der letzte Schritt erfolgt, wenn die Animation endet.

jump-none

Gibt an, dass weder frühe noch späte Sprünge stattfinden.

jump-both

Gibt an, dass sowohl frühe als auch späte Sprünge stattfinden.

Beschreibung

Die steps()-Funktion unterteilt die Animationsdauer in gleiche Intervalle. Zum Beispiel: steps(4, end) unterteilt die Animation in vier gleiche Intervalle, wobei die Werte am Ende jedes Intervalls geändert werden, außer der letzten Änderung, die am Ende der Animation erfolgt.

Wenn eine Animation mehrere Segmente enthält, gilt die angegebene Anzahl an Schritten für jedes Segment. Zum Beispiel, wenn eine Animation drei Segmente hat und steps(2) verwendet, gibt es insgesamt sechs Schritte, mit zwei Schritten pro Segment.

Das folgende Bild zeigt die Wirkung verschiedener <step-position>-Werte, wenn die Sprünge auftreten:

steps(2, jump-start)  /* Or steps(2, start) */
steps(4, jump-end)    /* Or steps(4, end) */
steps(5, jump-none)
steps(3, jump-both)

Formale Syntax

<steps()> = 
  steps( <integer> , <step-position>? )  

<integer> = 
  <number-token>  

<step-position> = 
  jump-start  |
  jump-end    |
  jump-none   |
  jump-both   |
  start       |
  end         

Beispiele

Verwendung der steps()-Funktion

Die folgenden steps()-Funktionen sind gültig:

/* Five steps with jump at the end */
steps(5, end)

/* Two steps with jump at the start */
steps(2, start)

/* Using default second parameter */
steps(2)

Die folgenden steps()-Funktionen sind ungültig:

/* First parameter must be an <integer>, not a real value */
steps(2.0, jump-end)

/* Number of steps must be positive */
steps(-3, start)

/* Number of steps must be at least 1 */
steps(0, jump-none)

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Andere Easing-Funktionen: cubic-bezier() und linear()
• CSS-Easing-Funktionen-Modul
• Schritt-Funktion auf Wikipedia