HTMLAnchorElement : propriété href
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La propriété href de l'interface HTMLAnchorElement est un convertisseur en chaîne qui retourne une chaîne de caractères contenant l'URL complète et permet de modifier la valeur de l'attribut href d'un élément correspondant (ou une chaîne de caractères vide si href n'est pas défini). La définition de cette propriété met à jour l'attribut href de l'élément avec la valeur fournie.
Valeur
Une chaîne de caractères.
- Si l'attribut
hrefest absent, la valeur est une chaîne de caractères vide (""). - Si l'attribut
hrefest présent mais n'est pas une URL relative ou absolue valide, la valeur est celle de l'attribut telle quelle. - Si l'attribut
hrefest présent et est une URL relative ou absolue valide, la valeur est l'URL absolue, résolue par rapport à l'URL de base du document. La chaîne de caractères vide ("") est considérée comme une URL relative valide, résolue par rapport à l'URL de base du document.
Exemples
Un élément <a> nouvellement créé n'a pas d'attribut href, donc sa propriété href retourne une chaîne de caractères vide.
const ancre = document.createElement("a");
console.log(ancre.href); // ""
Si l'attribut est défini sur une chaîne de caractères vide, la propriété retourne l'URL de base du document, car la chaîne de caractères vide est une URL relative valide.
ancre.href = "";
console.log(ancre.href); // "https://developer.mozilla.org/fr/docs/Web/API/HTMLAnchorElement/href"
Si l'attribut est défini sur une URL relative, la propriété retourne l'URL absolue résolue par rapport à l'URL de base du document.
ancre.href = "../../..";
console.log(ancre.href); // "https://developer.mozilla.org/fr/docs/"
Notez que la valeur de l'attribut reste telle quelle, sans résolution.
console.log(ancre.getAttribute("href")); // "../../.."
Si l'attribut est défini sur une URL absolue, la propriété retourne cette URL absolue telle quelle.
ancre.href = "https://exemple.com/chemin";
console.log(ancre.href); // "https://exemple.com/chemin"
Si l'attribut est défini sur une URL invalide, la propriété retourne la valeur de l'attribut telle quelle.
ancre.href = "https://";
console.log(ancre.href); // "https://"
Spécifications
| Spécification |
|---|
| HTML # dom-hyperlink-href-dev |
Compatibilité des navigateurs
Voir aussi
- L'interface
HTMLAnchorElementà laquelle elle appartient.