.link()

他のURLへのハイパーテキストリンクとして表示される文字列となる<a>のHTML要素を作成します。

文法

str.link(url)
引数 説明
url aタグのhref属性の値となる文字列を指定します。 これは、&文字は&amp;に、"文字は&quot;にエスケープされた正しい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の実体参照である&quot;に自動的に置換されるようになりました。

関連項目

 Back to top

© 2017 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.

このページは、ページトップのURL先のMozilla Developer Network(以下、MDN)のコンテンツを翻訳した内容を基に構成されています。 構成について異なる点も含まれますので、下記の項目を確認し、必要に応じて元のコンテンツをご確認ください。 もし、誤訳などの間違いを見つけましたら、 @tomofまで教えていただければ幸いです。

  • 特定のブラウザに特化しすぎている情報やあまりにも古い情報、 または試験的に導入されているようなAPIや機能については、省略していることがあります。
  • 例やデモについて、実際にページ内で動作させる関係で一部ソースコードを変更している場合や、 その例で使用しているコンテンツの単語や文章などを日本人向けに変更しいてる場合があります。
  • MDNの更新頻度が高いため、元のコンテンツと比べ情報が古くなっている可能性があります。
  • "訳注:"などの断わりを入れた上で、日本人向けの情報の追記を行っている事があります。