SVGSVGElement

Baseline Widely available *

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

* Some parts of this feature may have varying levels of support.

Die SVGSVGElement-Schnittstelle bietet Zugriff auf die Eigenschaften von <svg>-Elementen sowie Methoden zu deren Manipulation. Diese Schnittstelle enthält außerdem verschiedene häufig verwendete Hilfsmethoden, wie Matrixoperationen und die Möglichkeit, die Zeit der Neuzeichnung auf visuellen Rendering-Geräten zu steuern.

EventTarget Node Element SVGElement SVGGraphicsElement SVGSVGElement

Instanz-Eigenschaften

Diese Schnittstelle erbt auch Eigenschaften von ihrem Elternteil, SVGGraphicsElement.

SVGSVGElement.x Schreibgeschützt

Ein SVGAnimatedLength, das dem x-Attribut des gegebenen <svg>-Elements entspricht.

SVGSVGElement.y Schreibgeschützt

Ein SVGAnimatedLength, das dem y-Attribut des gegebenen <svg>-Elements entspricht.

SVGSVGElement.width Schreibgeschützt

Ein SVGAnimatedLength, das dem width-Attribut des gegebenen <svg>-Elements entspricht.

SVGSVGElement.height Schreibgeschützt

Ein SVGAnimatedLength, das dem height-Attribut des gegebenen <svg>-Elements entspricht.

SVGSVGElement.viewBox Schreibgeschützt

Ein SVGAnimatedRect, das dem viewBox-Attribut des gegebenen <svg>-Elements entspricht.

SVGSVGElement.preserveAspectRatio Schreibgeschützt

Ein SVGAnimatedPreserveAspectRatio, das dem preserveAspectRatio-Attribut des gegebenen <svg>-Elements entspricht.

SVGSVGElement.pixelUnitToMillimeterX Veraltet

Ein Float, der die Größe der Pixeleinheit (wie von CSS2 definiert) entlang der x-Achse des Viewports darstellt, was eine Einheit irgendwo im Bereich von 70dpi bis 120dpi repräsentiert und auf Systemen, die dies unterstützen, tatsächlich den Eigenschaften des Zielmediums entsprechen könnte. Auf Systemen, bei denen es unmöglich ist, die Größe eines Pixels zu kennen, wird eine geeignete Standardpixelgröße bereitgestellt.

SVGSVGElement.pixelUnitToMillimeterY Veraltet

Ein Float, der die Größe einer Pixeleinheit entlang der y-Achse des Viewports darstellt.

SVGSVGElement.screenPixelToMillimeterX Veraltet

Benutzeroberfläche (UI)-Ereignisse in DOM Level 2 geben die Bildschirmpositionen an, an denen das gegebene UI-Ereignis aufgetreten ist. Wenn der Browser die physische Größe einer "Bildschirmeinheit" tatsächlich kennt, wird dieses Float-Attribut diese Information ausdrücken; andernfalls werden Benutzeragenten einen geeigneten Standardwert bereitstellen (wie z.B. .28mm).

SVGSVGElement.screenPixelToMillimeterY Veraltet

Entsprechende Größe eines Bildschirmpixels entlang der y-Achse des Viewports.

SVGSVGElement.useCurrentView Veraltet Nicht standardisiert

Die anfängliche Ansicht (d.h. vor Vergrößerung und Verschiebung) des innersten SVG-Dokumentfragments kann entweder die "Standard"-Ansicht sein, d.h. basierend auf Attributen am <svg>-Element wie viewBox oder auf einer "benutzerdefinierten" Ansicht (d.h. ein Hyperlink zu einem bestimmten <view>- oder anderem Element). Wenn die anfängliche Ansicht die "Standard"-Ansicht ist, dann ist dieses Attribut false. Wenn die anfängliche Ansicht eine "benutzerdefinierte" Ansicht ist, dann ist dieses Attribut true.

SVGSVGElement.currentView Veraltet Nicht standardisiert

Ein SVGViewSpec, das die anfängliche Ansicht (d.h. vor Vergrößerung und Verschiebung) des aktuellen innersten SVG-Dokumentfragments definiert. Die Bedeutung hängt von der Situation ab:

Wenn die anfängliche Ansicht eine "Standardansicht" war, dann:

  • stimmen die Werte für viewBox, preserveAspectRatio und zoomAndPan in currentView mit den Werten der entsprechenden DOM-Attribute überein, die sich direkt auf SVGSVGElement befinden
  • der Wert für transform innerhalb von currentView wird null sein

Wenn die anfängliche Ansicht ein Link in ein <view>-Element war, dann:

  • entsprechen die Werte für viewBox, preserveAspectRatio und zoomAndPan innerhalb von currentView den entsprechenden Attributen für das gegebene <view>-Element
  • der Wert für transform innerhalb von currentView wird null sein

