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

CKTIS / HTML

href — adresse du lien ou URL de base

L’attribut href indique une URL utilisée par les éléments a, area, link et base. Sa signification dépend de l’élément : il désigne la destination d’un hyperlien, l’adresse d’une ressource associée ou l’URL de base du document. Les URL relatives sont résolues par rapport à l’URL de base.

Version : WHATWG HTML Living Standard; index snapshot date recorded separately

Syntaxe

href="URL"

href n’est pas un attribut global. Sur a et area, il indique la destination d’un hyperlien ; sans cet attribut, ces éléments ne créent pas d’hyperliens. Sa valeur doit être une URL valide, éventuellement entourée d’espaces. Elle peut être absolue ou relative, y compris sous la forme d’un fragment comme #intro.

Sur link, href indique l’adresse d’une ressource associée, tandis que rel précise la relation, par exemple stylesheet. Lorsque href est présent, l’URL qu’il contient ne doit pas être vide. Un élément link doit avoir au moins l’un des attributs href ou imagesrcset ; href seul ne détermine pas la manière dont la ressource est traitée.

Sur base, href indique l’URL de base du document, utilisée pour résoudre les URL relatives. Un document peut contenir au plus un élément base. S’il possède href, celui-ci doit précéder les autres éléments ayant des attributs dont la valeur est une URL. Il modifie aussi la résolution des liens vers un fragment, comme #intro.

Dans l’exemple, getAttribute('href') renvoie la valeur enregistrée de l’attribut, tandis que la propriété guide.href renvoie l’URL résolue et sérialisée. L’élément base explicite rend le résultat indépendant de l’emplacement où le fichier est enregistré. Un href="" vide sur a n’équivaut pas à l’absence de l’attribut : il crée tout de même un hyperlien.

Exemples

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>href example</title>
  <base href="https://example.org/docs/">
</head>
<body>
  <a id="guide" href="guide.html#intro">Guide</a>
  <pre id="result"></pre>
  <script>
    const guide = document.getElementById('guide');
    document.getElementById('result').textContent =
      guide.getAttribute('href') + '\n' + guide.href;
  </script>
</body>
</html>

Résultat

guide.html#intro
https://example.org/docs/guide.html#intro

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources