href
Das Attribut href
definiert einen Link zu einer Ressource als Referenz URL. Die genaue Bedeutung dieses Links hängt vom Kontext des Elements ab, das es verwendet.
Hinweis:
Spezifikationen vor SVG 2 definierten ein xlink:href
-Attribut, das nun durch das href
-Attribut obsolet geworden ist. Wenn Sie frühere Browserversionen unterstützen müssen, kann das veraltete xlink:href
-Attribut neben dem 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
<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
animate, animateMotion, animateTransform, set
Für <animate>
, <animateMotion>
, <animateTransform>
und <set>
definiert href
eine URL, die auf das Element verweist, welches das Ziel dieses Animationselements ist und daher über die Zeit verändert wird.
Die URL muss auf genau ein Ziel-Element verweisen, das als Ziel des gegebenen Animationselements geeignet ist. Wenn die URL auf mehrere Ziel-Elemente verweist, das gegebene Ziel-Element nicht geeignet ist oder nicht Teil des aktuellen Dokuments ist, wirkt sich das Animationselement auf kein Ziel-Element aus. Das Animationselement funktioniert jedoch normal in Bezug auf seine Zeit-Eigenschaften. Insbesondere werden Zeitereignisse gesendet und das Animationselement kann als Synchronbasis in gleicher Weise wie bei einer gültigen Ziel-Element-Referenz verwendet werden.
Wenn das href
-Attribut oder das veraltete xlink:href
-Attribut nicht angegeben ist, wird das unmittelbare Elternelement des aktuellen Animationselements das Ziel-Element. Wenn sowohl xlink:href
als auch href
angegeben sind, wird der Wert des letzteren Attributs verwendet.
Siehe die Beschreibungen der einzelnen Animationselemente für Einschränkungen, welche Elementtypen Ziele bestimmter Animationstypen sein können.
Abgesehen von allen in dieser Spezifikation ausdrücklich erwähnten SVG-spezifischen Regeln ist die normative Definition für dieses Attribut die SMIL-Animationsspezifikation. Siehe insbesondere SMIL Animation: Specifying the animation target.
Wert |
<url>
|
---|---|
Standardwert | None |
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 erste.
Wert |
<url>
|
---|---|
Standardwert | None |
Animierbar | Ja |
image
linearGradient/radialGradient
Für <linearGradient>
oder <radialGradient>
definiert href
eine URL, die auf ein Gradienten-Template-Element verweist; die Referenz muss auf ein anderes <linearGradient>
- oder <radialGradient>
-Element zeigen, um gültig zu sein.
Wert |
<url>
|
---|---|
Standardwert | None |
Animierbar | Ja |
mpath
Für <mpath>
definiert href
eine URL, die auf das <path>
-Element oder einfache Form verweist, welches den Bewegungspfad definiert.
Wert |
<url>
|
---|---|
Standardwert | None |
Animierbar | Nein |
pattern
Für <pattern>
definiert href
eine URL, die auf ein anderes <pattern>
-Element im aktuellen SVG-Dokument verweist. Alle Attribute, die am referenzierten Element definiert sind und nicht an diesem Element, werden von diesem Element geerbt. Wenn dieses Element keine Kinder hat, das referenzierte Element jedoch schon (möglicherweise aufgrund seines eigenen href
-Attributs), erbt dieses Element die Kinder des referenzierten Elements. Die Vererbung kann indirekt auf beliebiger Ebene erfolgen; wenn das referenzierte Element Attribute oder Kinder aufgrund seines eigenen href
-Attributs erbt, kann das aktuelle Element diese Attribute oder Kinder erben. Auf dem <pattern>
-Element ist das href
-Attribut animierbar.
Wert |
<url>
|
---|---|
Standardwert | None |
Animierbar | Ja |
script
textPath
Für <textPath>
definiert href
eine URL, die auf das <path>
-Element oder einfache Form verweist, auf das der Text gerendert wird, wenn kein path
-Attribut angegeben wird. Auf dem <textPath>
-Element ist das href
-Attribut animierbar.
Wert |
<url>
|
---|---|
Standardwert | None |
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 Referenzen werden dahingehend interpretiert, dass sie sich auf das Wurzelelement des referenzierten Dokuments beziehen.
Wert |
<url>
|
---|---|
Standardwert | None |
Animierbar | Ja |