Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
HTMLAnchorElement
Baseline Widely available *
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.
* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.
L'interfaceHTMLAnchorElement représente les éléments d'hyperlien et fournit des propriétés et méthodes spécifiques (en plus de celles de l'interface objetHTMLElement dont elle hérite) pour manipuler la présentation et la mise en page de ces éléments. Cette interface correspond à l'élément HTML<a> ; à ne pas confondre avec<link>, qui est représenté par l'interfaceHTMLLinkElement.
Dans cet article
Propriétés d'instance
Hérite des propriétés de son parent,HTMLElement.
HTMLAnchorElement.attributionSrcContexte sécuriséExpérimentalObtient et définit l'attribut
attributionsrcsur un élément<a>de façon programmatique, reflétant la valeur de cet attribut.attributionsrcindique que vous souhaitez que le navigateur envoie un en-têteAttribution-Reporting-Eligible. Côté serveur, cela sert à déclencher l'envoi d'un en-têteAttribution-Reporting-Register-Sourcedans la réponse, afin d'enregistrer une source d'attribution basée sur la navigation.HTMLAnchorElement.downloadUne chaîne de caractères indiquant que la ressource liée doit être téléchargée plutôt qu'affichée dans le navigateur. La valeur représente le nom de fichier proposé. Si ce nom n'est pas valide pour le système d'exploitation sous-jacent, le navigateur l'adaptera.
HTMLAnchorElement.hashUne chaîne de caractères représentant l'identifiant de fragment, y compris le dièse (
#) initial, le cas échéant, dans l'URL référencée.HTMLAnchorElement.hostUne chaîne de caractères représentant le nom d'hôte et le port (si ce n'est pas le port par défaut) dans l'URL référencée.
HTMLAnchorElement.hostnameUne chaîne de caractères représentant le nom d'hôte dans l'URL référencée.
HTMLAnchorElement.hrefUne chaîne de caractères résultant de l'analyse de l'attribut HTML
hrefrelativement au document, contenant une URL valide de la ressource liée.HTMLAnchorElement.hreflangUne chaîne de caractères reflétant l'attribut HTML
hreflang, indiquant la langue de la ressource liée.HTMLAnchorElement.originLecture seuleRetourne une chaîne de caractères contenant l'origine de l'URL, c'est-à-dire son schéma, son domaine et son port.
HTMLAnchorElement.passwordUne chaîne de caractères contenant le mot de passe spécifié avant le nom de domaine.
HTMLAnchorElement.pathnameUne chaîne de caractères contenant un
/initial suivi du chemin de l'URL, sans inclure la chaîne de requête ni le fragment.HTMLAnchorElement.pingUne liste d'URL séparées par des espaces. Lorsque le lien est suivi, le navigateur enverra des requêtes
POSTavec le corps PING à ces URL.HTMLAnchorElement.portUne chaîne de caractères représentant la partie port, le cas échéant, de l'URL référencée.
HTMLAnchorElement.protocolUne chaîne de caractères représentant la partie protocole, y compris les deux-points finaux (
:), de l'URL référencée.HTMLAnchorElement.referrerPolicyUne chaîne de caractères reflétant l'attribut HTML
referrerpolicyindiquant quel référent utiliser.HTMLAnchorElement.relUne chaîne de caractères reflétant l'attribut HTML
rel, spécifiant la relation entre l'objet cible et l'objet lié.HTMLAnchorElement.relListLecture seuleRetourne un
DOMTokenListqui reflète l'attribut HTMLrel, sous forme de liste de jetons.HTMLAnchorElement.searchUne chaîne de caractères représentant la partie recherche, y compris le point d'interrogation initial (
?), le cas échéant, de l'URL référencée.HTMLAnchorElement.targetUne chaîne de caractères reflétant l'attribut HTML
target, indiquant où afficher la ressource liée.HTMLAnchorElement.textUne chaîne de caractères équivalente à la propriété
Node.textContent.HTMLAnchorElement.typeUne chaîne de caractères reflétant l'attribut HTML
type, indiquant le type MIME de la ressource liée.HTMLAnchorElement.usernameUne chaîne de caractères contenant le nom d'utilisateur spécifié avant le nom de domaine.
Propriétés obsolètes
HTMLAnchorElement.charsetObsolèteUne chaîne de caractères représentant l'encodage des caractères de la ressource liée.
HTMLAnchorElement.coordsObsolèteUne chaîne de caractères représentant une liste de coordonnées séparées par des virgules.
HTMLAnchorElement.nameObsolèteUne chaîne de caractères représentant le nom de l'ancre.
HTMLAnchorElement.revObsolèteUne chaîne de caractères représentant l'attribut HTML
rev, spécifiant la relation de l'objet lien avec l'objet cible.HTMLAnchorElement.shapeObsolèteUne chaîne de caractères représentant la forme de la zone active.
Méthodes d'instance
Hérite des méthodes de son parent,HTMLElement.
HTMLAnchorElement.toString()Retourne une chaîne de caractères contenant l'URL complète. C'est un synonyme de
HTMLAnchorElement.href, mais il ne peut pas être utilisé pour modifier la valeur.
Spécifications
| Specification |
|---|
| HTML> # htmlanchorelement> |
Compatibilité des navigateurs
Voir aussi
- Élément HTML implémentant cette interface :
<a>