String.prototype.anchor()

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 anchor()-Methode von String-Werten erstellt einen String, der diesen String in ein <a>-Element mit einem Namen einbettet (<a name="...">str</a>).

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

Die HTML-Spezifikation erlaubt es dem <a>-Element nicht mehr, ein name-Attribut zu haben, sodass diese Methode nicht einmal gültiges Markup erzeugt.

Syntax

js
anchor(name)

Parameter

name

Ein String, der einen name-Wert darstellt, der in das generierte <a name="...">-Start-Tag eingefügt werden soll.

Rückgabewert

Ein String, der mit einem <a name="name">-Start-Tag beginnt (doppelte Anführungszeichen in name werden durch &quot; ersetzt), dann der Text str und dann ein </a>-End-Tag.

Beispiele

Verwendung von anchor()

Der folgende Code erstellt einen HTML-String und ersetzt dann den Body des Dokuments damit:

js
const contentString = "Hello, world";

document.body.innerHTML = contentString.anchor("hello");

Dies erzeugt folgendes HTML:

html
<a name="hello">Hello, world</a>

Warnung: Dieses Markup ist ungültig, da name kein gültiges Attribut des <a>-Elements mehr ist.

Anstatt anchor() zu verwenden und HTML-Text direkt zu erstellen, sollten Sie DOM-APIs wie document.createElement() verwenden. Zum Beispiel:

js
const contentString = "Hello, world";
const elem = document.createElement("a");
elem.innerText = contentString;
document.body.appendChild(elem);

Spezifikationen

Specification
ECMAScript Language Specification
# sec-string.prototype.anchor

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch