HTMLAnchorElement: href-Eigenschaft
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
Die href-Eigenschaft der HTMLAnchorElement Schnittstelle ist ein stringifier, der die absolute URL zurückgibt, die dem href-Attribut des Elements entspricht (oder einen leeren String, wenn href nicht gesetzt ist). Das Setzen dieser Eigenschaft aktualisiert das href-Attribut des Elements auf den angegebenen Wert.
Wert
Ein String.
- Wenn das
href-Attribut fehlt, ist der Wert ein leerer String (""). - Wenn das
href-Attribut vorhanden, aber keine gültige relative oder absolute URL ist, ist der Wert der Attributwert, wie er ist. - Wenn das
href-Attribut vorhanden und eine gültige relative oder absolute URL ist, ist der Wert die absolute URL, die relativ zur Basis-URL des Dokuments aufgelöst wird. Der leere String ("") wird als gültige relative URL betrachtet und zur Basis-URL des Dokuments aufgelöst.
Beispiele
Ein neu erstelltes <a>-Element hat kein href-Attribut, daher gibt seine href-Eigenschaft einen leeren String zurück.
const anchor = document.createElement("a");
console.log(anchor.href); // ""
Wenn das Attribut auf einen leeren String gesetzt ist, gibt die Eigenschaft die Basis-URL des Dokuments zurück, da der leere String eine gültige relative URL ist.
anchor.href = "";
console.log(anchor.href); // "https://developer.mozilla.org/en-US/docs/Web/API/HTMLAnchorElement/href"
Wenn das Attribut auf eine relative URL gesetzt ist, gibt die Eigenschaft die absolute URL zurück, die gegen die Basis-URL des Dokuments aufgelöst wird.
anchor.href = "../../..";
console.log(anchor.href); // "https://developer.mozilla.org/en-US/docs/"
Beachten Sie, dass der Attributwert wie festgelegt bleibt, ohne Auflösung.
console.log(anchor.getAttribute("href")); // "../../.."
Wenn das Attribut auf eine absolute URL gesetzt ist, gibt die Eigenschaft diese absolute URL unverändert zurück.
anchor.href = "https://example.com/path";
console.log(anchor.href); // "https://example.com/path"
Wenn das Attribut auf eine ungültige URL gesetzt ist, gibt die Eigenschaft den Attributwert unverändert zurück.
anchor.href = "https://";
console.log(anchor.href); // "https://"
Spezifikationen
| Specification |
|---|
| HTML # dom-hyperlink-href-dev |
Browser-Kompatibilität
Siehe auch
- Die
HTMLAnchorElementSchnittstelle, zu der es gehört.