String.prototype.anchor()

anchor() メソッドは、ハイパーテキストターゲットとして利用される <a> HTML アンカー要素を生成します。

構文

str.anchor(name)

引数

name

生成するタグの name 属性を表す文字列。

戻り値

<a> HTML 要素を含む文字列。

詳細

プログラムからアンカーを生成して、ドキュメントに表示するため anchor() メソッドを使用できます。

構文として、テキストの文字列は、ユーザーに表示する文字列を表します。name 引数文字列は、<a> 要素の name 属性を表します。

anchor メソッドで生成されたアンカーは、document.anchors の配列の要素となります。

例

例: anchor() の使用

以下の例のコードは、HTML の script 要素内に書かれたものです。:

var myString = 'Table of Contents';

document.body.innerHTML = myString.anchor('contents_anchor');

以下の HTML が生成されるでしょう。:

<a name="contents_anchor">Table of Contents</a>

仕様

ブラウザ実装状況

[1] Gecko 17 から、name 引数に渡された文字列のうち、"（コーテーションマーク）は HTML 参照文字 " に置き換えられるようになりました。

関連項目

• String.prototype.link()