Wenn die anfängliche Ansicht ein Link in ein anderes Element war (d.h. ein anderes als ein <view>), dann:

  • stimmen die Werte für viewBox, preserveAspectRatio und zoomAndPan in currentView mit den Werten der entsprechenden DOM-Attribute überein, die sich direkt auf SVGSVGElement für das nächste Vorfahren-<svg>-Element befinden
  • die Werte für transform innerhalb von currentView werden null sein

Wenn die anfängliche Ansicht ein Link in das SVG-Dokumentfragment unter Verwendung eines SVG-Viewer-Spezifikations-Fragmentidentifikators war (d.h. #svgView(…)), dann:

  • werden die Werte für viewBox, preserveAspectRatio, zoomAndPan und transform in currentView den Werten aus dem SVG-Viewer-Spezifikations-Fragmentidentifikator entsprechen
SVGSVGElement.currentScale

Auf einem äußersten <svg>-Element gibt dieses Float-Attribut den aktuellen Skalierungsfaktor relativ zur anfänglichen Ansicht an, um Benutzervergrößerungen und -verschiebungen zu berücksichtigen. DOM-Attribute currentScale und currentTranslate entsprechen der 2×3-Matrix [a b c d e f] = [currentScale 0 0 currentScale currentTranslate.x currentTranslate.y]. Wenn "Vergrößerung" aktiviert ist (d.h. zoomAndPan="magnify"), dann ist die Wirkung so, als ob eine zusätzliche Transformation auf der äußersten Ebene des SVG-Dokumentfragments platziert wäre (d.h. außerhalb des äußersten <svg>-Elements).

SVGSVGElement.currentTranslate Schreibgeschützt

Ein DOMPointReadOnly, der den Verschiebungsfaktor darstellt, der der Benutzer-"Vergrößerung" entspricht, und zwar auf ein äußerstes <svg>-Element. Das Verhalten ist für <svg>-Elemente, die sich nicht auf der äußersten Ebene befinden, nicht definiert.

Instanz-Methoden

Diese Schnittstelle erbt auch Methoden von ihrem Elternteil, SVGGraphicsElement.

SVGSVGElement.suspendRedraw() Veraltet

Nimmt einen Timeout-Wert an, der angibt, dass eine Neuzeichnung nicht stattfinden soll, bis:

der entsprechende unsuspendRedraw()-Aufruf gemacht wurde, ein unsuspendRedrawAll()-Aufruf gemacht wurde oder sein Timer abgelaufen ist.

In Umgebungen, die Interaktivität nicht unterstützen (z.B. Druckmedien), soll die Neuzeichnung nicht ausgesetzt werden. Aufrufe zu suspendRedraw() und unsuspendRedraw() sollten, müssen aber nicht in abgestimmten Paaren gemacht werden.

Um Neuzeichnungsaktionen auszusetzen, während eine Sammlung von SVG-DOM-Änderungen stattfindet, sollten die Änderungen am SVG-DOM mit einem Methodenaufruf, ähnlich wie:

js
const suspendHandleID = suspendRedraw(maxWaitMilliseconds);

eingeleitet und die Änderungen mit einem Methodenaufruf, ähnlich wie:

js
unsuspendRedraw(suspendHandleID);

abgeschlossen werden.

Beachten Sie, dass mehrere suspendRedraw()-Aufrufe gleichzeitig verwendet werden können und dass jeder dieser Methodenaufrufe unabhängig von den anderen suspendRedraw()-Methodenaufrufen behandelt wird.

SVGSVGElement.unsuspendRedraw() Veraltet

Hebt ein angegebenes suspendRedraw() auf, indem eine eindeutige Aussetz-Handle-ID bereitgestellt wird, die von einem vorhergehenden suspendRedraw()-Aufruf zurückgegeben wurde.

SVGSVGElement.unsuspendRedrawAll() Veraltet

Hebt alle derzeit aktiven suspendRedraw()-Methodenaufrufe auf. Diese Methode ist besonders nützlich am Ende einer Reihe von SVG-DOM-Aufrufen, um sicherzustellen, dass alle ausstehenden suspendRedraw()-Methodenaufrufe aufgehoben wurden.

SVGSVGElement.forceRedraw() Veraltet

In Rendering-Umgebungen, die Interaktivität unterstützen, zwingt der Benutzeragent, sofort alle Bereiche des Viewports erneut zu zeichnen, die aktualisiert werden müssen.

SVGSVGElement.pauseAnimations()

Hält (d.h. pausiert) alle derzeit laufenden Animationen an, die innerhalb des SVG-Dokumentfragments definiert sind, das diesem <svg>-Element entspricht, und bewirkt, dass die Animationsuhr des Dokumentfragments bis zum Fortsetzen stillsteht.

SVGSVGElement.unpauseAnimations()

Setzt derzeit laufende Animationen, die innerhalb des SVG-Dokumentfragments definiert sind, fort und lässt die Animationsuhr von dem Zeitpunkt an fortfahren, an dem sie angehalten wurde.

SVGSVGElement.animationsPaused()

Gibt true zurück, wenn dieses SVG-Dokumentfragment in einem pausierten Zustand ist.

SVGSVGElement.getCurrentTime()

Gibt die aktuelle Zeit in Sekunden relativ zur Startzeit des aktuellen SVG-Dokumentfragments zurück. Wenn getCurrentTime() aufgerufen wird, bevor die Dokumentzeitleiste begonnen hat (z.B. von einem Skript, das in einem <script>-Element ausgeführt wird, bevor das SVGLoad-Ereignis des Dokuments ausgelöst wird), wird 0 zurückgegeben.

SVGSVGElement.setCurrentTime()

Passt die Uhr für dieses SVG-Dokumentfragment an und legt eine neue aktuelle Zeit fest. Wenn setCurrentTime() aufgerufen wird, bevor die Dokumentzeitleiste begonnen hat (z.B. von einem Skript, das in einem <script>-Element ausgeführt wird, bevor das SVGLoad-Ereignis des Dokuments ausgelöst wird), gibt der Wert der Sekunden im letzten Aufruf dieser Methode die Zeit an, auf die das Dokument zugreift, sobald die Dokumentzeitleiste begonnen hat.

SVGSVGElement.getIntersectionList()

Gibt eine NodeList von Grafikelementen zurück, deren gerenderter Inhalt das übergebene Rechteck schneidet. Jedes Kandidaten-Grafikelement soll nur dann als Übereinstimmung betrachtet werden, wenn dasselbe Grafikelement ein Ziel von Zeigerereignissen sein kann, wie in der Verarbeitung von pointer-events definiert.

SVGSVGElement.getEnclosureList()

Gibt eine NodeList von Grafikelementen zurück, deren gerenderter Inhalt vollständig im übergebenen Rechteck enthalten ist. Jedes Kandidat-Grafikelement soll nur dann als Übereinstimmung betrachtet werden, wenn dasselbe Grafikelement ein Ziel von Zeigerereignissen sein kann, wie in der Verarbeitung von pointer-events definiert.

SVGSVGElement.checkIntersection()

Gibt true zurück, wenn der gerenderte Inhalt des gegebenen Elements das übergebene Rechteck schneidet. Jedes Kandidaten-Grafikelement soll nur dann als Übereinstimmung betrachtet werden, wenn dasselbe Grafikelement ein Ziel von Zeigerereignissen sein kann, wie in der Verarbeitung von pointer-events definiert.

SVGSVGElement.checkEnclosure()

Gibt true zurück, wenn der gerenderte Inhalt des gegebenen Elements vollständig im übergebenen Rechteck enthalten ist. Jedes Kandidat-Grafikelement soll nur dann als Übereinstimmung betrachtet werden, wenn dasselbe Grafikelement ein Ziel von Zeigerereignissen sein kann, wie in der Verarbeitung von pointer-events definiert.

SVGSVGElement.deselectAll()

Hebt die Auswahl aller ausgewählten Objekte auf, einschließlich aller Auswahlen von Textzeichenfolgen und Eingabebalken.

SVGSVGElement.createSVGNumber()

Erstellt ein SVGNumber-Objekt außerhalb irgendeines Dokumentbaums. Das Objekt wird auf 0 initialisiert.

SVGSVGElement.createSVGLength()

Erstellt ein SVGLength-Objekt außerhalb irgendeines Dokumentbaums. Das Objekt wird auf 0 Benutzerunits initialisiert.

SVGSVGElement.createSVGAngle()

Erstellt ein SVGAngle-Objekt außerhalb irgendeines Dokumentbaums. Das Objekt wird auf einen Wert von 0 Grad (einheitenlos) initialisiert.

SVGSVGElement.createSVGPoint()

Erstellt ein DOMPoint-Objekt außerhalb irgendeines Dokumentbaums. Das Objekt wird auf den Punkt (0,0) im Benutzersystemkoordinatensystem initialisiert.

SVGSVGElement.createSVGMatrix()

Erstellt ein DOMMatrix-Objekt außerhalb irgendeines Dokumentbaums. Das Objekt wird auf die Einheitsmatrix initialisiert.

SVGSVGElement.createSVGRect()

Erstellt ein SVGRect-Objekt außerhalb irgendeines Dokumentbaums. Das Objekt wird so initialisiert, dass alle Werte auf 0 Benutzerunits gesetzt sind.

SVGSVGElement.createSVGTransform()

Erstellt ein SVGTransform-Objekt außerhalb irgendeines Dokumentbaums. Das Objekt wird auf eine Identitätsmatrix-Transformation (SVG_TRANSFORM_MATRIX) initialisiert.

SVGSVGElement.createSVGTransformFromMatrix()

Erstellt ein SVGTransform-Objekt außerhalb irgendeines Dokumentbaums. Das Objekt wird auf die gegebene Matrix-Transformation (d.h. SVG_TRANSFORM_MATRIX) initialisiert. Die Werte aus der Parameter-Matrix werden kopiert, die Matrix-Parameter werden nicht als SVGTransform::matrix übernommen.

SVGSVGElement.getElementById()

Durchsucht dieses SVG-Dokumentfragment (d.h. die Suche ist auf einen Teilbaum des Dokuments beschränkt) nach einem Element, dessen id durch elementId gegeben ist. Wenn ein Element gefunden wird, wird dieses Element zurückgegeben. Wenn ein solches Element nicht existiert, wird null zurückgegeben. Das Verhalten ist nicht definiert, wenn mehr als ein Element diese ID hat.

Ereignishandler

Die folgenden onXYZ-Ereignishandler-Eigenschaften des Window sind ebenfalls als Aliase verfügbar, die auf das window-Objekt abzielen. Es wird jedoch empfohlen, sie direkt auf dem window-Objekt zu überwachen, anstatt auf SVGSVGElement.

Hinweis: Die Verwendung von addEventListener() an SVGSVGElement wird für die aufgeführten onXYZ-Ereignishandler nicht funktionieren. Hören Sie stattdessen auf die Ereignisse am window-Objekt.

SVGSVGElement.onafterprint

Wird ausgelöst, nachdem das zugehörige Dokument zu drucken begonnen hat oder die Druckvorschau geschlossen wurde.

SVGSVGElement.onbeforeprint

Wird ausgelöst, wenn das zugehörige Dokument gedruckt werden soll oder zur Vorschau angezeigt wird.

SVGSVGElement.onbeforeunload

Wird ausgelöst, wenn das Fenster, das Dokument und seine Ressourcen entladen werden sollen.

SVGSVGElement.ongamepadconnected

Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad verbunden wurde oder zum ersten Mal eine Taste/Achse des Gamepads verwendet wird.

SVGSVGElement.ongamepaddisconnected

Wird ausgelöst, wenn der Browser erkennt, dass ein Gamepad getrennt wurde.

SVGSVGElement.onhashchange

Wird ausgelöst, wenn sich der Fragmentbezeichner der URL geändert hat (der Teil der URL, der mit dem #-Symbol beginnt und darauf folgt).

SVGSVGElement.onlanguagechange

Wird ausgelöst, wenn sich die bevorzugte Sprache des Benutzers ändert.

SVGSVGElement.onmessage

Wird ausgelöst, wenn das Fenster eine Nachricht erhält, zum Beispiel durch einen Aufruf von Window.postMessage() aus einem anderen Browsing-Kontext.

SVGSVGElement.onmessageerror

Wird ausgelöst, wenn das Fenster eine Nachricht erhält, die nicht deserialisiert werden kann.

SVGSVGElement.onoffline

Wird ausgelöst, wenn der Browser den Zugang zum Netzwerk verloren hat und der Wert von Navigator.onLine auf false wechselt.

SVGSVGElement.ononline

Wird ausgelöst, wenn der Browser Zugang zum Netzwerk erlangt und der Wert von Navigator.onLine auf true wechselt.

SVGSVGElement.onpagehide

Wird ausgelöst, wenn der Browser die aktuelle Seite ausblendet, um eine andere Seite aus der Sitzungsverlauf anzuzeigen.

SVGSVGElement.onpageshow

Wird ausgelöst, wenn der Browser das Dokument des Fensters aufgrund einer Navigation anzeigt.

SVGSVGElement.onpopstate

Wird ausgelöst, wenn sich der aktive Verlaufs-Eintrag ändert, während der Benutzer durch den Sitzungsverlauf navigiert.

SVGSVGElement.onrejectionhandled

Wird ausgelöst, wenn immer eine JavaScript-Promise abgelehnt und die Ablehnung behandelt wurde.

SVGSVGElement.onstorage

Wird ausgelöst, wenn ein Speicherbereich (localStorage) im Kontext eines anderen Dokuments geändert wurde.

SVGSVGElement.onunhandledrejection

Wird ausgelöst, wenn immer eine Promise abgelehnt wird, die Ablehnung jedoch nicht behandelt wurde.

SVGSVGElement.onunload

Wird ausgelöst, wenn das Dokument entladen wird.

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# InterfaceSVGSVGElement

Browser-Kompatibilität

Siehe auch