Attributs

download

Sans valeur, le navigateur proposera un nom de fichier/extension, généré à partir de diverses sources :

L'en-tête HTTP Content-Disposition
Le segment final dans l'URL : path
Le Type MIME (de l'en-tête Content-Type, le début d'une URL data:, ou Blob.type pour une URL blob:).

La définition d'une valeur la suggère comme nom de fichier. Les caractères / et \ sont convertis en caractères de soulignement (_). Les systèmes de fichiers peuvent interdire d'autres caractères dans les noms de fichiers, les navigateurs ajusteront donc le nom suggéré si nécessaire.

Note :

download ne fonctionne que pour les URLs de même origine, ou les schémas blob: et data:.
-
Si l'en-tête Content-Disposition comporte des informations différentes de celles de l'attribut download, le comportement résultant peut différer :
-
- Si l'en-tête spécifie un nom de fichier, il a priorité sur un nom de fichier spécifié dans l'attribut download.
- Si l'en-tête spécifie une disposition de inline, Chrome, et Firefox 82+, donnent la priorité à l'attribut et le traitent comme un téléchargement. Les versions de Firefox antérieures à 82 donnent la priorité à l'en-tête et affichent le contenu en ligne.
-

href

L'URL vers laquelle pointe l'hyperlien. Les liens ne sont pas limités aux URL basées sur HTTP - ils peuvent utiliser n'importe quel schéma d'URL pris en charge par les navigateurs :

Sections d'une page avec des fragments d'URL
Des morceaux de fichiers médias avec des fragments de médias
Les numéros de téléphone avec l'URL tel:.
Les adresses électroniques avec l'URL mailto:.
Bien que les navigateurs web puissent ne pas prendre en charge d'autres schémas d'URL, les sites web le peuvent avec registerProtocolHandler().

hreflang

Donne des indications sur le langage humain de l'URL liée. Aucune fonctionnalité intégrée. Les valeurs autorisées sont les mêmes que l'attribut global lang.

ping

Contient une liste d'URL séparées par des espaces vers lesquelles sont envoyées des requêtes POST avec le corps PING lorsque l'utilisateur suit le lien. Cet attribut est généralement utilisé pour tracer un utilisateur.

referrerpolicy {{experimental_inline}}

La portion du referrer envoyer lors du suivi du lien. Voir Referrer-Policy pour les valeurs possibles et leurs effets.

rel

Cet attribut indique la relation entre la cible du lien et l'objet faisant le lien. La valeur est une liste de types de liens séparés par des espaces.

target

Où afficher l'URL liée, comme nom d'un contexte de navigation (un onglet, une fenêtre ou un <iframe>). Les mots-clés suivants ont des significations spéciales pour l'endroit où charger l'URL : -

_self : le contexte de navigation actuel. (Par défaut)
_blank : généralement un nouvel onglet, mais les utilisateurs peuvent configurer les navigateurs pour ouvrir une nouvelle fenêtre à la place.
_parent : le contexte de navigation parent de celui en cours. S'il n'y a pas de parent, il se comporte comme _self.
_top : le contexte de navigation le plus haut (le contexte "le plus haut" qui est un ancêtre du contexte actuel). S'il n'a aucun ancêtre, il se comporte comme _self.

Note :Définir target="_blank" sur les éléments <a> fournit implicitement le même comportement rel que définir rel="noopener" qui ne définit pas window.opener. Voir la compatibilité des navigateurs pour le support.

type

Donne des indications sur le format de l'URL liée avec un Type MIME. Aucune fonctionnalité intégrée.

Attributs obsolètes

charset {{Deprecated_Inline}}

Fait allusion aux encodages des caractères de l'URL liée. -

Note :Cet attribut est déprécié et ne doit pas être utilisé par les auteurs. Utilisez l'en-tête HTTP Content-Type sur l'URL liée.

coords {{Deprecated_Inline}}

Utilisé avec l'attribut shape. Une liste de coordonnées séparées par des virgules.

name {{Deprecated_Inline}}

Était nécessaire pour définir un emplacement cible possible dans une page. En HTML 4.01, id et name pouvaient tous deux être utilisés sur <a>, pour autant qu'ils aient des valeurs identiques. -

Note :Utilisez l'attribut universel id à la place.

rev {{Deprecated_Inline}}

Spécifiait un lien inverse ; l'opposé de l'attribut rel. Déprécié pour avoir été très confus.

shape {{Deprecated_Inline}}

La forme de la région de l'hyperlien dans une carte d'image. -

