href

Das href-Attribut definiert einen Link zu einer Ressource als Referenz URL. Die genaue Bedeutung dieses Links hängt vom Kontext des jeweiligen Elements ab, das ihn verwendet.

Hinweis: Spezifikationen vor SVG 2 definierten ein xlink:href-Attribut, das nun durch das href-Attribut obsolet geworden ist. Wenn es erforderlich ist, frühere Browserversionen zu unterstützen, kann das veraltete xlink:href-Attribut zusätzlich zum href-Attribut als Fallback verwendet werden, z.B. <use href="some-id" xlink:href="some-id" x="5" y="5" />.

Sie können dieses Attribut mit den folgenden SVG-Elementen verwenden:

Beispiel

html
<svg viewBox="0 0 160 40" xmlns="http://www.w3.org/2000/svg">
  <a href="https://developer.mozilla.org/">
    <text x="10" y="25">MDN Web Docs</text>
  </a>
</svg>

In SVG

a

Für <a> definiert href den Speicherort des referenzierten Objekts, ausgedrückt als URL-Referenz.

Wert <url>
Standardwert Keiner
Animierbar Ja

animate, animateMotion, animateTransform, set

Für die <animate>, <animateMotion>, <animateTransform> und <set> definiert href eine URL, die auf das Element verweist, das das Ziel dieses Animationselements ist und das daher im Laufe der Zeit modifiziert wird.

Die URL muss auf genau ein Zielelement verweisen, das in der Lage ist, das Ziel des gegebenen Animationselements zu sein. Wenn die URL auf mehrere Zielelemente verweist, wenn das gegebene Zielelement nicht in der Lage ist, das Ziel des gegebenen Animationselements zu sein, oder wenn das gegebene Zielelement nicht Teil des aktuellen Dokuments ist, wird das Animationselement kein Zielelement beeinflussen. Das Animationselement wird jedoch in Bezug auf seine Timing-Eigenschaften weiterhin normal funktionieren. Insbesondere werden TimeEvents versendet, und das Animationselement kann als Synchronisationsbasis auf dieselbe Weise verwendet werden, wie wenn die URL auf ein gültiges Zielelement verweist.

Wenn das href-Attribut oder das veraltete xlink:href-Attribut nicht angegeben ist, dann wird das Bezirkszielelement das unmittelbare übergeordnete Element des aktuellen Animationselements sein. Wenn sowohl xlink:href als auch href angegeben sind, wird der Wert des letzteren Attributs verwendet.

Siehe die Beschreibungen der einzelnen Animationselemente für etwaige Einschränkungen, welche Art von Elementen das Ziel bestimmter Arten von Animationen sein können.

Mit Ausnahme von SVG-spezifischen Regeln, die ausdrücklich in dieser Spezifikation genannt werden, ist die normative Definition für dieses Attribut die SMIL-Animationsspezifikation. Insbesondere siehe SMIL Animation: Specifying the animation target.

Wert <url>
Standardwert Keiner
Animierbar Nein

feImage

Für <feImage> definiert href eine URL, die auf eine Bildressource oder ein Element verweist. Wenn sowohl das xlink:href-Attribut als auch das href-Attribut angegeben sind, überschreibt letzteres das erstere.

Wert <url>
Standardwert Keiner
Animierbar Ja

discard

Für <discard> definiert href eine URL, die auf ein Element verweist, das verworfen wird (aus dem DOM entfernt wird). Wenn nicht angegeben, wird das unmittelbare übergeordnete Element von <discard> verworfen.

Wert <url>
Standardwert Keiner
Animierbar Nein

image

Für <image> definiert href eine URL, die auf das zu rendernde Bild verweist.

Wert <url>
Standardwert Keiner
Animierbar Ja
html
<svg viewBox="0 0 100 100" xmlns="http://www.w3.org/2000/svg">
  <image href="fxlogo.png" x="0" y="0" height="100" width="100" />
</svg>

linearGradient/radialGradient

Für <linearGradient> oder <radialGradient> definiert href eine URL, die auf ein Vorlage-Gradienten-Element verweist; um gültig zu sein, muss die Referenz auf ein anderes <linearGradient>- oder <radialGradient>-Element verweisen.

Wert <url>
Standardwert Keiner
Animierbar Ja

mpath

Für <mpath> definiert href eine URL, die auf das <path>-Element oder die Grundform verweist, die den Bewegungspfad definiert.

Wert <url>
Standardwert Keiner
Animierbar Nein

pattern

Für <pattern> definiert href eine URL, die auf ein anderes <pattern>-Element innerhalb des aktuellen SVG-Dokuments verweist. Alle Attribute, die auf dem referenzierten Element definiert sind, die nicht auf diesem Element definiert sind, werden von diesem Element geerbt. Wenn dieses Element keine Kinder hat und das referenzierte Element welche hat (möglicherweise aufgrund seines eigenen href-Attributs), dann erbt dieses Element die Kinder vom referenzierten Element. Die Vererbung kann indirekt auf beliebiger Ebene sein; wenn das referenzierte Element Attribute oder Kinder aufgrund seines eigenen href-Attributs erbt, kann das aktuelle Element diese Attribute oder Kinder erben. Beim <pattern>-Element ist das href-Attribut animierbar.

Wert <url>
Standardwert Keiner
Animierbar Ja

script

Für <script> definiert href eine URL, die auf eine externe Ressource verweist, die den Skript-Code enthält.

Wert <url>
Standardwert Keiner
Animierbar Nein

textPath

Für <textPath> definiert href eine URL, die auf das <path>-Element oder die Grundform verweist, auf die der Text gerendert wird, wenn kein path-Attribut bereitgestellt wird. Beim <textPath>-Element ist das href-Attribut animierbar.

Wert <url>
Standardwert Keiner
Animierbar Ja

use

Für <use> definiert href eine URL, die auf ein Element oder Fragment innerhalb eines SVG-Dokuments verweist, das geklont werden soll.

Das <use>-Element kann auf ein gesamtes SVG-Dokument verweisen, indem ein href-Wert ohne Fragment angegeben wird. Solche Verweise gelten als Verweis auf das Wurzelelement des referenzierten Dokuments.

Wert <url>
Standardwert Keiner
Animierbar Ja

Spezifikationen

Specification
Scalable Vector Graphics (SVG) 2
# AElementHrefAttribute
SVG Animations Level 2
# HrefAttribute
Filter Effects Module Level 1
# element-attrdef-feimage-href
Scalable Vector Graphics (SVG) 2
# ImageElementHrefAttribute
Scalable Vector Graphics (SVG) 2
# LinearGradientElementHrefAttribute
SVG Animations Level 2
# MPathElementHrefAttribute
Scalable Vector Graphics (SVG) 2
# PatternElementHrefAttribute
Scalable Vector Graphics (SVG) 2
# RadialGradientElementHrefAttribute
Scalable Vector Graphics (SVG) 2
# ScriptElementHrefAttribute
Scalable Vector Graphics (SVG) 2
# TextPathElementHrefAttribute
Scalable Vector Graphics (SVG) 2
# UseElementHrefAttribute

Browser-Kompatibilität

svg.elements.a.href

svg.elements.animate.href

svg.elements.animateMotion.href

svg.elements.animateTransform.href

svg.elements.feImage.href

svg.elements.image.href

svg.elements.linearGradient.href

svg.elements.mpath.href

svg.elements.pattern.href

svg.elements.radialGradient.href

svg.elements.script.href

svg.elements.set.href

svg.elements.textPath.href

svg.elements.use.href

Siehe auch