Cette page a été traduite par l'API Cloud Translation.

Téléchargement de ressources au format HTML5 - a[télécharger]

Eric Bidelman

Chrome est désormais compatible avec le nouvel attribut download de la spécification HTML pour les éléments a. Lorsqu'il est utilisé, cet attribut signifie que la ressource vers laquelle il pointe doit être téléchargée par le navigateur au lieu d'y accéder.

Sur la page Télécharger des ressources:

Remarque : S'il est présent, l'attribut download indique que l'auteur souhaite que le lien hypertexte soit utilisé pour télécharger une ressource. L'attribut peut avoir une valeur. La valeur, le cas échéant, indique le nom de fichier par défaut que l'auteur recommande d'utiliser pour étiqueter la ressource dans un système de fichiers local. Il n'existe aucune restriction concernant les valeurs autorisées, mais les auteurs retiennent que la plupart des systèmes de fichiers sont limités en ce qui concerne la ponctuation dans les noms de fichier et les user-agents sont susceptibles de modifier les noms de fichiers en conséquence. De plus, une valeur peut être attribuée à l'attribut pour spécifier le nom de fichier que les user-agents doivent utiliser lors du stockage de la ressource dans un système de fichiers. Cette valeur peut être remplacée par le paramètre filename de l'en-tête HTTP Content-Disposition.

Par exemple, si vous cliquez sur le lien suivant, le fichier .png est téléchargé sous le nom "MonLogoGoogle.png". au lieu d'accéder à sa valeur href: download me. Le balisage est le suivant:

<a href="http://web-central.appspot.com/.../web-fundamentals-icon192x192.png" download="WebfundamentalsLogo">download me</a>

Le véritable avantage de a[download] réside dans les URL blob: URL et filesystem: URL. Il permet aux utilisateurs de télécharger du contenu créé ou modifié dans votre application.

Démo complète

Notez que dans l'exemple ci-dessus, l'origine de l'image est identique par rapport au site Web. Si vous essayez d'utiliser un lien d'image d'une autre origine, il se peut qu'il ne fonctionne pas comme lien de navigation plutôt que comme lien de téléchargement. En effet, de nombreuses versions du navigateur ne sont pas compatibles avec la règle de téléchargement sur les fichiers multi-origines. Par exemple, les versions de Chrome antérieures à la version 65 permettaient de télécharger des fichiers multi-origines, et cette fonctionnalité a été abandonnée dans les versions ultérieures. Pour en savoir plus, consultez cet article. Vous pouvez utiliser l'en-tête Content-Disposition pour forcer un téléchargement à partir d'une autre origine.

Navigateurs compatibles: seule la version actuelle de la version en développement de Chrome (14.0.835.15 ou version ultérieure) est compatible avec cet attribut.