From a47584de1bd47788cb5aa6178fa88b31977b2a8e Mon Sep 17 00:00:00 2001 From: tristantheb Date: Sat, 19 Jun 2021 10:25:05 +0200 Subject: UPDATE: Update translation of the HTML elements — 🛠 Priority work area (#500) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * UPDATE: Updating pages starting with A * FIX: Update missing KS to html anchor * Review HTML Element a * Review HTML Element abbr * Review HTML Element acronym * Review HTML Element address * Review HTML Element applet * Review HTML Element area * Review HTML Element article * Review HTML Element aside * Review HTML Element audio * UPDATE: Updating pages wtarting with B * Review HTML Element b * Review HTML Element base * Review HTML Element basefont * Review HTML Element bdi * Review HTML Element bdo * Review HTML Element big * Review HTML Element blink * Review HTML Element blockquote * Review HTML Element body * Review HTML Element br * Review HTML Element button * Review HTML Element button - rm HTMLRef * Review HTML Element button - lint link * UPDATE: Updating pages starting with C * UPDATE: Updating pages starting with D * UPDATE: Refresh the reference page * UPDATE: Updating pages starting with E * Review HTML Element canvas * Review HTML Element caption * Review HTML Element center * Review HTML Element cite * UPDATE: Updating pages starting with F * BCD: Update all updated pages with new BCD format * FIX: add missing bracket * Review - HTML element - code * Review - HTML Element - col * Review - HTML Element - colgroup * Review - HTML Element - content * Review - HTML Element - data * Review - HTML Element - datalist * Review - HTML Element - dd * Review - HTML Element - del * Review - HTML Element * Review - HTML Element - dfn * Review - HTML Element - dialog * Review - HTML element - dir * Review - HTML Element div * Review - HTML Element - dl * Review - HTML Element - dt * Review - HTML Element - em * Review - HTML Element - embed * Review - HTML Element - fieldset * Review - HTML Element - figcaption * Review - HTML Element - figure * Review - HTML Element - font * Review - HTML Element - footer * Review - HTML Element - form * Review - HTML Element - frame * Review - HTML Element - frameset * Review updates since PR start - A * Review updates since PR start - B * Review updates since PR start - C * Review updates since PR start - D * Review updates since PR start - F Co-authored-by: julieng --- files/fr/web/html/element/a/index.html | 568 ++++++++++++++++++++------------- 1 file changed, 339 insertions(+), 229 deletions(-) (limited to 'files/fr/web/html/element/a') diff --git a/files/fr/web/html/element/a/index.html b/files/fr/web/html/element/a/index.html index e9ea38803c..ef41ac41a5 100644 --- a/files/fr/web/html/element/a/index.html +++ b/files/fr/web/html/element/a/index.html @@ -2,332 +2,442 @@ title: ' : l''Ă©lĂ©ment d''ancre' slug: Web/HTML/Element/a tags: - - Contenu + - Content - Element - HTML + - HTML text-level semantics + - HTML:Flow content + - HTML:Interactive content + - HTML:Palpable Content + - HTML:Phrasing content + - Inline element - Reference - Web translation_of: Web/HTML/Element/a +browser-compat: html.elements.a ---
{{HTMLRef}}
-

L'Ă©lĂ©ment <a> (pour ancre ou anchor en anglais) dĂ©finit un hyperlien vers un autre endroit de la mĂȘme page ou vers une autre page sur le Web.

+

L'Ă©lĂ©ment HTML <a> (pour ancre ou anchor en anglais), avec son attribut 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 <a> doit indiquer la destination du lien. Si l'attribut href est prĂ©sent, appuyer sur la touche entrĂ©e en se concentrant sur l'Ă©lĂ©ment <a> l'activera.

{{EmbedInteractiveExample("pages/tabbed/a.html")}}
- +

Attributs

-

Attributs

- -

Cet élément inclut les attributs universels.

+

Cet élément inclut les attributs universels.

-
{{htmlattrdef("download")}} {{HTMLVersionInline(5)}}
-
Cet attribut indique au navigateur de télécharger l'objet vers lequel pointe l'URL plutÎt que d'y diriger l'utilisateur. Cela ouvre une invite pour enregistrer la cible du lien comme un fichier local. Si l'attribut a une valeur, le navigateur doit l'interpréter comme le nom de fichier par défaut pour l'invite qui s'ouvre (l'utilisateur pourra bien entendu modifier le nom de fichier avant de cliquer sur « Enregistrer »). Il n'y a aucune limitation sur les valeurs autorisées, mais il faut se souvenir ici que la plupart des systÚmes de fichiers ont des limitations concernant la ponctuation dans les noms de fichier, et que les navigateurs procéderont sûrement à des ajustements en conséquence (par exemple, les barres obliques et barres obliques inversées seront sans doute converties en tirets bas). -
-

Note :

- -
    -
  • Cet attribut ne fonctionne que pour les URL partageant la mĂȘme origine mais jamais pour les URI utilisant le schĂ©ma file:.
    • -
  • Bien que les URL HTTPS doivent provenir de la mĂȘme origine, les URL blob:, data: et filesystem: peuvent ĂȘtre utilisĂ©es afin de simplifier le tĂ©lĂ©chargement de contenus gĂ©nĂ©rĂ©s par un programme JavaScript (ex. : une image gĂ©nĂ©rĂ©e automatiquement).
    • -
  • Si l'en-tĂȘte HTTP {{HTTPHeader("Content-Disposition")}} est prĂ©sent et fournit un nom de fichier diffĂ©rent que celui fourni par l'attribut alors ce sera l'en-tĂȘte HTTP qui aura la prioritĂ© sur l'attribut.
    • -
  • Si l'attribut est prĂ©sent et que Content-Disposition: vaut inline, Firefox donnera la prioritĂ© Ă  l'en-tĂȘte, Chrome donnera la prioritĂ© Ă  l'attribut.
    • -
  • Cet attribut est uniquement respectĂ© pour les liens des ressources de la mĂȘme origine.
    • -
-
-
-
{{htmlattrdef("href")}}
-
L'attribut href indique la cible du lien sous la forme d'une URL ou d'un fragment d'URL. Un fragment d'URL est un nom précédé par un diÚse (#), qui indique une cible interne au document (un ID). Les URL ne se limitent pas au documents web sur HTTP. Les URL peuvent utiliser n'importe quel protocole supporté par le navigateur. Par exemple, file, ftp et mailto fonctionnent avec la plupart des agents-utilisateur. -
-

Note : Le fragment spĂ©cial href="#top" ou le fragment vide href="#" peuvent ĂȘtre utilisĂ©s pour crĂ©er un lien de retour vers le haut de la page ; par exemple <a href="#top">Retourner en haut</a>. Ce comportement est dĂ©fini par HTML5.

-
-
-
{{htmlattrdef("hreflang")}}
-
Cet attribut indique la langue de la ressource liĂ©e. Il est purement indicatif. Les valeurs permises pour HTML5 sont dĂ©finies par BCP47 et pour HTML 4 par la RFC1766. Cet attribut ne doit ĂȘtre utilisĂ© que si l'attribut {{htmlattrxref("href", "a")}} est prĂ©sent.
-
{{htmlattrdef("ping")}}
-
Contient une liste d'URL sĂ©parĂ©es par des espaces vers lesquelles sont envoyĂ©es des requĂȘtes {{HTTPMethod("POST")}} avec le corps PING lorsque l'utilisateur suit le lien. Cet attribut est gĂ©nĂ©ralement utilisĂ© pour tracer un utilisateur.
-
{{htmlattrdef("referrerpolicy")}} {{experimental_inline}}
-
Une chaßne de caractÚres qui indique le référent à utiliser lors de la récupération de la ressource : -
    -
  • 'no-referrer' indique que l'en-tĂȘte Referer ne sera pas envoyĂ©.
    • -
  • 'no-referrer-when-downgrade' indique que l'en-tĂȘte Referer ne sera pas envoyĂ© lorsque l'utilisateur navigue depuis une origine sans TLS/HTTPS. C'est le comportement par dĂ©faut de l'agent utilisateur si aucune autre politique n'est spĂ©cifiĂ©e.
    • -
  • 'origin' indique que le rĂ©fĂ©rent sera l'origine de la page (ce qui correspond au schĂ©ma utilisĂ©, Ă  l'hĂŽte et au port).
    • -
  • 'origin-when-cross-origin' indique que lorsqu'on navigue sur d'autres origines, seule l'origine du document sera envoyĂ©e. Lorsqu'on navigue sur la mĂȘme origine, le chemin de la ressource sera inclus dans le rĂ©fĂ©rent.
    • -
  • 'strict-origin-when-cross-origin' fonctionne comme origin-when-cross-origin mais les en-tĂȘtes d'origine sont envoyĂ©s via HTTPS plutĂŽt que par HTTP.
    • -
  • 'unsafe-url' indique que le rĂ©fĂ©rent envoyĂ© inclura l'origine et le chemin (mais pas le fragment, le mot de passe ou le nom d'utilisateur). Ce cas n'est pas considĂ©rĂ© comme sĂ»r car il peut laisser fuiter des origines et des chemins de ressources protĂ©gĂ©es par TLS vers des origines non-sĂ©curisĂ©es.
    • -
