Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

HTMLAnchorElement : adresse du lien et cible de navigation

`href` fixe l’adresse du lien ; `target` indique au navigateur dans quel contexte de navigation le suivre.

Version : ECMAScript 2024 and the current web platform; runtime support varies

Syntaxe

anchor.href;                      // Reads the URL property
anchor.href = urlString;           // Sets the href attribute
anchor.target;                    // Reads the target attribute as a string
anchor.target = targetName;       // Sets the target attribute
anchor.getAttribute("href");       // Reads the stored value or null
anchor.getAttribute("target");     // Reads the stored value or null

href et target sont deux propriétés accessibles en lecture et en écriture sur un élément a. Elles relèvent du DOM de la plateforme web, pas d’ECMAScript 2024. Une affectation modifie l’attribut HTML correspondant sans déclencher de navigation.

À la lecture, anchor.href renvoie une URL absolue sous forme de chaîne, résolue à partir de l’URL de base actuelle du document, qu’un élément base peut définir. Si l’attribut href est absent, la propriété renvoie "" et l’élément ne crée pas d’hyperlien. Si l’analyse de l’URL échoue, la propriété renvoie la valeur de l’attribut telle quelle, sans lever d’exception. Un attribut présent mais vide est une référence relative vide, et non une adresse absente. getAttribute("href") renvoie la valeur stockée, ou null si l’attribut manque.

anchor.target renvoie la valeur stockée, ou "" si l’attribut est absent, et non la cible de navigation effective. Lorsqu’on suit le lien, l’absence d’attribut permet d’utiliser la cible par défaut de base ; à défaut, le contexte courant est utilisé. _self désigne le contexte courant, _parent le contexte parent et _top le contexte de plus haut niveau. _blank demande un nouveau contexte, sans imposer un onglet plutôt qu’une fenêtre. Un nom peut désigner un contexte nommé existant, par exemple un iframe.

Selon le standard HTML actuel, _blank implique le comportement de rel="noopener", sauf demande explicite d’un ouvreur avec rel="opener". En indiquant rel="noopener", on empêche le nouveau contexte d’obtenir une référence à son ouvreur via window.opener ; rel="noreferrer" supprime aussi les informations sur la page d’origine.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTMLAnchorElement: href and target</title>
</head>
<body>
  <script>
    const doc = document.implementation.createHTMLDocument();
    const base = doc.createElement("base");
    base.href = "https://example.com/course/";
    base.target = "_self";
    doc.head.append(base);

    const anchor = doc.createElement("a");
    console.log(JSON.stringify([anchor.href, anchor.getAttribute("href")]));

    anchor.href = "lesson-38#demo";
    console.log(JSON.stringify([anchor.getAttribute("href"), anchor.href]));
    console.log(JSON.stringify([anchor.target, anchor.getAttribute("target")]));

    anchor.target = "_blank";
    console.log(JSON.stringify([anchor.target, anchor.getAttribute("target")]));
  </script>
</body>
</html>

Résultat

["",null]
["lesson-38#demo","https://example.com/course/lesson-38#demo"]
["",null]
["_blank","_blank"]

Enregistrez l’exemple dans un fichier HTML, ouvrez-le dans un navigateur et consultez la sortie dans la console. Un document distinct fixe l’URL de base. Comparez les propriétés aux valeurs des attributs : la cible par défaut du document n’apparaît pas dans `anchor.target`. Le code ne suit pas le lien.

Leçons associées

  • JavaScript · Leçon 38 · Avancé · Version : 4

Sources