SVGSVGElement: setCurrentTime()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Die setCurrentTime()-Methode des SVGSVGElement-Interfaces passt die Uhr für dieses SVG-Dokumentfragment an und legt eine neue aktuelle Zeit fest.

Wenn setCurrentTime() aufgerufen wird, bevor die Dokument-Zeitachse begonnen hat (zum Beispiel durch ein Skript, das in einem <script>-Element ausgeführt wird, bevor das SVGLoad-Ereignis des Dokuments ausgelöst wird), dann gibt der Wert der Sekunden beim letzten Aufruf der Methode die Zeit an, zu der das Dokument nach Beginn der Dokument-Zeitachse wechseln wird.

Syntax

js
setCurrentTime(time)

Parameter

time

Ein Float, der die Zeit in Sekunden repräsentiert, um die aktuelle Zeit festzulegen.

Rückgabewert

Keiner.

Beispiele

Die aktuelle Zeit einstellen

html
<svg
  id="exampleSVG"
  width="200"
  height="200"
  xmlns="http://www.w3.org/2000/svg">
  <circle id="circle1" cx="100" cy="100" r="50" fill="blue" />
</svg>
<button id="setTimeButton">Set Current Time</button>
<p id="currentTimeDisplay"></p>
js
const svgElement = document.getElementById("exampleSVG");
const setTimeButton = document.getElementById("setTimeButton");
const currentTimeDisplay = document.getElementById("currentTimeDisplay");

setTimeButton.addEventListener("click", () => {
  // Setting the time to 5 seconds
  svgElement.setCurrentTime(5);
  const currentTime = svgElement.getCurrentTime();
  currentTimeDisplay.textContent = `Current time in the SVG: ${currentTime} seconds`;
});

Spezifikationen

Specification
SVG Animations Level 2
# __svg__SVGSVGElement__setCurrentTime

Browser-Kompatibilität

BCD tables only load in the browser