Note :Utilisez plutôt l'élément <area> pour les cartes d'images.

Propriétés

`** (pour ancre ou _anchor_ en anglais), avec [son attribut `href`](#href), crée un lien hypertexte vers des pages web, des fichiers, des adresses e-mail, des emplacements se trouvant dans la même page, ou tout ce qu'une URL peut adresser. Le contenu de chaque élément `

` **doit** indiquer la destination du lien. Si [l'attribut `href`](#href) est présent, appuyer sur la touche entrée en se concentrant sur l'élément `

` l'activera. + +{{EmbedInteractiveExample("pages/tabbed/a.html")}} + +## Attributs + +Cet élément inclut les [attributs universels](/fr/docs/Web/HTML/Global_attributes). + +- **`download`** + + - : Sans valeur, le navigateur proposera un nom de fichier/extension, généré à partir de diverses sources : + + - L'en-tête HTTP [`Content-Disposition`](/fr/docs/Web/HTTP/Headers/Content-Disposition) + - Le segment final dans l'URL : [path](/fr/docs/Web/API/URL/pathname) + - Le [Type MIME](/fr/docs/Glossary/MIME_type) (de l'en-tête [`Content-Type`](/fr/docs/Web/HTTP/Headers/Content-Type), le début d'une URL [`data:`](/fr/docs/Web/HTTP/Basics_of_HTTP/Data_URIs), ou [`Blob.type`](/fr/docs/Web/API/Blob/type) pour une URL [`blob:`](/fr/docs/Web/API/URL/createObjectURL)). + + La définition d'une valeur la suggère comme nom de fichier. Les caractères `/` et `\` sont convertis en caractères de soulignement (`_`). Les systèmes de fichiers peuvent interdire d'autres caractères dans les noms de fichiers, les navigateurs ajusteront donc le nom suggéré si nécessaire. + + > **Note :** + > + > - `download` ne fonctionne que pour [les URLs de même origine](/fr/docs/Web/Security/Same-origin_policy), ou les schémas `blob:` et `data:`. + > - Si l'en-tête `Content-Disposition` comporte des informations différentes de celles de l'attribut `download`, le comportement résultant peut différer : + > + > - Si l'en-tête spécifie un `nom de fichier`, il a priorité sur un nom de fichier spécifié dans l'attribut `download`. + > - Si l'en-tête spécifie une disposition de `inline`, Chrome, et Firefox 82+, donnent la priorité à l'attribut et le traitent comme un téléchargement. Les versions de Firefox antérieures à 82 donnent la priorité à l'en-tête et affichent le contenu en ligne. + +- **`href`** + + - : L'URL vers laquelle pointe l'hyperlien. Les liens ne sont pas limités aux URL basées sur HTTP - ils peuvent utiliser n'importe quel schéma d'URL pris en charge par les navigateurs : + + - Sections d'une page avec des fragments d'URL + - Des morceaux de fichiers médias avec des fragments de médias + - Les numéros de téléphone avec l'URL `tel:`. + - Les adresses électroniques avec l'URL `mailto:`. + - Bien que les navigateurs web puissent ne pas prendre en charge d'autres schémas d'URL, les sites web le peuvent avec [`registerProtocolHandler()`](/fr/docs/Web/API/Navigator/registerProtocolHandler). + +- **`hreflang`** + - : Donne des indications sur le langage humain de l'URL liée. Aucune fonctionnalité intégrée. Les valeurs autorisées sont les mêmes que [l'attribut global `lang`](/fr/docs/Web/HTML/Global_attributes/lang). +- **`ping`** + - : Contient une liste d'URL séparées par des espaces vers lesquelles sont envoyées des requêtes [`POST`](/fr/docs/Web/HTTP/Methods/POST) avec le corps `PING` lorsque l'utilisateur suit le lien. Cet attribut est généralement utilisé pour tracer un utilisateur. +- **`referrerpolicy`** {{experimental_inline}} + - : La portion du [referrer](/fr/docs/Web/HTTP/Headers/Referer) envoyer lors du suivi du lien. Voir [`Referrer-Policy`](/fr/docs/Web/HTTP/Headers/Referrer-Policy) pour les valeurs possibles et leurs effets. +- **`rel`** + - : Cet attribut indique la relation entre la cible du lien et l'objet faisant le lien. La valeur est une liste de [types de liens](/fr/docs/Web/HTML/Link_types) séparés par des espaces. +- **`target`** + + - : Où afficher l'URL liée, comme nom d'un _contexte de navigation_ (un onglet, une fenêtre ou un [`