String.prototype.link()

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Die link()-Methode von String-Werten erstellt eine Zeichenkette, die diese Zeichenkette in einem <a>-Element (<a href="...">str</a>) einbettet, um sie als Hypertext-Link zu einer anderen URL zu verwenden.

Hinweis: Alle HTML-Wrapper-Methoden sind veraltet und nur aus Kompatibilitätsgründen standardisiert. Verwenden Sie stattdessen DOM-APIs wie document.createElement().

Syntax

js
link(url)

Parameter

url

Jede Zeichenkette, die das href-Attribut des <a>-Elements angibt; es sollte sich um eine gültige URL (relativ oder absolut) handeln, wobei alle &-Zeichen als &amp; maskiert sind.

Rückgabewert

Eine Zeichenkette, die mit einem <a href="url">-Start-Tag beginnt (doppelte Anführungszeichen in url werden durch &quot; ersetzt), gefolgt vom Text str und dann einem </a>-End-Tag.

Beispiele

Der folgende Code erstellt eine HTML-Zeichenkette und ersetzt dann den Body des Dokuments damit:

js
const contentString = "MDN Web Docs";

document.body.innerHTML = contentString.link("https://developer.mozilla.org/");

Dies wird das folgende HTML erzeugen:

html
<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:

js
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 Language Specification
# sec-string.prototype.link

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch