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.
Instanz-Eigenschaften
Diese Schnittstelle erbt auch Eigenschaften von ihrem Elternteil, SVGGraphicsElement
.
SVGSVGElement.x
Schreibgeschützt-
Ein
SVGAnimatedLength
, das demx
-Attribut des gegebenen<svg>
-Elements entspricht. SVGSVGElement.y
Schreibgeschützt-
Ein
SVGAnimatedLength
, das demy
-Attribut des gegebenen<svg>
-Elements entspricht. SVGSVGElement.width
Schreibgeschützt-
Ein
SVGAnimatedLength
, das demwidth
-Attribut des gegebenen<svg>
-Elements entspricht. SVGSVGElement.height
Schreibgeschützt-
Ein
SVGAnimatedLength
, das demheight
-Attribut des gegebenen<svg>
-Elements entspricht. SVGSVGElement.viewBox
Schreibgeschützt-
Ein
SVGAnimatedRect
, das demviewBox
-Attribut des gegebenen<svg>
-Elements entspricht. SVGSVGElement.preserveAspectRatio
Schreibgeschützt-
Ein
SVGAnimatedPreserveAspectRatio
, das dempreserveAspectRatio
-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 wieviewBox
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 Attributfalse
. Wenn die anfängliche Ansicht eine "benutzerdefinierte" Ansicht ist, dann ist dieses Attributtrue
. 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
undzoomAndPan
incurrentView
mit den Werten der entsprechenden DOM-Attribute überein, die sich direkt aufSVGSVGElement
befinden - der Wert für
transform
innerhalb voncurrentView
wirdnull
sein
Wenn die anfängliche Ansicht ein Link in ein
<view>
-Element war, dann:- entsprechen die Werte für
viewBox
,preserveAspectRatio
undzoomAndPan
innerhalb voncurrentView
den entsprechenden Attributen für das gegebene<view>
-Element - der Wert für
transform
innerhalb voncurrentView
wirdnull
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
undzoomAndPan
incurrentView
mit den Werten der entsprechenden DOM-Attribute überein, die sich direkt aufSVGSVGElement
für das nächste Vorfahren-<svg>
-Element befinden - die Werte für
transform
innerhalb voncurrentView
werdennull
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
undtransform
incurrentView
den Werten aus dem SVG-Viewer-Spezifikations-Fragmentidentifikator entsprechen
- stimmen die Werte für
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-AttributecurrentScale
undcurrentTranslate
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, einunsuspendRedrawAll()
-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()
undunsuspendRedraw()
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:
jsconst suspendHandleID = suspendRedraw(maxWaitMilliseconds);
eingeleitet und die Änderungen mit einem Methodenaufruf, ähnlich wie:
jsunsuspendRedraw(suspendHandleID);
abgeschlossen werden.
Beachten Sie, dass mehrere
suspendRedraw()
-Aufrufe gleichzeitig verwendet werden können und dass jeder dieser Methodenaufrufe unabhängig von den anderensuspendRedraw()
-Methodenaufrufen behandelt wird. SVGSVGElement.unsuspendRedraw()
Veraltet-
Hebt ein angegebenes
suspendRedraw()
auf, indem eine eindeutige Aussetz-Handle-ID bereitgestellt wird, die von einem vorhergehendensuspendRedraw()
-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 ausstehendensuspendRedraw()
-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 dasSVGLoad
-Ereignis des Dokuments ausgelöst wird), wird0
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 dasSVGLoad
-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 vonpointer-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 vonpointer-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 vonpointer-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 vonpointer-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 auf0
initialisiert. SVGSVGElement.createSVGLength()
-
Erstellt ein
SVGLength
-Objekt außerhalb irgendeines Dokumentbaums. Das Objekt wird auf0
Benutzerunits initialisiert. SVGSVGElement.createSVGAngle()
-
Erstellt ein
SVGAngle
-Objekt außerhalb irgendeines Dokumentbaums. Das Objekt wird auf einen Wert von0
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 auf0
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 alsSVGTransform::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
durchelementId
gegeben ist. Wenn ein Element gefunden wird, wird dieses Element zurückgegeben. Wenn ein solches Element nicht existiert, wirdnull
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
auffalse
wechselt. SVGSVGElement.ononline
-
Wird ausgelöst, wenn der Browser Zugang zum Netzwerk erlangt und der Wert von
Navigator.onLine
auftrue
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 |