HTML DOM Document links propriété

Définition et utilisation

links La propriété retourne l'ensemble de tous les liens du document.

links 属性返回 HTMLCollection。

links 属性是只读的。

集合中的链接代表拥有 href 属性的 和 元素。

另请参阅：

Objet Anchor DOM HTML

Objet Area DOM HTML

Balise <a> HTML

Balise <area> HTML

Lien HTML

HTMLCollection

HTMLCollection 是 HTML 元素的类似数组的集合（列表）。

Les éléments de la collection peuvent être accédés par index (commençant à 0).

length La propriété retourne le nombre d'éléments dans la collection.

Instance

Exemple 1

Retourner le nombre de liens dans le document :

let numb = document.links.length;

Essayez-le vous-même

Exemple 2

Obtenir l'URL du premier lien du document :

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

Essayez-le vous-même

Exemple 3

Obtenir l'URL du premier lien du document :

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

Essayez-le vous-même

Exemple 4

Obtenir l'URL de l'élément avec id="myLink" :

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

Essayez-le vous-même

Exemple 5

Ajouter une bordure rouge à la première lien du document :

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

Essayez-le vous-même

Exemple 6

Parcourir tous les liens et afficher l'URL de chaque lien (href) :

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

Essayez-le vous-même

Syntaxe

document.links

Propriété

Propriété Description
length Nombre d'éléments dans la collection.

Méthode

Méthode Description
[index]

Retourne l'élément avec l'index spécifié (commençant à 0).

Si l'index dépasse la portée, retourne null.
item(index)

Retourne l'élément avec l'index spécifié (commençant à 0).

Si l'index dépasse la portée, retourne null.
namedItem(id)

retourne avec id de l'élément.

si id Inexistant, retourne null.

Valeur de retour

Type Description
Objet

Objet HTMLCollection.

Tous les éléments <a> et <area> présents dans le document.

Trié selon l'ordre de leur apparition dans le code source.

Support du navigateur

document.links C'est une caractéristique du niveau DOM 1 (1998).

Tous les navigateurs le supportent :

Chrome IE Edge Firefox Safari Opera
Chrome IE Edge Firefox Safari Opera
supporté 9-11 supporté supporté supporté supporté