SVGSVGElement

Diese Schnittstelle erbt auch Eigenschaften von ihrer Elternschnittstelle, 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 in CSS2 definiert) entlang der x-Achse des Ansichtsfensters darstellt, welche irgendwo im Bereich von 70dpi bis 120dpi liegt. Auf Systemen, die dies unterstützen, könnte sie die Eigenschaften des Zielmediums tatsächlich treffen. Auf Systemen, bei denen die Größe eines Pixels unbekannt ist, wird eine geeignete Standard-Pixelgröße bereitgestellt.

SVGSVGElement.pixelUnitToMillimeterY Veraltet

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

SVGSVGElement.screenPixelToMillimeterX Veraltet

Benutzeroberflächenereignisse (UI) 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 (z.B. .28mm).

SVGSVGElement.screenPixelToMillimeterY Veraltet

Die entsprechende Größe eines Bildschirmpixels entlang der y-Achse des Ansichtsfensters.

SVGSVGElement.useCurrentView Veraltet Nicht standardisiert

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

SVGSVGElement.currentView Veraltet Nicht standardisiert

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

• stimmen die Werte für viewBox, preserveAspectRatio und zoomAndPan innerhalb von currentView mit den Werten für die entsprechenden DOM-Attribute überein, die direkt auf SVGSVGElement liegen
• wird der Wert für transform innerhalb von currentView 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
• wird der Wert für transform innerhalb von currentView null sein

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

• stimmen die Werte für viewBox, preserveAspectRatio und zoomAndPan innerhalb von currentView mit den Werten für die entsprechenden DOM-Attribute überein, die direkt auf SVGSVGElement für das nächstgelegene übergeordnete <svg>-Element liegen
• wird der Wert für transform innerhalb von currentView null sein

