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 jetzt durch das href-Attribut obsolet ist. Wenn Sie ältere Browserversionen unterstützen müssen, 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
<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 verändert 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, 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 arbeitet jedoch normal mit Blick auf seine Timing-Eigenschaften. Insbesondere werden TimeEvents ausgelöst und das Animationselement kann als Syncbase auf identische Weise verwendet werden, als ob die URL auf ein gültiges Zielelement verweisen würde.
Wenn das href-Attribut oder das veraltete xlink:href-Attribut nicht angegeben ist, wird das unmittelbare Elternelement des aktuellen Animationselements das Zielelement 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 Einschränkungen, welche Arten von Elementen Ziele bestimmter Arten von Animationen sein können.
Abgesehen von SVG-spezifischen Regeln, die in dieser Spezifikation ausdrücklich erwähnt werden, ist die normative Definition für dieses Attribut die SMIL Animation-Spezifikation. Insbesondere siehe SMIL Animation: Festlegen des Animationsziels.
| Wert |
<url>
|
|---|---|
| Standardwert | Keiner |
| Animierbar | Nein |
feImage
Für <feImage> definiert href eine URL, die auf eine Bildressource oder auf ein Element verweist. Wenn sowohl das xlink:href als auch das href-Attribut angegeben sind, überschreibt letzteres das erstgenannte.
| Wert |
<url>
|
|---|---|
| Standardwert | Keiner |
| Animierbar | Ja |
image
Für <image> definiert href eine URL, die auf das anzuzeigende Bild verweist.
| Wert |
<url>
|
|---|---|
| Standardwert | Keiner |
| Animierbar | Ja |
<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 Template-Gradientenelement 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 basic shape verweist, welches 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 und nicht auf diesem Element definiert sind, werden von diesem Element geerbt. Wenn dieses Element keine Kinder hat und das referenzierte Element schon (möglicherweise aufgrund seines eigenen href-Attributs), dann erbt dieses Element die Kinder vom referenzierten Element. Die Vererbung kann indirekt auf beliebiger Ebene erfolgen; somit kann das aktuelle Element Attribute oder Kinder erben, wenn das referenzierte Element durch sein eigenes href-Attribut Attribute oder Kinder erbt. Auf dem <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 Skriptcode enthält.
| Wert |
<url>
|
|---|---|
| Standardwert | Keiner |
| Animierbar | Nein |
textPath
Für <textPath> definiert href eine URL, die auf das <path>-Element oder basic shape verweist, auf das der Text gerendert wird, wenn kein path-Attribut angegeben ist. Auf dem <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 ein gesamtes SVG-Dokument referenzieren, indem ein href-Wert ohne Fragment angegeben wird. Solche Referenzen werden als Verweise auf das Wurzelelement des referenzierten Dokuments betrachtet.
| Wert |
<url>
|
|---|---|
| Standardwert | Keiner |
| Animierbar | Ja |