CKTIS / JavaScript
WAAPI: Schlüsselbild-Arrays und Zeitoptionen
Übergib ein Array mit Schlüsselbildern an `Element.animate()`. Ein separates Optionsobjekt legt Dauer, Verlauf und Anzahl der Durchläufe fest.
Version: Current web platform; runtime support varies
Syntax
element.animate(keyframes, { duration, easing, iterations })
element.animate(keyframes, duration)element.animate(keyframes, options) erstellt und startet eine Animation für ein DOM-Element und gibt das Animation-Objekt zurück. Die Methode und ihre Zeitoptionen gehören zur Web Animations API (WAAPI), nicht zu ECMAScript 2024 oder einer anderen ECMAScript-Ausgabe. Ihre Verfügbarkeit hängt von der Laufzeitumgebung ab.
In einem Schlüsselbild-Array gibt jedes Objekt Werte für animierbare CSS-Eigenschaften wie opacity an einem Punkt des Durchlaufs vor. offset legt diesen Punkt im Bereich von 0 bis einschließlich 1 fest. Explizite Offsets dürfen der Reihe nach nicht kleiner werden. Fehlende Offsets werden gleichmäßig verteilt: Drei Schlüsselbilder ohne Offsets erhalten 0, 0.5 und 1. Ein einzelnes Objekt mit Werte-Arrays pro Eigenschaft, etwa { opacity: [0, 1] }, ist ein anderes unterstütztes Format.
In den Optionen bezeichnet ein numerischer duration-Wert die Dauer eines Durchlaufs in Millisekunden. Eine Zahl als zweites Argument ist die Kurzform, um nur duration zu setzen. iterations gibt die Gesamtzahl der Durchläufe an: Standard ist 1, 2.5 bedeutet zwei volle und einen halben dritten Durchlauf, und der Zahlenwert Infinity setzt keine endliche Obergrenze. Bei positivem, endlichem duration und endlichem iterations beträgt die aktive Dauer duration * iterations, ohne Verzögerungen.
easing im Optionsobjekt ist eine CSS-Verlaufsfunktion als Zeichenkette; Standard ist "linear". Sie ändert den Fortschrittsverlauf über einen ganzen Durchlauf, nicht dessen Dauer. easing in einem Schlüsselbild gilt von diesem bis zum nächsten Schlüsselbild; beide Einstellungen können zusammenwirken.
Beispiele
<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>WAAPI keyframes and timing</title>
<script>
(() => {
const element = document.createElement("div");
const keyframes = [
{ opacity: 0 },
{ opacity: 1, easing: "ease-in" },
{ opacity: 0 },
];
const animation = element.animate(keyframes, {
duration: 600,
easing: "ease-in-out",
iterations: 2.5,
});
const effect = animation.effect;
const { duration, easing, iterations, activeDuration } = effect.getComputedTiming();
const offsets = effect.getKeyframes().map(frame => frame.computedOffset);
console.log(`Offsets: ${offsets.join(", ")}`);
console.log(`${duration} ms × ${iterations} = ${activeDuration} ms; easing: ${easing}`);
animation.cancel();
})();
</script>
</html>Ergebnis
Offsets: 0, 0.5, 1 600 ms × 2.5 = 1500 ms; easing: ease-in-out
Speichere das Beispiel als HTML-Datei, öffne sie in einem Browser mit WAAPI-Unterstützung und prüfe die Ausgabe in der Entwicklerkonsole. Das Element wird nicht in die Seite eingefügt: Das Beispiel gibt die berechneten Offsets und Zeitwerte ohne Wartezeit aus und bricht dann die Animation ab.
Zugehörige Lektionen
- JavaScript · Lektion 29 · Mittlere Stufe · Version: 3