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 indique que la ressource qu'il pointe doit être téléchargée par le navigateur plutôt que d'y accéder.

Dans Téléchargement des ressources:

Remarque : Si l'attribut download est présent, il indique que l'auteur prévoit d'utiliser l'hyperlien pour télécharger une ressource. L'attribut peut avoir une valeur. Si tel est le cas, elle spécifie le nom de fichier par défaut que l'auteur recommande d'utiliser pour étiqueter la ressource dans un système de fichiers local. Aucune restriction n'est appliquée aux valeurs autorisées, mais les auteurs doivent savoir que la plupart des systèmes de fichiers sont limités en ce qui concerne les signes de ponctuation acceptés dans les noms de fichiers, et que les agents utilisateur 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 agents utilisateur 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 "MyGoogleLogo.png" au lieu d'accéder à sa valeur href: download me (Téléchargez-moi). Le balisage est le suivant:

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

L'intérêt réel de a[download] réside dans l'utilisation des URL blob: et filesystem:. Il permet aux utilisateurs de télécharger le contenu créé/modifié dans votre application.

Démo complète

Notez 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, mais comme un lien de téléchargement. En effet, de nombreuses versions de navigateurs ne sont pas compatibles avec la règle de téléchargement des fichiers inter-origines. Par exemple, les versions antérieures à la version 65 de Chrome permettaient de télécharger des fichiers inter-origines, mais cette fonctionnalité a été abandonnée dans les versions ultérieures. Pour en savoir plus, consultez cette page. Vous pouvez utiliser l'en-tête Content-Disposition pour forcer un téléchargement à partir d'une autre origine.

Compatibilité avec les navigateurs: seul le canal de développement actuel de Chrome (14.0.835.15 ou version ultérieure) est compatible avec cet attribut.