.link()
他のURLへのハイパーテキストリンクとして表示される文字列となる<a>のHTML要素を作成します。
文法
str.link(url)
引数 | 説明 |
---|---|
url |
aタグのhref 属性の値となる文字列を指定します。
これは、&文字は&に、"文字は"にエスケープされた正しいURL(相対または絶対)であるべきです。
|
説明
link
メソッドは、ハイパーテキストリンクのHTMLの断片を作成するのに使用します。
返された文字列は、document.writeまたはelement.innerHTMLを通して、
documentへ追加することが可能です。
linkメソッドによって作成されたリンクは、documentオブジェクトのlinks
配列内の要素になります。
document.linksを参照してみてください。
例
linkの使用例
下記は、Mozilla Developer Networkへのハイパーテキストリンクとなる"MDN"の単語を出力する例です。
var hotText = "MDN";
var URL = "https://developer.mozilla.org/";
console.log("Click to return to " + hotText.link(URL));
この例は下記のHTMLを生成します。
Click to return to <a href="https://developer.mozilla.org/">MDN</a>
仕様
ブラウザ互換性
機能 | Chrome | Firefox (Gecko) |
IE | Opera | Safari |
---|---|---|---|---|---|
基本 | ◯ | 1.0 (1.7 or earlier) | ◯ | ◯ | ◯ |
機能 | Android | Chrome for Android |
Firefox Mobile |
IE Mobile |
Opera Mobile |
Safari Mobile |
---|---|---|---|---|---|---|
基本 | ◯ | ◯ | 1.0 (1.0) | ◯ | ◯ | ◯ |
Gecko固有の注意事項
Gecko 17.0(Firefox 17 / Thunderbird 17 / SeaMonkey 2.14)から、 URLパラメーターの"(ダブルクォーテーション)は、 自動的にHTMLの実体参照である"に自動的に置換されるようになりました。
関連項目
© 2017 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
このページは、ページトップのURL先のMozilla Developer Network(以下、MDN)のコンテンツを翻訳した内容を基に構成されています。 構成について異なる点も含まれますので、下記の項目を確認し、必要に応じて元のコンテンツをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。
- 特定のブラウザに特化しすぎている情報やあまりにも古い情報、 または試験的に導入されているようなAPIや機能については、省略していることがあります。
- 例やデモについて、実際にページ内で動作させる関係で一部ソースコードを変更している場合や、 その例で使用しているコンテンツの単語や文章などを日本人向けに変更しいてる場合があります。
- MDNの更新頻度が高いため、元のコンテンツと比べ情報が古くなっている可能性があります。
- "訳注:"などの断わりを入れた上で、日本人向けの情報の追記を行っている事があります。