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.