href
Das Attribut href definiert einen Link zu einer Ressource als URL-Referenz. Die genaue Bedeutung dieses Links hängt vom jeweiligen Element ab, das das Attribut verwendet.
Hinweis:
Spezifikationen vor SVG 2 definierten das Attribut xlink:href, das inzwischen durch das Attribut href abgelöst wurde. Wenn Sie ältere Browserversionen unterstützen müssen, können Sie das veraltete Attribut xlink:href zusätzlich zu href als Fallback verwenden, beispielsweise <use href="some-id" xlink:href="some-id" x="5" y="5" />.
Sie können dieses Attribut mit den folgenden SVG-Elementen verwenden:
In SVG
a
Bei <a> definiert href den Speicherort des referenzierten Objekts als URL-Referenz.
| Wert |
<url>
|
|---|---|
| Standardwert | Keiner |
| Animierbar | Ja |
animate, animateMotion, animateTransform, set
Bei <animate>, <animateMotion>, <animateTransform> und <set> definiert href eine URL, die auf das Zielelement dieses Animationselements verweist. Dieses Zielelement wird daher im zeitlichen Verlauf verändert.
Die URL muss auf genau ein Zielelement verweisen, das als Ziel des jeweiligen Animationselements verwendet werden kann. Wenn die URL auf mehrere Zielelemente verweist, das angegebene Zielelement nicht als Ziel des jeweiligen Animationselements verwendet werden kann oder das angegebene Zielelement nicht Teil des aktuellen Dokuments ist, wirkt sich das Animationselement auf kein Zielelement aus. Hinsichtlich seiner zeitlichen Eigenschaften funktioniert das Animationselement jedoch weiterhin wie gewohnt. Insbesondere werden TimeEvents ausgelöst, und das Animationselement kann genauso wie bei einer URL, die auf ein gültiges Zielelement verweist, als Syncbase verwendet werden.
Wenn weder das Attribut href noch das veraltete Attribut xlink:href angegeben ist, ist das unmittelbare Elternelement des aktuellen Animationselements das Zielelement. Wenn sowohl xlink:href als auch href angegeben sind, wird der Wert von href verwendet.
Den Beschreibungen der einzelnen Animationselemente können Sie entnehmen, welche Einschränkungen für die Elemente gelten, die als Ziele bestimmter Animationstypen verwendet werden können.
Abgesehen von den SVG-spezifischen Regeln, die in dieser Spezifikation ausdrücklich genannt werden, ist die normative Definition dieses Attributs in der SMIL-Animation-Spezifikation festgelegt. Siehe insbesondere SMIL Animation: Specifying the animation target.
| Wert |
<url>
|
|---|---|
| Standardwert | Keiner |
| Animierbar | Nein |
feImage
Bei <feImage> definiert href eine URL, die auf eine Bildressource oder ein Element verweist. Wenn sowohl xlink:href als auch href angegeben sind, hat href Vorrang.
| Wert |
<url>
|
|---|---|
| Standardwert | Keiner |
| Animierbar | Ja |
image
Bei <image> definiert href eine URL, die auf das darzustellende 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
Bei <linearGradient> oder <radialGradient> definiert href eine URL, die auf ein als Vorlage dienendes Verlaufselement verweist. Damit die Referenz gültig ist, muss sie auf ein anderes <linearGradient>- oder <radialGradient>-Element verweisen.
| Wert |
<url>
|
|---|---|
| Standardwert | Keiner |
| Animierbar | Ja |
mpath
Bei <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
Bei <pattern> definiert href eine URL, die auf ein anderes <pattern>-Element im aktuellen SVG-Dokument verweist. Attribute, die auf dem referenzierten Element, aber nicht auf diesem Element definiert sind, werden von diesem Element geerbt. Wenn dieses Element keine Kindelemente hat, das referenzierte Element jedoch schon – möglicherweise aufgrund seines eigenen Attributs href –, erbt dieses Element die Kindelemente des referenzierten Elements. Die Vererbung kann über beliebig viele Ebenen erfolgen. Wenn also das referenzierte Element aufgrund seines eigenen Attributs href Attribute oder Kindelemente erbt, kann das aktuelle Element diese ebenfalls erben. Beim Element <pattern> ist das Attribut href animierbar.
| Wert |
<url>
|
|---|---|
| Standardwert | Keiner |
| Animierbar | Ja |
script
Bei <script> definiert href eine URL, die auf eine externe Ressource mit dem Skriptcode verweist.
| Wert |
<url>
|
|---|---|
| Standardwert | Keiner |
| Animierbar | Nein |
textPath
Bei <textPath> definiert href eine URL, die auf das <path>-Element oder die Grundform verweist, entlang derer der Text dargestellt wird, sofern kein Attribut path angegeben ist. Beim Element <textPath> ist das Attribut href animierbar.
| Wert |
<url>
|
|---|---|
| Standardwert | Keiner |
| Animierbar | Ja |
use
Bei <use> definiert href eine URL, die auf ein Element oder Fragment innerhalb eines SVG-Dokuments verweist, das geklont werden soll.
Das Element <use> kann auf ein vollständiges SVG-Dokument verweisen, indem für href ein Wert ohne Fragment angegeben wird. Solche Referenzen beziehen sich auf das Wurzelelement des referenzierten Dokuments.
| Wert |
<url>
|
|---|---|
| Standardwert | Keiner |
| Animierbar | Ja |
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>