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

html
<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 die Position des referenzierten Objekts, ausgedrückt als URL-Referenz.

Wert <url>
Standardwert None
Animierbar Ja

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

Für <discard>, definiert href eine URL, die auf ein Element verweist, das verworfen (aus dem DOM entfernt) wird. Wenn es nicht angegeben ist, wird das unmittelbare Elternelement von <discard> verworfen.

Wert <url>
Standardwert None
Animierbar Nein

image

Für <image>, definiert href eine URL, die auf das zu rendernde Bild verweist.

Wert <url>
Standardwert None
Animierbar Ja
html
<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-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

Für <script>, definiert href eine URL, die auf eine externe Ressource verweist, die den Skriptcode enthält.

Wert <url>
Standardwert None
Animierbar Nein

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

Specification
Scalable Vector Graphics (SVG) 2
# AElementHrefAttribute
SVG Animations Level 2
# HrefAttribute
Filter Effects Module Level 1
# element-attrdef-feimage-href
Scalable Vector Graphics (SVG) 2
# ImageElementHrefAttribute
Scalable Vector Graphics (SVG) 2
# LinearGradientElementHrefAttribute
SVG Animations Level 2
# MPathElementHrefAttribute
Scalable Vector Graphics (SVG) 2
# PatternElementHrefAttribute
Scalable Vector Graphics (SVG) 2
# RadialGradientElementHrefAttribute
Scalable Vector Graphics (SVG) 2
# ScriptElementHrefAttribute
Scalable Vector Graphics (SVG) 2
# TextPathElementHrefAttribute
Scalable Vector Graphics (SVG) 2
# UseElementHrefAttribute

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

Siehe auch