WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

href — Linkadresse oder Basis-URL

Das href-Attribut gibt eine URL an, die von a-, area-, link- und base-Elementen verwendet wird. Seine Bedeutung hängt vom Element ab: Es bezeichnet das Ziel eines Hyperlinks, die Adresse einer zugehörigen Ressource oder die Basis-URL des Dokuments. Relative URLs werden anhand der Basis-URL aufgelöst.

Version: WHATWG HTML Living Standard; index snapshot date recorded separately

Syntax

href="URL"

href ist kein globales Attribut. Bei a und area gibt es das Ziel eines Hyperlinks an; ohne das Attribut erzeugen diese Elemente keine Hyperlinks. Sein Wert muss eine gültige URL sein und darf von Leerzeichen umgeben sein. Die URL kann absolut oder relativ sein, auch als Fragment wie #intro.

Bei link gibt href die Adresse einer zugehörigen Ressource an, während rel die Art der Beziehung festlegt, zum Beispiel stylesheet. Wenn href vorhanden ist, muss seine URL nicht leer sein. Ein link-Element muss mindestens eines der Attribute href oder imagesrcset haben; href allein legt nicht fest, wie die Ressource verarbeitet wird.

Bei base gibt href die Basis-URL des Dokuments an, anhand derer relative URLs aufgelöst werden. Ein Dokument darf höchstens ein base-Element enthalten. Wenn dieses href hat, muss es vor anderen Elementen mit URL-Werten stehen. Es ändert auch, wie Fragmentverweise wie #intro aufgelöst werden.

Im Beispiel gibt getAttribute('href') den gespeicherten Attributwert zurück, während die Eigenschaft guide.href die serialisierte, aufgelöste URL zurückgibt. Das explizite base macht das Ergebnis unabhängig davon, wo die Datei gespeichert ist. Ein leeres href="" bei a ist nicht dasselbe wie ein fehlendes Attribut: Es erzeugt weiterhin einen Hyperlink.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>href example</title>
  <base href="https://example.org/docs/">
</head>
<body>
  <a id="guide" href="guide.html#intro">Guide</a>
  <pre id="result"></pre>
  <script>
    const guide = document.getElementById('guide');
    document.getElementById('result').textContent =
      guide.getAttribute('href') + '\n' + guide.href;
  </script>
</body>
</html>

Ergebnis

guide.html#intro
https://example.org/docs/guide.html#intro

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen