HTML Web制作

【HTML】ファイルをダウンロードさせるaタグのdownload属性の使い方

2024年3月4日

※ 当サイトではアフィリエイト広告を利用しています

コーディングでファイルをダウンロードさせるにはどうしたらいいの?

会社のホームページなどで、資料などをダウンロードできるようにしたい場合があると思います。

今回は、HTMLのaタグで簡単にファイルをダウンロードさせることができる、download属性の使い方を解説します。

じゅんぺいブログは、Web制作コーディングWordPress制作)の技術記事を中心に、約500記事公開しています。ぜひ他の記事も参考にしてみてください!
完全無料のプログラミングスクール『ZeroPlus Gate』
30日間でWeb制作を学べる無料のプログラミングスクールがこちら
いきなり数十万するプログラミングスクールは厳しい・・・という人のお試しに最適です。
現在は無料ですがいつ有料になるか分からないので、気になる方はお早めに👇
(有料になっていたらすいません🙇‍♂️)

\ 完全無料 /

ZeroPlus Gate公式サイト

毎日先着制!

ファイルをダウンロードさせるaタグのdownload属性の使い方

早速ですが、コードはこちらになります。

<a href="ファイルのパス" download="ファイル名">ダウンロードする</a>

 

href属性

href属性のファイルのパスは、絶対パスでも相対パスでもOKです。

<!-- 絶対パス -->
<a href="https://junpei-sugiyama.com/wp-content/uploads/sample.pdf" download="ファイル名">ダウンロードする</a>
<!-- 相対パス -->
<a href="../file/sample.pdf" download="ファイル名">ダウンロードする</a>

 

download属性

download属性には、ファイル名を入れます。

これは、実際のファイル名ではなく、ダウンロードされた時のファイル名になります。

そして、空欄であれば実際のファイル名でダウンロードされます。

<!-- ダウンロードされるファイル名は『sample.pdf』 -->
<a href="../file/sample.pdf" download="sample.pdf">ダウンロードする</a>
<!-- ダウンロードされるファイル名は『サンプル.pdf』 -->
<a href="../file/sample.pdf" download="サンプル.pdf">ダウンロードする</a>
<!-- ダウンロードされるファイル名は『sample.pdf』 -->
<a href="../file/sample.pdf" download="">ダウンロードする</a>
<a href="../file/sample.pdf" download>ダウンロードする</a>

拡張子は実際と違うもの書くとそれになってしまうので、ご注意下さい(拡張子は書かなくてもOK)

 

download属性が効かない原因

もしダウンロードができない場合は、以下の原因が考えられます。

  • ファイルのパスが間違えている
  • ファイルが消えている
  • 同一オリジンではない

3つ目の『同一オリジンではない』ですが、これはWebサイトとファイルの場所が同じサーバーの同じドメインの必要があるということです。

つまり、他人のサイトのファイルをダウンロードできるようにはできないということですね。

まとめ

今回は、aタグのdownload属性の使い方を解説しました。

ファイルのダウンロードはWeb制作でもたまにある実装なので、覚えておきましょう。

以上になります。

この記事が役に立ったと思ったら、シェアボタンからX(旧Twitter)などにシェアすると、いいねされてフォロワーが増えたりすることがあるよ!

 

  • この記事を書いた人

じゅんぺい

37歳からWeb制作とブログ開始。Web制作歴5年目でコーディングとWordPressオリジナルテーマ制作が中心。これまで120件以上を納品。当ブログ月間最高15万PVで、370記事以上はWeb制作の技術記事。コンテンツ販売→累計売上1200万円&1500部超え。X(旧Twitter)フォロワー7200人以上。2024年3月からブログの経験を活かしてライターとしても活動を開始。

-HTML, Web制作