Base64画像が役立つ場面
ふつうのウェブページは、別の画像ファイルにリンクして画像を表示します。Base64のデータURIは、画像をテキストの中に入れてしまう方法で、次のような場面で便利です。
- HTMLやCSSに入れる小さなアイコンやロゴ: 小さな矢印、読み込み中のスピナー、2 KBのロゴなどなら、ブラウザのリクエストを1回減らせます。
- 1ファイルで完結する文書: 画像フォルダーなしで、1つのファイルとして動く必要があるHTMLのレポート、オフライン用のページ、メールのテンプレートなど。
- APIやJSON: プロフィール画像のアップロード、スキャンした書類の送信、画像認識APIの呼び出しなど、多くのサービスでは画像をBase64の項目として送るよう求められます。
- メールの署名やメールマガジン: エディターによっては、画像をデータURIでしか受け付けないものがあります。ただし、OutlookやGmailなど一部のメールアプリは埋め込まれたデータURIをブロックしたり削除したりするため、全員に送る前にテストしてください。
- CSS内のファビコンやSVG: 小さなICOやSVGは、スタイルシートに直接書き込めます。
出力形式の選び方
| 形式 | 見た目 | 使いどころ |
|---|---|---|
| データURI | data:image/png;base64,iVBOR… | imgのsrc、CSSのurl()、Markdown、ほとんどのJSONの項目 |
| Base64コードのみ | iVBORw0KGgo… | 接頭辞のないコードを求め、種類を別に送るAPIの項目 |
| HTMLのimgタグ | データURIをsrcに入れたimg要素 | HTMLページやメールのテンプレートにそのまま貼り付けるとき |
| CSSのbackground-imageルール | url("data:…")を使ったbackground-image | スタイルシート、インラインのstyle属性 |
迷ったらデータURIを選んでください。いちばん多くの場面で使えます。すぐに使えるコード例とサイズの目安は、Base64で画像をHTMLやCSSに埋め込む方法で紹介しています。Base64コードから画像に戻したいときは、Base64を画像に変換を使ってください。
小さな画像で使う
Base64が向いているのは小さな画像です。おおよその目安は次のとおりです。
- 10 KB未満(アイコン、シンプルなロゴ):埋め込むのがおすすめです。
- 10~100 KB:1ファイルで完結する文書やメールなら問題ありませんが、頻繁に読み込まれるウェブページにはあまり向きません。
- 100 KB超:ふつうの画像ファイルにしたほうがよいことがほとんどです。テキストは画像より3分の1大きくなり、個別にキャッシュできず、ページのほかの部分の表示も遅くなります。
変換する前に画像を小さくするなら、PNG圧縮やJPG圧縮を使うか、画像サイズ変更でピクセル数を減らしてください。アイコンやロゴなら、SVGがいちばん小さくなることもよくあります。
うまくいかないときは
「この画像を開けませんでした」と表示される: 対応している画像形式ではないか、ファイルが壊れています。iPhoneのHEIC写真は、ほとんどのブラウザでデータURIとして表示できません。先にJPGに変換してください。
「この画像は10 MBを超えています。」と表示される: それほど長いテキストは、どのエディターやフォームにも貼り付けて使うのに向きません。先に画像を圧縮するか、サイズを小さくしてください。
貼り付けた場所に画像が表示されない: テキストをすべてコピーできているか確認してください(長い結果は途中で切れやすいので、.txtファイルをダウンロードすると確実です)。また、貼り付け先がデータURIに対応しているかも確認してください。メールアプリやコンテンツフィルターの中には、意図的にデータURIを削除するものがあります。