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.
anchor() は String 値のメソッドで、<a> 要素に name を付けたものに文字列を埋め込んだ文字列 (<a name="...">str</a>) を生成します。
メモ:
HTML ラッパーメソッドはすべて非推奨となっており、互換性目的のみで標準化されています。代わりに DOM API の document.createElement() などを使用してください。
HTML 仕様書では <a> 要素に name 属性を設定することを許容しなくなりましたので、このメソッドが生成するものは妥当なマークアップになりません。
構文
anchor(name)
引数
name-
name値を表す文字列で、<a name="...">開始タグに入れられます。
返値
<a name="name"> 開始タグで始まり（name の中の二重引用符は " で置き換え）、str のテキストが続き、 </a> 終了タグで終わる文字列です。
例
anchor() の使用
以下のコードは、 HTML 文字列を作成し、それを文書の本体に置き換えます。
const contentString = "Hello, world";
document.body.innerHTML = contentString.anchor("hello");
以下の HTML が生成されます。
<a name="hello">Hello, world</a>
警告:
このマークアップは不正です。name は <a> 要素の有効な属性ではなくなったためです。
anchor() を使用して HTML テキストを直接作成する代わりに、document.createElement() などの DOM API を使用しましょう。例を示します。
const contentString = "Hello, world";
const elem = document.createElement("a");
elem.innerText = contentString;
document.body.appendChild(elem);
仕様書
| 仕様書 |
|---|
| ECMAScript® 2027 Language Specification # sec-string.prototype.anchor |