String.prototype.anchor()
Deprecated
Avoid using this feature in new projects. HTML wrapper methods exist only for backwards compatibility. Use DOM APIs to create elements instead. This feature may be a candidate for removal from web standards or browsers.>
Consider using the following features instead: DOM.>
Die anchor()-Methode von String-Werten erzeugt einen String, der in einem <a>-Element mit einem Namen eingebettet ist (<a name="...">str</a>).
Hinweis:
Alle HTML-Wrapper-Methoden sind veraltet und werden nur aus Kompatibilitätsgründen standardisiert. Verwenden Sie stattdessen DOM-APIs wie document.createElement().
Die HTML-Spezifikation erlaubt dem <a>-Element nicht mehr, ein name-Attribut zu besitzen, sodass diese Methode nicht einmal gültiges Markup erstellt.
Syntax
anchor(name)
Parameter
name-
Ein String, der einen
name-Wert darstellt, der in das generierte<a name="...">Start-Tag eingefügt wird.
Rückgabewert
Ein String, der mit einem <a name="name"> Start-Tag beginnt (doppelte Anführungszeichen in name werden durch " ersetzt), dann den Text str und dann ein </a> End-Tag enthält.
Beispiele
>Verwendung von anchor()
Der untenstehende Code erstellt einen HTML-String und ersetzt dann den Body des Dokuments damit:
const contentString = "Hello, world";
document.body.innerHTML = contentString.anchor("hello");
Dies wird das folgende HTML erzeugen:
<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:
const contentString = "Hello, world";
const elem = document.createElement("a");
elem.innerText = contentString;
document.body.appendChild(elem);
Spezifikationen
| Spezifikation |
|---|
| ECMAScript® 2027 Language Specification> # sec-string.prototype.anchor> |