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 Methode anchor() 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 für das <a>-Element kein name-Attribut mehr. Daher erzeugt diese Methode nicht einmal gültiges Markup.
Syntax
anchor(name)
Parameter
name-
Ein String, der den
name-Wert für das erzeugte öffnende<a name="...">-Tag angibt.
Rückgabewert
Ein String, der mit einem öffnenden <a name="name">-Tag beginnt (doppelte Anführungszeichen in name werden durch " ersetzt), gefolgt vom Text str und einem schließenden </a>-Tag.
Beispiele
anchor() verwenden
Der folgende Code erstellt einen HTML-String und ersetzt damit den Inhalt des Dokuments:
const contentString = "Hello, world";
document.body.innerHTML = contentString.anchor("hello");
Dadurch entsteht das folgende HTML:
<a name="hello">Hello, world</a>
Warnung:
Dieses Markup ist ungültig, da name kein gültiges Attribut des <a>-Elements mehr ist.
Statt anchor() zu verwenden und HTML-Text direkt zu erzeugen, 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 |