href
Das href Attribut definiert einen Link zu einer Ressource als Referenz URL. Die genaue Bedeutung dieses Links hängt vom Kontext jedes Elements ab, das ihn verwendet.
Hinweis:
Spezifikationen vor SVG 2 definierten ein xlink:href Attribut, das jetzt durch das href Attribut obsolet geworden ist. Wenn Sie frühere Browserversionen unterstützen müssen, kann das veraltete xlink:href Attribut als Fallback zusätzlich zum href Attribut 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, welches das Ziel dieses Animationselements ist und somit über die Zeit modifiziert wird.
Die URL muss auf genau ein Ziel-Element verweisen, das in der Lage ist, das Ziel des gegebenen Animationselements zu sein. Wenn die URL auf mehrere Zielelemente verweist, das gegebene Zielelement nicht in der Lage ist, Ziel des gegebenen Animationselements zu sein oder das gegebene Zielelement nicht Teil des aktuellen Dokuments ist, wird das Animationselement kein Zielelement beeinflussen. Das Animationselement wird jedoch weiterhin normal in Bezug auf seine Zeitsteuerungseigenschaften funktionieren. Insbesondere werden TimeEvents gesendet und das Animationselement kann als Synchronisationsbasis identisch verwendet werden, wie wenn die URL auf ein gültiges Zielelement verweist.
Wenn das href Attribut oder das veraltete xlink:href Attribut nicht angegeben wird, wird das Zielelement das unmittelbare Elternelement des aktuellen Animationselements sein. Wenn sowohl xlink:href als auch href angegeben sind, wird der Wert des letztgenannten Attributs verwendet.
Siehe die Beschreibungen der einzelnen Animationselemente für etwaige Einschränkungen, welche Arten von Elementen Ziele bestimmter Arten von Animationen sein können.
Abgesehen von eventuell speziell in dieser Spezifikation erwähnten SVG-spezifischen Regeln ist die normative Definition für dieses Attribut die SMIL Animation Spezifikation. 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 auf ein Element verweist. Wenn sowohl das xlink:href als auch das href Attribut angegeben sind, überschreibt letzteres das erste.
| 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 Vorlagen-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 Grundform 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, jedoch nicht auf diesem Element, 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. Das Erben kann indirekt auf beliebiger Ebene sein; wenn das referenzierte Element also 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 | 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 Grundform verweist, auf die der Text dargestellt wird, wenn kein path Attribut bereitgestellt wird. 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 auf ein komplettes SVG-Dokument verweisen, indem es einen href Wert ohne Fragment angibt. Solche Verweise sind als Verweise auf das Wurzelelement des referenzierten Dokuments zu verstehen.
| Wert |
<url>
|
|---|---|
| Standardwert | Keiner |
| Animierbar | Ja |