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 jetzt durch das href-Attribut überflüssig 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

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 den Standort des referenzierten Objekts, ausgedrückt als URL-Referenz.

Wert <url>
Standardwert Keiner
Animierbar Ja

animate, animateMotion, animateTransform, set

Für <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, Ziel des angegebenen Animationselements zu sein. Wenn die URL auf mehrere Zielelemente verweist, das angegebene Zielelement nicht in der Lage ist, Ziel des angegebenen Animationselements zu sein, oder wenn das angegebene Zielelement nicht Teil des aktuellen Dokuments ist, dann wird das Animationselement kein Zielelement beeinflussen. Das Animationselement wird jedoch in Bezug auf seine Zeitsteuerungseigenschaften weiterhin normal funktionieren. Insbesondere werden Zeitereignisse ausgelöst, und das Animationselement kann auf die gleiche Weise als Synchrondatenbank 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, 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.

Siehe die Beschreibungen der einzelnen Animationselemente für Einschränkungen, welche Arten von Elementen Ziele bestimmter Arten von Animationen sein können.

Mit Ausnahme von SVG-spezifischen Regeln, die ausdrücklich in dieser Spezifikation erwähnt 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 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 darzustellende Bild verweist.

Wert <url>
Standardwert Keiner
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

Für <linearGradient> definiert href eine URL, die auf ein Vorlagengradientelement 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 die Grundform verweist, die 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 und nicht auf diesem Element definiert sind, werden von diesem Element geerbt. Wenn dieses Element keine Kinder hat und das referenzierte Element dies tut (möglicherweise aufgrund seines eigenen href-Attributs), dann erbt dieses Element die Kinder des referenzierten Elements. Die Vererbung kann indirekt bis zu einem beliebigen Grad erfolgen; wenn das referenzierte Element 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

radialGradient

Für <radialGradient> definiert href eine URL, die auf ein Vorlagengradientelement verweist; um gültig zu sein, muss die Referenz auf ein anderes <linearGradient>- oder <radialGradient>-Element verweisen.

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 die Grundform verweist, auf den/die der Text gerendert wird, wenn kein path-Attribut angegeben ist. 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 ganzes SVG-Dokument verweisen, indem ein href-Wert ohne Fragment angegeben wird. Solche Verweise gelten als Verweise auf das Root-Element des referenzierten Dokuments.

Wert <url>
Standardwert Keiner
Animierbar Ja

Spezifikationen

No specification found

No specification data found for svg.global_attributes.href.
Check for problems with this page or contribute a missing spec_url to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch