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 auch verschiedene häufig verwendete Hilfsmethoden, wie Matrixoperationen und die Möglichkeit, die Zeit des Neuzeichnens auf visuellen Ausgabegeräten zu steuern.

EventTarget Node Element SVGElement SVGGraphicsElement SVGSVGElement

Instanzeigenschaften

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

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

SVGSVGElement.pixelUnitToMillimeterY

Ein Float, der die Größe einer Pixel-Einheit entlang der y-Achse des Ansichtsbereichs darstellt.

SVGSVGElement.screenPixelToMillimeterX

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

SVGSVGElement.screenPixelToMillimeterY

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

SVGSVGElement.useCurrentView

Die Anfangsansicht (d.h. vor Vergrößerung und Schwenken) des aktuell innersten SVG-Dokumentfragments kann entweder die "Standard"-Ansicht sein, d.h. basierend auf Attributen des <svg>-Elements wie viewBox oder eine "benutzerdefinierte" Ansicht (d.h. ein Hyperlink auf ein bestimmtes <view> oder ein anderes Element). Wenn die Anfangsansicht die "Standard"-Ansicht ist, dann ist dieses Attribut false. Wenn die Anfangsansicht eine "benutzerdefinierte" Ansicht ist, dann ist dieses Attribut true.

SVGSVGElement.currentView

Ein SVGViewSpec, der die Anfangsansicht (d.h. vor Vergrößerung und Schwenken) des aktuell innersten SVG-Dokumentfragments definiert. Die Bedeutung hängt von der Situation ab: Wenn die Anfangsansicht eine "Standard"-Ansicht war, dann:

Wenn die Anfangsansicht ein Link zu einem <view>-Element war, dann:

Wenn die Anfangsansicht ein Link zu einem anderen Element war (d.h. anderes als ein <view>), dann:

Wenn die Anfangsansicht ein Link in das SVG-Dokumentfragment mit einem SVG-Ansichtsspezifikations-Fragment-Identifikator war (d.h. #svgView(…)), dann:

SVGSVGElement.currentScale

Bei einem äußersten <svg>-Element zeigt dieses Floating-Attribut den aktuellen Skalierungsfaktor relativ zur Anfangsansicht an, um Benutzervergrößerung und Schwenkoperationen zu berücksichtigen. DOM-Attribute currentScale und currentTranslate sind äquivalent zur 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"), ist der Effekt 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 Übersetzungsfaktor darstellt, der die Benutzer-"Vergrößerung" berücksichtigt und einem äußersten <svg>-Element entspricht. Das Verhalten ist für <svg>-Elemente auf einer nicht äußersten Ebene nicht definiert.

Instanzmethoden

Diese Schnittstelle erbt auch Methoden von ihrem Elternteil, SVGGraphicsElement.

SVGSVGElement.suspendRedraw()

Nimmt einen Timeout-Wert entgegen, der angibt, dass kein Neuzeichnen 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), sollte das Neuzeichnen nicht ausgesetzt werden. Aufrufe von suspendRedraw() und unsuspendRedraw() sollten in ausgeglichenen Paaren erfolgen, müssen es aber nicht.

Um Neuzeichnungsaktionen auszusetzen, während eine Sammlung von SVG-DOM-Änderungen erfolgt, gehen Sie den Änderungen am SVG-DOM mit einem Methodenaufruf wie:

js
const suspendHandleID = suspendRedraw(maxWaitMilliseconds);

und folgen Sie den Änderungen mit einem Methodenaufruf wie:

js
unsuspendRedraw(suspendHandleID);

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

SVGSVGElement.unsuspendRedraw()

Hebt eine bestimmte suspendRedraw()-Aufhebung durch Bereitstellung einer eindeutigen Suspend-Handle-ID auf, die von einem vorherigen suspendRedraw()-Aufruf zurückgegeben wurde.

SVGSVGElement.unsuspendRedrawAll()

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

SVGSVGElement.forceRedraw()

In Rendering-Umgebungen, die Interaktivität unterstützen, zwingt der Benutzeragent dazu, alle Bereiche des Ansichtsbereichs, die ein Update erfordern, sofort neu zu zeichnen.

SVGSVGElement.pauseAnimations()

Unterbricht (d.h. pausiert) alle derzeit laufenden Animationen, die innerhalb des SVG-Dokumentfragments definiert sind, das dem <svg>-Element entspricht, wodurch die Animationsuhr für dieses Dokumentfragment stillsteht, bis sie fortgesetzt wird.

SVGSVGElement.unpauseAnimations()