Wenn die anfängliche Ansicht ein Link in das SVG-Dokumentfragment mittels eines SVG-Ansichtspezifikationsfragmentidentifikators war (d.h. #svgView(…)), dann:

• entsprechen die Werte für viewBox, preserveAspectRatio, zoomAndPan, transform innerhalb von currentView den Werten aus dem SVG-Ansichtspezifikationsfragmentidentifikator

SVGSVGElement.currentScale

Bei einem äußersten <svg>-Element gibt dieses Float-Attribut den aktuellen Skalierungsfaktor relativ zur Anfangsansicht an, um Benutzervergrößerung und Schwenkoperationen 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 höchster Ebene im SVG-Dokumentfragment platziert wäre (d.h. außerhalb des äußersten <svg>-Elements).

SVGSVGElement.currentTranslate Schreibgeschützt

Ein DOMPointReadOnly, der den Translationsfaktor darstellt, der die Benutzer-"Vergrößerung" für ein äußerstes <svg>-Element berücksichtigt. Das Verhalten ist für <svg>-Elemente, die nicht auf der äußersten Ebene sind, undefiniert.

Diese Schnittstelle erbt auch Methoden von ihrer Elternschnittstelle, SVGGraphicsElement.

SVGSVGElement.suspendRedraw() Veraltet

Nimmt einen Timeout-Wert an, der angibt, dass keine Neuzeichnung erfolgen soll, bis:

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

In Umgebungen, die keine Interaktivität unterstützen (z. B. Druckmedien), soll die Neuzeichnung nicht ausgesetzt werden. Aufrufe von suspendRedraw() und unsuspendRedraw() sollten, müssen jedoch nicht paarweise ausgeglichen sein.

Um Neuzeichnungsaktionen zu pausieren, während eine Sammlung von SVG-DOM-Änderungen stattfindet, führen Sie die Änderungen am SVG-DOM mit einem Methodenaufruf wie:

js

const suspendHandleID = suspendRedraw(maxWaitMilliseconds);

und schließen die Änderungen mit einem Methodenaufruf wie:

js

unsuspendRedraw(suspendHandleID);

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 Aussetzungs-Handle-ID bereitgestellt wird, die von einem vorherigen suspendRedraw()-Aufruf zurückgegeben wurde.

SVGSVGElement.unsuspendRedrawAll() Veraltet

Hebt alle derzeit aktiven suspendRedraw()-Methodenaufrufe auf. Diese Methode ist am nützlichsten am Ende eines Satzes 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, alle Bereiche des Ansichtsfensters, die aktualisiert werden müssen, sofort neu zu zeichnen.

SVGSVGElement.pauseAnimations()

Hält (d.h. pausiert) alle derzeit laufenden Animationen an, die innerhalb des diesem <svg>-Element entsprechenden SVG-Dokumentfragments definiert sind, wodurch die Animationsuhr, die diesem Dokumentfragment entspricht, stillsteht, bis sie wieder gestartet wird.

SVGSVGElement.unpauseAnimations()

Setzt derzeit laufende Animationen fort (d.h. spielt sie wieder ab), die innerhalb des SVG-Dokumentfragments definiert sind und lässt die Animationsuhr von dem Zeitpunkt an weiterlaufen, 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 für das aktuelle SVG-Dokumentfragment zurück. Wenn getCurrentTime() aufgerufen wird, bevor der Dokumentzeitstrahl begonnen hat (zum Beispiel durch ein Skript, das in einem <script>-Element ausgeführt wird, bevor das SVGLoad-Ereignis des Dokuments gesendet wird), wird 0 zurückgegeben.

SVGSVGElement.setCurrentTime()

Passt die Uhr für dieses SVG-Dokumentfragment an, indem eine neue aktuelle Zeit festgelegt wird. Wenn setCurrentTime() aufgerufen wird, bevor der Dokumentzeitstrahl begonnen hat (zum Beispiel durch ein Skript, das in einem <script>-Element ausgeführt wird, bevor das SVGLoad-Ereignis des Dokuments gesendet wird), gibt der Wert der Sekunden im letzten Aufruf der Methode die Zeit an, auf die das Dokument suchen wird, sobald der Dokumentzeitstrahl begonnen hat.

SVGSVGElement.getIntersectionList()

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

SVGSVGElement.getEnclosureList()

Gibt eine NodeList von Grafikelementen zurück, deren gerenderter Inhalt vollständig innerhalb des angegebenen Rechtecks enthalten ist. Jedes Kandidatenelement wird nur dann als Übereinstimmung betrachtet, wenn dasselbe Grafikelement ein Ziel von Zeigereignissen sein kann, wie in der Verarbeitung von pointer-events definiert.

SVGSVGElement.checkIntersection()

Gibt true zurück, wenn der gerenderte Inhalt des gegebenen Elements das angegebene Rechteck schneidet. Jedes Kandidatenelement wird nur dann als Übereinstimmung betrachtet, wenn dasselbe Grafikelement ein Ziel von Zeigereignissen 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 innerhalb des angegebenen Rechtecks enthalten ist. Jedes Kandidatenelement wird nur dann als Übereinstimmung betrachtet, wenn dasselbe Grafikelement ein Ziel von Zeigereignissen sein kann, wie in der Verarbeitung von pointer-events definiert.

SVGSVGElement.deselectAll()

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

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 Identitätsmatrix initialisiert.

SVGSVGElement.createSVGRect()

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

SVGSVGElement.createSVGTransform()

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

SVGSVGElement.createSVGTransformFromMatrix()

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

SVGSVGElement.getElementById()

Durchsucht dieses SVG-Dokumentfragment (d.h. die Suche ist auf einen Teilbereich des Dokumentbaums beschränkt) nach einem Element, dessen id durch elementId angegeben wird. 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.

Die folgenden Window onXYZ Ereignishandler-Eigenschaften sind auch als Aliase verfügbar, die auf das window-Objekt zielen. Es wird jedoch empfohlen, sie direkt auf dem window-Objekt anstelle von SVGSVGElement zu beobachten.

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 zur Druckvorschau dargestellt 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 feststellt, dass ein Gamepad angeschlossen wurde oder das erste Mal eine Taste/Achse des Gamepads verwendet wird.

SVGSVGElement.ongamepaddisconnected

Wird ausgelöst, wenn der Browser feststellt, 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, z.B. aus einem 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 auf false wechselt.

SVGSVGElement.ononline

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

SVGSVGElement.onpagehide

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

SVGSVGElement.onpageshow

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

SVGSVGElement.onpopstate

Wird ausgelöst, wenn sich der aktive Geschichtsbeitrag ändert, während der Benutzer die Sitzungshistorie navigiert.

SVGSVGElement.onrejectionhandled

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

SVGSVGElement.onunload

Wird ausgelöst, wenn das Dokument gerade entladen wird.

• <circle>