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 elle pointe doit être téléchargée par le navigateur au lieu d'y accéder.

Dans Télécharger des ressources:

Remarque : L'attribut download, s'il est présent, indique que l'auteur prévoit que le lien hypertexte sera utilisé pour télécharger une ressource. L'attribut peut avoir une valeur. Le cas échéant, elle spécifie le nom de fichier par défaut que l'auteur recommande pour l'étiquetage de la ressource dans un système de fichiers local. Il n'existe aucune restriction concernant les valeurs autorisées, mais les auteurs s'assurent que la plupart des systèmes de fichiers ont des limites quant à la ponctuation acceptée dans les noms de fichiers. Les user-agents sont susceptibles d'ajuster les noms de fichiers en conséquence. Vous pouvez également attribuer une valeur à l'attribut pour spécifier le nom de fichier que les user-agents doivent utiliser lorsqu'ils stockent 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: télécharger-moi. 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 l'utilisation d'URL blob: URL et filesystem: URL. Elle offre aux utilisateurs un moyen de télécharger le contenu créé/modifié dans votre application.

Démo complète

Il convient de noter que dans l'exemple ci-dessus, l'image a la même origine par rapport au site Web. Si vous essayez d'utiliser un lien vers une image d'une autre origine, il est possible qu'il ne fonctionne pas comme un lien de navigation plutôt qu'un lien de téléchargement. En effet, de nombreuses versions du navigateur ne sont pas compatibles avec les règles de téléchargement pour les fichiers multi-origines. Par exemple, les versions antérieures à la version 65 de Chrome permettait de télécharger des fichiers multi-origines, qui ont été abandonnées 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 depuis une autre origine.

Navigateurs compatibles: seule la version de développement actuelle de Chrome (14.0.835.15 et versions ultérieures) est compatible avec cet attribut.