String.prototype.link()
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.
Die link()-Methode von String-Werten erstellt einen String, der diesen String in einem <a>-Element (<a href="...">str</a>) einbettet, um ihn als Hypertext-Link zu einer anderen URL zu verwenden.
Hinweis:
Alle HTML-Wrapper-Methoden sind veraltet und nur für Kompatibilitätszwecke standardisiert. Verwenden Sie stattdessen DOM-APIs wie document.createElement().
Syntax
link(url)
Parameter
url-
Ein beliebiger String, der das
href-Attribut des<a>-Elements angibt; er sollte eine gültige URL (relativ oder absolut) sein, wobei alle&-Zeichen als&maskiert werden.
Rückgabewert
Ein String, der mit einem <a href="url">-Start-Tag beginnt (doppelte Anführungszeichen in url werden durch " ersetzt), gefolgt vom Text str und dann einem </a>-End-Tag.
Beispiele
Verwendung von link()
Der folgende Code erstellt einen HTML-String und ersetzt dann den Body des Dokuments damit:
const contentString = "MDN Web Docs";
document.body.innerHTML = contentString.link("https://developer.mozilla.org/");
Dies wird das folgende HTML erzeugen:
<a href="https://developer.mozilla.org/">MDN Web Docs</a>
Anstatt link() zu verwenden und HTML-Text direkt zu erstellen, sollten Sie DOM-APIs wie document.createElement() verwenden. Zum Beispiel:
const contentString = "MDN Web Docs";
const elem = document.createElement("a");
elem.href = "https://developer.mozilla.org/";
elem.innerText = contentString;
document.body.appendChild(elem);
Spezifikationen
| Specification |
|---|
| ECMAScript® 2025 Language Specification # sec-string.prototype.link |