-
-
{{htmlattrdef("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.
-
{{htmlattrdef("target")}}
-
Cet attribut indique oĂč afficher la ressource liĂ©e. Il s'agit du nom, ou du mot-clĂ©, d'un contexte de navigation (par exemple, un onglet, une fenĂȘtre, ou une {{HTMLElement("iframe")}}). Les mots-clĂ©s suivants ont un sens particulier : -
    -
  • _self : charge la rĂ©ponse dans le contexte de navigation courant. Il s'agit de la valeur par dĂ©faut quand l'attribut n'est pas renseignĂ©.
    • -
  • _blank : charge la rĂ©ponse dans un nouveau contexte de navigation. -
      -
    • Ajouter un lien vers une autre page en utilisant target="_blank" exĂ©cutera la page dans le mĂȘme processus que la page courante. Si la nouvelle page consomme de nombreuses ressources, les performances de la page courante pourront en pĂątir. Pour Ă©viter ce problĂšme, on pourra utiliser rel="noopener".
      • -
    -
    • -
  • _parent : charge la rĂ©ponse dans le {{HTMLElement("frameset")}} HTML4 parent de la frame courante ou dans le contexte de navigation HTML5 parent relativement au contexte courant). S'il n'y a pas de parent, l'option se comporte de la mĂȘme façon que _self.
    • -
  • _top : En HTML4 : charge la rĂ©ponse dans la fenĂȘtre originale, annulant toutes les autres frames. En HTML5 : charge la rĂ©ponse dans le contexte de navigation de plus haut niveau (c'est Ă  dire, le contexte de navigation parent par rapport Ă  l'actuel, et qui n'a lui-mĂȘme aucun parent). S'il n'y a pas de parent, l'option se comporte de la mĂȘme façon que _self.
    • -
- -

Lorsque target est utilisé, on pourra ajouter rel="noopener noreferrer" afin d'éviter la fuite de données via l'API Window.opener.

-
-
{{htmlattrdef("type")}}
-
Cet attribut indique le type de média de la cible du lien, sous la forme d'un type MIME. Généralement, il s'agit d'une information purement indicative.
+
download
+
+
    +
  • Sans valeur, le navigateur proposera un nom de fichier/extension, gĂ©nĂ©rĂ© Ă  partir de diverses sources : + +
    • +
  • 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

+

Attributs obsolĂštes

-
{{htmlattrdef("charset")}} {{Obsolete_Inline("HTML5")}}
-
Cet attribut définit le jeu de caractÚres de la ressource liée. La valeur est une liste de jeux de caractÚres (défini dans RFC 2045) séparés par des espaces ou des virgules. La valeur par défaut est ISO-8859-1. -
-

Note d'utilisation : Cet attribut est obsolĂšte en HTML5, et ne doit plus ĂȘtre utilisĂ© par les auteurs. Pour obtenir le mĂȘme effet, utiliser l'entĂȘte HTTP Content-Type sur la ressource liĂ©e.

-
-
-
{{htmlattrdef("coords")}} {{HTMLVersionInline(4)}} seulement, {{Obsolete_Inline("HTML5")}}
-
Pour utiliser avec des formes géométriques. Cet attribut utilise une liste de nombres séparés par des virgules, définissant les coordonnées de l'objet sur la page.
-
{{htmlattrdef("name")}} {{HTMLVersionInline(4)}} seulement, {{Obsolete_Inline("HTML5")}}
-
Cet attribut est utilisĂ© pour dĂ©finir une ancre cible au sein de la page. La valeur de name est similaire Ă  la valeur de l'attribut global id, et doit ĂȘtre un identifiant alphanumĂ©rique unique au document. Sous la spĂ©cification HTML 4.01, id et name peuvent ĂȘtre tous les deux utilisĂ©s sur un Ă©lĂ©ment <a> s'ils ont des valeurs identiques. -
-

Note d'utilisation : Cet attribut est obsolĂšte en HTML5, il faut utiliser l'attribut global id Ă  la place.

-
-
-
{{htmlattrdef("rev")}} {{HTMLVersionInline(4)}} seulement, {{Obsolete_Inline("HTML5")}}
-
L'attribut indique un lien inversé : la relation inverse de l'attribut rel. Il est utile pour indiquer l'origine d'un objet, tel que l'auteur d'un document. -
-

Note : La spécification actuelle de HTML 5.2 du W3C n'indique plus l'attribut rev comme obsolÚte. En revanche, la spécification du WHATWG le considÚre toujours comme obsolÚte. Tant que cette incohérence n'est pas résolue, mieux vaut considérer cet attribut comme obsolÚte.

-
-
-
{{htmlattrdef("shape")}} {{HTMLVersionInline(4)}} seulement, {{Obsolete_Inline("HTML5")}}
-
Cet attribut est utilisĂ© pour dĂ©finir une zone cliquable pour un lien associĂ© Ă  une image, pour crĂ©er une image map. Les valeurs pour cet attribut sont circle, default, polygon, et rect. Le format de l'attribut coords dĂ©pend de la valeur de shape. Pour circle, la valeur est x,y,r oĂč x et y sont les coordonnĂ©es en pixel pour le centre du cercle et r est le rayon du cercle en pixel. Pour rect, l'attribut coords doit ĂȘtre x,y,w,h. Les valeurs x,y dĂ©finissent le coin supĂ©rieur gauche du rectangle, pendant w et h dĂ©finissent respectivement la largeur et la hauteur. Une valeur polygon pour shape nĂ©cessite les valeurs x1,y1,x2,y2,... pour coords. Chaque paire de x,y dĂ©finissent un point du polygone, avec les points successifs joints par des lignes droites, et le dernier point joint au premier. La valeur default pour shape nĂ©cessite que la totalitĂ© de la zone, habituellement une image, soit utilisĂ©e. -
Note : Il est préférable d'utiliser l'attribut {{htmlattrxref("usemap","img")}} de l'élément {{HTMLElement("img")}} et l'élément {{HTMLElement("map")}} associé, pour définir des zones d'actions, à la place de l'attribut shape.
-
+
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.

+
+
-

Exemples

+

Propriétés

-

Hyperlien vers une ressource externe

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Catégories de contenuContenu du flux, contenu phrasé, contenu interactif, contenu palpable.
Contenu autoriséTransparent, contenant soit le contenu du flux (à l'exclusion du contenu interactif), soit contenu phrasé.
Omission de balisesAucune, la balise d'ouverture et la balise de fermeture sont obligatoires.
Parents autorisésTout élément qui accepte la formulation du contenu, ou tout élément qui accepte le contenu du flux, mais pas les autres éléments <a>.
RÎle ARIA implicitelien lorsque l'attribut href est présent, sinon pas de rÎle correspondant.
RÎles ARIA autorisés +

Lorsque l'attribut href est présent :

+ +

Lorsque l'attribut href n'est pas présent :

+
    +
  • tout
    • +
+
Interface DOMHTMLAnchorElement
-
<a href="https://www.mozilla.com/">
-Lien externe
-</a>
+

Exemples

-

RĂ©sultat

+

Créer un lien vers une URL absolue

-

{{EmbedLiveSample("Hyperlien_vers_une_ressource_externe")}}

+

HTML

-

Créer une image cliquable

+
<a href="https://www.mozilla.com">
+  Mozilla
+</a>
-

Ce petit exemple utilise une image qui redirige vers la page d'accueil de MDN. La page d'accueil s'ouvrira dans un nouveau contexte de navigation, c'est une nouvelle page ou un nouvel onglet.

+

RĂ©sultat

-
-

Dans le cas d'une image cliquable, le texte alternatif doit contenir l'objet du lien, tel qu'indiqué dans l'exemple 9 des WCAG 1.1.1 relatives aux alternatives textuelles.

-
+

{{EmbedLiveSample("linking_to_an_absolute_url", "100%", 50)}}

-
<a href="https://developer.mozilla.org/fr/" target="_blank">
- <img src="https://mdn.mozillademos.org/files/6851/mdn_logo.png" alt="Documentation du web - MDN" />
-</a>
+

Créer des liens vers des URL relatives

-

RĂ©sultat

+

HTML

-

{{EmbedLiveSample("Exemple_Cr%C3%A9er_une_image_cliquable", "320", "64")}}

+
<a href="//example.com">URL relative au schéma</a>
+<a href="/fr/docs/Web/HTML">URL relative Ă  l'origine</a>
+<a href="./p">URL relative au répertoire</a>
-

Créer un lien vers un numéro de téléphone

+ -
<a href="tel:+615701564">+6 15 70 15 64</a>
-
+

RĂ©sultat

-

Pour plus de détails sur ce schéma, se référer à la RFC {{RFC(3966)}}.

+

{{EmbedLiveSample("linking_to_relative_urls", "100%", 120)}}

-

Créer un lien pour écrire un e-mail

+

CrĂ©er un lien vers un Ă©lĂ©ment de la mĂȘme page

-

Il est courant de créer des boutons ou des hyperliens qui vont ouvrir l'application de messagerie de l'utilisateur pour lui permettre d'envoyer un nouveau message. Cela est possible en utilisant un lien mailto. Voici un exemple simple:

+
<!-- <a> élément liens vers la section ci-dessous -->
+<p><a href="#section_further_down">
+  Passez Ă  la rubrique ci-dessous
+</a></p>
 
-
<a href="mailto:personne@mozilla.org">Envoyer un courriel Ă  personne</a>

+<!-- Rubrique Ă  relier -->
+<h2 id="section_further_down">Section plus bas</h2>
+ +
+

Note :

+

Vous pouvez utiliser href="#top" ou le fragment vide (href="#") pour créer un lien vers le haut de la page actuelle, comme défini dans la spécification HTML.

+
-

Cela produit comme résultat, un lien qui ressemble à ceci: Envoyer un courriel à personne.
- Pour plus de détails sur le schéma URL de mailto, comme comment inclure un sujet, un corps de texte, ou tout autre contenu prédéterminé, voir les liens Emails ou {{RFC(6068)}}.

+

Créer un lien avec une adresse électronique

-

Utiliser l'attribut download pour sauvegarder un canvas en PNG

+

Pour créer des liens qui s'ouvrent dans le programme de messagerie de l'utilisateur, pour lui permettre d'envoyer un nouveau message, utilisez le schéma mailto: :

-

Si on souhaite permettre à un utilisateur de télécharger un canvas HTML comme une image, on peut créer un lien avec un attribut download et lui associer les données liées au {{HTMLElement('canvas')}} pour construire une URL de fichier.

+
<a href="mailto:nowhere@mozilla.org">Envoyer un courriel nulle part</a>
-
var link = document.createElement('a');
-link.textContent = 'Télécharger une image';
-link.addEventListener('click', function(ev) {
-    link.href = canvas.toDataURL();
-    link.download = "maToile.png";
-}, false);
-document.body.appendChild(link);
+

Pour plus de détails sur les URL mailto:, comme l'inclusion d'un sujet ou d'un corps de message, voir Liens de courrier électronique ou RFC 6068.

-

Vous pouvez voir le résultat de ce code ici https://jsfiddle.net/codepo8/V6ufG/2/

+

Créer un lien avec les numéros de téléphone

-

Notes

+
<a href="tel:+49.157.0156">+49 157 0156</a>
+<a href="tel:+1(555)5309">(555) 5309</a>
+ +

tel: le comportement du lien varie en fonction des capacités du périphérique :

-

Sécurité et vie privée

+

Voir RFC 3966 pour la syntaxe, les fonctionnalités supplémentaires et d'autres détails sur le schéma URL tel:.

+ +

Utilisation de l'attribut de téléchargement pour enregistrer un <canvas> au format PNG.

+ +

Pour enregistrer le contenu d'un élément <canvas> sous forme d'image, vous pouvez créer un lien avec un attribut download et les données du canvas sous forme d'une URL data: :

+ + + +
HTML
+ +
<p>
+  Peignez en maintenant le bouton de la souris enfoncé et en le déplaçant.
+  <a href="" download="my_painting.png">Télécharger ma peinture</a>
+</p>
+
+<canvas width="300" height="300"></canvas>
+ +
CSS
+ +
html {
+  font-family: sans-serif;
+}
+canvas {
+  background: #fff;
+  border: 1px dashed;
+}
+a {
+  display: inline-block;
+  background: #69c;
+  color: #fff;
+  padding: 5px 10px;
+}
+ +
JavaScript
+ +
var canvas = document.querySelector('canvas'),
+    c = canvas.getContext('2d');
+c.fillStyle = 'hotpink';
+
+function draw(x, y) {
+  if (isDrawing) {
+    c.beginPath();
+    c.arc(x, y, 10, 0, Math.PI*2);
+    c.closePath();
+    c.fill();
+  }
+}
+
+canvas.addEventListener('mousemove', event =>
+  draw(event.offsetX, event.offsetY)
+);
+canvas.addEventListener('mousedown', () => isDrawing = true);
+canvas.addEventListener('mouseup', () => isDrawing = false);
+
+document.querySelector('a').addEventListener('click', event =>
+  event.target.href = canvas.toDataURL()
+);
+ +
RĂ©sultat
+ +

{{EmbedLiveSample('example_painting_app_with_save_link', '100%', '420')}}

+ +

Sécurité et vie privée

-

Bien que l'Ă©lĂ©ment <a> soit la plupart du temps utilisĂ© innocemment, les informations qu'il peut transporter peuvent avoir des effets indĂ©sirables sur la sĂ©curitĂ© et sur la vie privĂ©e des utilisateurs. Pour plus d'informations, voir cet article sur l'en-tĂȘte Referer et les problĂ©matiques qu'il soulĂšve.

+

Les éléments <a> peuvent avoir des conséquences sur la sécurité et la vie privée des utilisateurs. Voir Referer header : privacy and security concerns pour plus d'informations.

-

L'utilisation de target="_blank" sans rel="noreferrer" et sans rel="noopener" peut rendre un site vulnérable à certaines formes d'attaques utilisant l'API window.opener (voir ce billet).

+

L'utilisation de target="_blank" sans rel="noreferrer" et rel="noopener" rend le site web vulnĂ©rable aux attaques d'exploitation de l'API window.opener (description de la vulnĂ©rabilitĂ©), bien qu'il faille noter que, dans les versions plus rĂ©centes du navigateur, la dĂ©finition de target="_blank" fournit implicitement la mĂȘme protection que la dĂ©finition de rel="noopener". Voir la compatibilitĂ© des navigateurs pour plus de dĂ©tails.

Accessibilité

-

Évùnements onclick

+

Texte de lien fort

+ +

Le contenu d'un lien doit indiquer oĂč va le lien, mĂȘme hors contexte.

+ +

Texte inaccessible, lien faible

+ +

Une erreur tristement courante consiste à ne relier que les mots « cliquez ici » ou « ici » :

+ +
<p>
+  En savoir plus sur nos produits <a href="/products">ici</a>.
+</p>
+
+ +

Texte de lien fort

+ +

Heureusement, il s'agit d'une solution facile, et elle est en fait plus courte que la version inaccessible !

+ +
<p>
+  En savoir plus <a href="/products">Ă  propos de nos produits</a>.
+</p>
+ +

Les logiciels d'assistance disposent de raccourcis permettant de lister tous les liens d'une page. Cependant, un texte de lien fort profite Ă  tous les utilisateurs − le raccourci « liste de tous les liens » imite la façon dont les utilisateurs voyants parcourent rapidement les pages.

+ +

Évùnements onclick

Les ancres sont souvent dĂ©tournĂ©es avec l'Ă©vĂšnement onclick afin de crĂ©er des pseudo-boutons avec l'attribut href qui vaut "#" ou "javascript:void(0)" pour empĂȘcher le rafraĂźchissement de la page.

Ces valeurs produisent des rĂ©sultats inadĂ©quats lorsqu'on copie/dĂ©place des liens, qu'on ouvre des liens dans de nouveaux onglets ou fenĂȘtres, qu'on ajoute des marque-pages ou lorsque le JavaScript est encore en train d'ĂȘtre tĂ©lĂ©chargĂ©. De plus, la sĂ©mantique exposĂ©e par le document, utilisĂ©e par les outils d'assistance, est incorrecte.

-

Dans ces cas, on privilĂ©giera plutĂŽt l'utilisation d'un bouton {{HTMLElement("button")}}. De façon gĂ©nĂ©rale, une ancre ne doit ĂȘtre utilisĂ©e que pour naviguer vers une URL correcte.

+

Dans ces cas, on privilĂ©giera plutĂŽt l'utilisation d'un bouton <button>. De façon gĂ©nĂ©rale, une ancre ne doit ĂȘtre utilisĂ©e que pour naviguer vers une URL correcte.

-

Liens externes, liens vers des ressources non-HTML

+ -

Les liens qui ouvrent un nouvel onglet ou une nouvelle fenĂȘtre grĂące Ă  target="_blank", ainsi que le liens qui ouvrent des fichiers devraient fournir une indication sur ce qui se produira lorsqu'on cliquera sur ces liens.

+

Les liens qui ouvrent un nouvel onglet ou une nouvelle fenĂȘtre grĂące Ă  target="_blank", ainsi que les liens qui ouvrent des fichiers devraient fournir une indication sur ce qui se produira lorsqu'on cliquera sur ces liens.

Les personnes qui utilisent des outils d'assistance Ă  la navigation comme des lecteurs d'Ă©cran et/ou qui souffrent de troubles de la vision, cognitifs peuvent ĂȘtre confuses lorsqu'un nouvel onglet, fichier ou une nouvelle fenĂȘtre s'ouvre de façon inattendue. Les anciennes versions des lecteurs d'Ă©cran peuvent Ă©galement ne pas annoncer ce comportement.

-

Lien vers un nouvel onglet ou une nouvelle fenĂȘtre

+ -
<a target="_blank" href="https://www.wikipedia.org/">WikipĂ©dia (s'ouvre dans une nouvelle fenĂȘtre)</a>
-
+
<a target="_blank" href="https://www.wikipedia.org/">
+  WikipĂ©dia (s'ouvre dans une nouvelle fenĂȘtre)
+</a>
-

Lien vers une ressource non-HTML

+ -
<a target="_blank" href="2017-rapport-annuel.ppt">Rapport annuel 2017 (PowerPoint)</a>
-
+
<a target="_blank" href="2017-rapport-annuel.ppt">
+  Rapport annuel 2017 (PowerPoint)
+</a>

Si une icÎne est utilisée en lieu et place du texte pour indiquer ce comportement, on s'assurera qu'elle contient bien une description alternative.

+
<a  target="_blank" href="https://www.wikipedia.org">
+  Wikipédia
+  <img alt="(s'ouvre dans un nouvel onglet)" src="newtab.svg">
+</a>
+
+<a href="2017-annual-report.ppt">
+  Rapport annuel 2017 (PowerPoint)
+  <img alt="(fichier PowerPoint)" src="ppt-icon.svg">
+</a>
+ -

Skip links - liens pour l'accĂšs rapide au contenu

+ + +

Un skip link (aussi appelé skipnav en anglais) est un élément a qui est placé le plus prÚs possible de l'élément <body> et qui renvoie au début du contenu principal de la page.

-

Un skip link (aussi appelé skipnav en anglais) est un élément a qui est placé le plus prÚs possible de l'élément {{HTMLElement("body")}} et qui renvoie au début du contenu principal de la page.

+
<body>
+  <a href="#content">Skip to main content</a>
+
+  <header>
+    

+  </header>
+
+  <main id="content"> <!-- Le lien "skip" renvoie vers ici -->

Ce lien permet alors de passer plus facilement le contenu qui se rĂ©pĂšte sur l'ensemble des pages (l'en-tĂȘte et la barre de navigation par exemple).

-

Les skip links sont particuliÚrement utiles pour les personnes qui naviguent à l'aide d'outils d'assistance (commande vocale, stylets buccal ou frontal) pour lesquels devoir passer par des liens répétés peut freiner la lecture du document.

+

Les skip links sont particuliÚrement utiles pour les personnes qui naviguent à l'aide d'outils d'assistance (commande vocale, stylets buccal ou frontal) pour lesquels devoir passer par des liens répétés peut freiner la lecture du document.

-

Dimensionnement et proximité

+

Dimensionnement et proximité

-

Dimensionnement - taille

+

La taille

Les éléments interactifs tels que les liens doivent fournir une surface suffisamment grande pour qu'il soit facile de les activer. Cela facilitera la tùche à une variété de personnes : celles qui ont des problÚmes moteur, celles qui utilisent des dispositifs de pointage peu précis (doigt ou stylet). La taille interactive minimale recommandée est de 44x44 pixels CSS.

+

Les liens en texte seul dans le contenu en prose sont exemptĂ©s de cette exigence, mais il est toujours bon de s'assurer qu'il y a suffisamment de texte hyperliĂ© pour ĂȘtre facilement activĂ©.

+ -

Proximité

+

La proximité

Lorsque plusieurs contenus interactifs (y compris les ancres) sont placés les uns à cÎté des autres, il est nécessaire de les espacer suffisamment pour minimiser le risque d'activer le mauvais contenu lors de la navigation.

-

Un tel espacement peut ĂȘtre obtenu grĂące Ă  la propriĂ©tĂ© CSS {{cssxref("margin")}}.

+

Un tel espacement peut ĂȘtre obtenu grĂące Ă  la propriĂ©tĂ© CSS margin.

-

Résumé technique

- - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Catégories de contenuContenu de flux, contenu phrasé, contenu interactif, contenu tangible.
Contenu autoriséContenu transparent qui contient du contenu de flux (mais pas de contenu interactif) ou du contenu phrasé.
Omission de balises{{no_tag_omission}}
Parents autorisésTout élément qui accepte du contenu phrasé ou tout élément qui accepte du contenu de flux. (un élément <a> ne peut pas avoir d'élément parent qui soit également un élément <a>).
RÎles ARIA autorisés{{ARIARole("button")}}, {{ARIARole("checkbox")}}, {{ARIARole("menuitem")}}, {{ARIARole("menuitemcheckbox")}}, {{ARIARole("menuitemradio")}}, {{ARIARole("option")}}, {{ARIARole("radio")}}, {{ARIARole("switch")}}, {{ARIARole("tab")}}, {{ARIARole("treeitem")}}
Interface DOM{{domxref("HTMLAnchorElement")}}
- -

Spécifications

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
SpĂ©cificationÉtatCommentaires
{{SpecName('Referrer Policy', '#referrer-policy-delivery-referrer-attribute', 'referrer attribute')}}{{Spec2('Referrer Policy')}}Ajout de l'attribut referrer.
{{SpecName('HTML WHATWG', 'text-level-semantics.html#the-a-element', '<a>')}}{{Spec2('HTML WHATWG')}}
{{SpecName('HTML5 W3C', 'text-level-semantics.html#the-a-element', '<a>')}}{{Spec2('HTML5 W3C')}}
{{SpecName('HTML4.01', 'struct/links.html#h-12.2', '<a>')}}{{Spec2('HTML4.01')}}
- -
-

Note : HTML 3.2. définit uniquement les attributs name, href, rel, rev et title.

-
+

Spécifications

-

Compatibilité des navigateurs

+

{{Specifications}}

- +

Compatibilité des navigateurs

-

{{Compat("html.elements.a")}}

+

{{Compat}}

-

Voir aussi

+

Voir aussi

-- cgit v1.2.3-54-g00ecf