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
<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 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
image
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
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
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 |