Nimmt derzeit laufende (d.h. pausierte) Animationen wieder auf, die innerhalb des SVG-Dokumentfragments definiert sind, wodurch die Animationsuhr von dem Zeitpunkt an fortgesetzt wird, zu 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 für das aktuelle SVG-Dokumentfragment zurück. Wenn getCurrentTime() aufgerufen wird, bevor der Dokumentzeitstrahl begonnen hat (zum Beispiel durch Skript in einem <script>-Element, bevor das SVGLoad-Ereignis des Dokuments gesendet 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 der Dokumentzeitstrahl begonnen hat (zum Beispiel durch Skript in einem <script>-Element, bevor das SVGLoad-Ereignis des Dokuments gesendet wird), gibt der Wert der Sekunden im letzten Aufruf der Methode die Zeit an, zu der das Dokument springen wird, sobald der Dokumentzeitstrahl begonnen hat.

SVGSVGElement.getIntersectionList()

Gibt eine NodeList von Grafikelementen zurück, deren gerenderter Inhalt das angegebene Rechteck schneidet. Jedes Kandidat-Grafikelement ist nur dann als Übereinstimmung zu betrachten, wenn das gleiche Grafikelement ein Ziel für Zeigereignisse sein kann, wie in der pointer-events-Verarbeitung definiert.

SVGSVGElement.getEnclosureList()

Gibt eine NodeList von Grafikelementen zurück, deren gerenderter Inhalt vollständig in dem angegebenen Rechteck enthalten ist. Jedes Kandidat-Grafikelement ist nur dann als Übereinstimmung zu betrachten, wenn dasselbe Grafikelement ein Ziel für Zeigereignisse sein kann, wie in der pointer-events-Verarbeitung definiert.

SVGSVGElement.checkIntersection()

Gibt true zurück, wenn der gerenderte Inhalt des angegebenen Elements das angegebene Rechteck schneidet. Jedes Kandidat-Grafikelement ist nur dann als Übereinstimmung zu betrachten, wenn dasselbe Grafikelement ein Ziel für Zeigereignisse sein kann, wie in der pointer-events-Verarbeitung definiert.

SVGSVGElement.checkEnclosure()

Gibt true zurück, wenn der gerenderte Inhalt des angegebenen Elements vollständig in dem angegebenen Rechteck enthalten ist. Jedes Kandidat-Grafikelement ist nur dann als Übereinstimmung zu betrachten, wenn dasselbe Grafikelement ein Ziel für Zeigereignisse sein kann, wie in der pointer-events-Verarbeitung definiert.

SVGSVGElement.deselectAll()

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

SVGSVGElement.createSVGNumber()

Erstellt ein SVGNumber Objekt außerhalb von Dokumentbäumen. Das Objekt wird auf 0 initialisiert.

SVGSVGElement.createSVGLength()

Erstellt ein SVGLength Objekt außerhalb von Dokumentbäumen. Das Objekt wird auf 0 Benutzereinheiten initialisiert.

SVGSVGElement.createSVGAngle()

Erstellt ein SVGAngle Objekt außerhalb von Dokumentbäumen. Das Objekt wird auf einen Wert von 0 Grad (einheitenlos) initialisiert.

SVGSVGElement.createSVGPoint()

Erstellt ein DOMPoint Objekt außerhalb von Dokumentbäumen. Das Objekt wird auf den Punkt (0,0) im Benutzerkoordinatensystem initialisiert.

SVGSVGElement.createSVGMatrix()

Erstellt ein DOMMatrix Objekt außerhalb von Dokumentbäumen. Das Objekt wird auf die Einheitsmatrix initialisiert.

SVGSVGElement.createSVGRect()

Erstellt ein SVGRect Objekt außerhalb von Dokumentbäumen. Das Objekt wird initialisiert, sodass alle Werte auf 0 Benutzereinheiten gesetzt sind.

SVGSVGElement.createSVGTransform()

Erstellt ein SVGTransform Objekt außerhalb von Dokumentbäumen. Das Objekt wird auf eine Einheitsmatrixtransformation (SVG_TRANSFORM_MATRIX) initialisiert.

SVGSVGElement.createSVGTransformFromMatrix()

Erstellt ein SVGTransform Objekt außerhalb von Dokumentbäumen. Das Objekt wird auf die gegebene Matrixtransformation (d.h. SVG_TRANSFORM_MATRIX) initialisiert. Die Werte aus der Parameter-Matrix werden kopiert, die Matrix-Parameter werden nicht als SVGTransform::matrix vorgesehen.

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 angegeben ist. Wenn ein Element gefunden wird, wird dieses Element zurückgegeben. Wenn kein solches Element existiert, wird null zurückgegeben. Das Verhalten ist nicht definiert, wenn mehr als ein Element diese id hat.

Ereignisbehandler

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

Hinweis: Die Verwendung von addEventListener() für SVGSVGElement funktioniert nicht für die unten aufgeführten onXYZ-Ereignisbehandler. Lauschen Sie stattdessen auf die Ereignisse auf dem window Objekt.

SVGSVGElement.onafterprint

Wird ausgelöst, nachdem das zugehörige Dokument mit dem Drucken begonnen hat oder die Druckvorschau geschlossen wurde.

SVGSVGElement.onbeforeprint

Wird ausgelöst, wenn das zugehörige Dokument gedruckt oder für den Druck in der Vorschau angezeigt werden soll.

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 angeschlossen wurde oder das erste Mal eine Tastenkombination/eine Achse des Gamepads verwendet wurde.

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, beispielsweise 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 Zugriff auf das Netzwerk verloren hat und der Wert von Navigator.onLine zu false wechselt.

SVGSVGElement.ononline

Wird ausgelöst, wenn der Browser Zugriff auf das Netzwerk erhalten hat und der Wert von Navigator.onLine zu true wechselt.

SVGSVGElement.onpagehide

Wird ausgelöst, wenn der Browser die aktuelle Seite ausblendet, um eine andere Seite aus der Sitzungsgeschichte 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 Verlaufseintrag ändert, während der Benutzer in der Sitzungsgeschichte navigiert.

SVGSVGElement.onrejectionhandled

Wird jedes Mal ausgelöst, wenn ein JavaScript-Promise abgelehnt wird 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 jedes Mal ausgelöst, wenn ein Promise abgelehnt wird, aber die Ablehnung 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