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 es verwendet.
Hinweis:
Spezifikationen vor SVG 2 definierten ein xlink:href
Attribut, das jetzt durch das href
Attribut obsolet geworden 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" />
.
Dieses Attribut kann mit den folgenden SVG-Elementen verwendet werden:
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 modifiziert wird.
Die URL muss auf genau ein Zielelement verweisen, das als Ziel für das gegebene Animationselement geeignet ist. Wenn die URL auf mehrere Zielelemente verweist, das gegebene Zielelement kein geeignetes Ziel für das gegebene Animationselement ist oder das gegebene Zielelement nicht Teil des aktuellen Dokuments ist, wird das Animationselement kein Zielelement beeinflussen. Das Animationselement funktioniert jedoch wie gewohnt hinsichtlich seiner Zeitsteuerungseigenschaften. Insbesondere werden TimeEvents ausgesendet und das Animationselement kann identisch als Syncbasis verwendet werden, als wenn die URL auf ein gültiges Zielelement verweist.
Wenn das href
Attribut oder das veraltete xlink:href
Attribut nicht angegeben sind, ist das Zielelement das unmittelbare Elternelement des aktuellen Animationselements. Wenn sowohl xlink:href
als auch href
angegeben sind, wird der Wert des letzteren Attributs verwendet.
Beziehen Sie sich auf die Beschreibungen der einzelnen Animationselemente für etwaige Beschränkungen, welche Elementtypen Ziele bestimmter Animationen sein können.
Mit Ausnahme von SVG-spezifischen Regeln, die in dieser Spezifikation ausdrücklich erwähnt werden, ist die normative Definition für dieses Attribut die SMIL Animationsspezifikation. Insbesondere siehe SMIL Animation: Festlegung des Animationstargets.
Wert |
<url>
|
---|---|
Standardwert | None |
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 erstere.
Wert |
<url>
|
---|---|
Standardwert | None |
Animierbar | Ja |
discard
image
linearGradient/radialGradient
Für <linearGradient>
oder <radialGradient>
, definiert href
eine URL, die auf ein Vorlagen-Gradienten-Element verweist; um gültig zu sein, muss die Referenz auf ein anderes <linearGradient>
oder <radialGradient>
Element verweisen.
Wert |
<url>
|
---|---|
Standardwert | None |
Animierbar | Ja |
mpath
Für <mpath>
, definiert href
eine URL, die auf das <path>
Element oder basic shape verweist, das den Bewegungsweg 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 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 (möglicherweise bedingt durch sein eigenes href
Attribut) schon, dann erbt dieses Element die Kinder des referenzierten Elements. Die Vererbung kann indirekt auf einer beliebigen Ebene stattfinden; somit kann das aktuelle Element Attribute oder Kinder erben, wenn das referenzierte Element Attribute oder Kinder aufgrund seines eigenen href
Attributs erbt. 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 basic shape verweist, auf dem der Text gerendert wird, wenn kein path
Attribut bereitgestellt 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 Verweise werden als Verweise auf das Wurzelelement des referenzierten Dokuments aufgefasst.
Wert |
<url>
|
---|---|
Standardwert | None |
Animierbar | Ja |
Spezifikationen
Browser-Kompatibilität
svg.elements.a.href
BCD tables only load in the browser
svg.elements.animate.href
BCD tables only load in the browser
svg.elements.animateMotion.href
BCD tables only load in the browser
svg.elements.animateTransform.href
BCD tables only load in the browser
svg.elements.feImage.href
BCD tables only load in the browser
svg.elements.image.href
BCD tables only load in the browser
svg.elements.linearGradient.href
BCD tables only load in the browser
svg.elements.mpath.href
BCD tables only load in the browser
svg.elements.pattern.href
BCD tables only load in the browser
svg.elements.radialGradient.href
BCD tables only load in the browser
svg.elements.script.href
BCD tables only load in the browser
svg.elements.set.href
BCD tables only load in the browser
svg.elements.textPath.href
BCD tables only load in the browser
svg.elements.use.href
BCD tables only load in the browser