HTML DOM Document links 属性

定義と用法

links ドキュメント内のすべてのリンクの集合を返します。

links 属性は HTMLCollection

links 属性は読み取り専用です。

コレクション内のリンクは、href属性を持つ<a>および<area>要素を表します。

参照も:

HTML DOM Anchor オブジェクト

HTML DOM Area オブジェクト

HTML <a> タグ

HTML <area> タグ

HTML リンク

HTMLCollection

HTMLCollection HTML要素の类似配列の集合(リスト)です。

インデックスを使用してコレクション内の要素にアクセスできます(0から始まる)。

length 属性はコレクション内の要素の数を返します。

インスタンス

例1

ドキュメント内のリンク数を返します:

let numb = document.links.length;

実際に試してみてください

例2

ドキュメント内の最初のリンクのURLを取得します:

let url = document.links[0].href;

実際に試してみてください

例3

ドキュメント内の最初のリンクのURLを取得します:

let url = document.links.item(0).href;

実際に試してみてください

例4

id="myLink"の要素のURLを取得します:

let url = document.links.namedItem("myLink").href;

実際に試してみてください

例5

ドキュメント内の最初のリンクに赤い枠線を追加します:

document.links[0].style.border = "5px solid red";

実際に試してみてください

例6

すべてのリンクを巡回し、各リンクのURL(href)を出力します:

const links = document.links;
let text = "";
for (let i = 0; i < links.length; i++) {
  text += links[i].href + "<br>";
}

実際に試してみてください

文法

document.links

属性

属性 説明
length コレクション内の要素の数。

メソッド

メソッド 説明
[index]

指定されたインデックスの要素(0から始まる)を返します。

インデックスが範囲外の場合、nullを返します。

item(index)

指定されたインデックスの要素(0から始まる)を返します。

インデックスが範囲外の場合、nullを返します。

namedItem(id)

指定された id を返します。

の要素が id 存在しない場合、nullを返します。

返り値

タイプ 説明
オブジェクト

HTMLCollectionオブジェクト。

ドキュメント内のすべての<a>および<area>要素。

ソースコード内での出現順序に従って並べ替えます。

ブラウザのサポート

document.links DOMレベル1(1998)の機能です。

すべてのブラウザがサポートしています:

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
サポート 9-11 サポート サポート サポート サポート