マスター Base64 フロントエンド開発用
理解するための包括的なガイド Base64 エンコード、デコード、および最新の Web デザインにおける実用的なアプリケーション。
試す Base64 エンコード/デコード
正確には何ですか Base64?
Base64 は、バイナリ データ (画像、ファイル、生のバイトなど) を ASCII 文字に変換する、バイナリからテキストへのエンコード スキームです。この変換により、バイナリ データを安全に送信し、電子メール プロトコル、HTML、API 応答などのテキストのみのデータ用に設計されたシステムに保存できるようになります。
「Base64」という名前は、バイナリ値を表すために 64 個の異なる文字 (A ~ Z、a ~ z、0 ~ 9、「+」、および「/」) を使用することに由来しています。それぞれ Base64 文字は 6 ビットのデータをエンコードするため、テキスト中心の環境でバイナリ コンテンツを処理する効率的な方法になります。
暗号化とは異なり、 Base64 これはセキュリティ対策ではなく、純粋にデータのフォーマットを目的としています。基本的なツールを使用すれば誰でも Base64 コンテンツをデコードできるため、機密情報の保護には決して使用しないでください。
Base64 文字セット
※「=」は不完全なデータの埋め込み文字として使用されます。
どうやって Base64 エンコード作業?
- 1
バイナリデータを8ビットバイトに変換
このプロセスはバイナリ データ (画像ファイルなど) から始まります。このデータは 8 ビット (1 バイト) セグメントに分割され、生の入力を形成します。 Base64 エンコーディング。
- 2
バイトを 24 ビットのチャンクにグループ化する
以来 Base64 6 ビット文字を使用する場合、8 ビット バイトは 24 ビット (3 バイト) のチャンクにグループ化されます。 24 ビットは 4 つの 6 ビット セグメント (4 × 6 = 24) に均等に分割できます。
- 3
6 ビットセグメントを Base64 文字に変換する
各 6 ビット セグメントは 10 進数値 (0 ~ 63) に変換されます。この値は、次に、 Base64 文字セット (例: 0 = 「A」、1 = 「B」、…、63 = 「/」)。
- 4
不完全なチャンクにパディングを追加する
バイナリ データ長が 3 バイトの倍数でない場合、最終チャンクは不完全になります。 Base64 「=」パディング文字を使用して欠落バイトを示します(1 つの欠落バイトには 1 つの「=」、2 つの欠落バイトには 2 つの「=」)。
Base64 エンコーディングの例: テキスト「Hi!」
| ステップ | 入力データ | バイナリ表現 | Base64出力 |
|---|---|---|---|
| 1. 生のテキスト | "こんにちは!" | – | – |
| 2. 8ビットバイト(ASCII) | ひ(72)、い(105)、! (33) | 01001000、01101001、00100001 | – |
| 3. 24ビットチャンク | 72、105、33 | 010010000110100100100001 | – |
| 4. 6 ビットのセグメントに分割 | – | 010010、000110、100100、100001 | – |
| 5. 10 進数に変換する | – | – | 18、6、36、33 |
| 6. Base64 文字へのマッピング | – | – | "肌" |
フロントエンド Base64 使用例
画像のデータ URL
小さな画像 (アイコンやアバターなど) を HTML/CSS に直接埋め込みます。 Base64 データの URL。これにより、HTTP リクエストが減少し、小さなアセットのページ読み込み速度が向上します。
<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." alt="Icon">
APIバイナリデータ送信
バイナリ データ (ファイルや PDF など) を次のようにエンコードして REST API 経由で送信します。 Base64。これにより、テキストベースの API ペイロード (JSON など) におけるバイナリ データの破損の問題が回避されます。
{ "fileData": "JVBERi0xLjQKJeLjz9MNCjYgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlciAvRmxhdGVEZWNvZGU+PgpzdHJlYW0KeAovRjEgMTAgVGYKMDAwLjEwNS4wMDAuMTAwCjAwMC4yOTkuMDAwLjAwMAo...", "fileName": "report.pdf" }
Cookie と LocalStorage のテキストの制約
小さなバイナリ データを Cookie または LocalStorage (テキストのみをサポート) にエンコードして保存します。 Base64。ユーザー設定や小さな資産をローカルに保存するのに役立ちます。
// Save Base64 data to LocalStorage
localStorage.setItem('userAvatar', 'data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEA...');
電子メール添付ファイルのエンコーディング
ほとんどの電子メール プロトコル (SMTP など) はテキストのみです。 Base64 電子メールの添付ファイル (画像、ドキュメント) をエンコードして、破損することなく送信できるようにするために使用されます。
Content-Type: image/jpeg; name="photo.jpg"
Content-Transfer-Encoding: base64
Content-Disposition: attachment; filename="photo.jpg"
/9j/4AAQSkZJRgABAQEAZABkAAD/7QBsUGhvdG9zaG9wIDMuMAA4QklNA+0AAAAAABAASAAAAAEA...
インラインSVGエンコーディング
SVG ファイルをエンコードして、 Base64 CSS 背景または HTML 属性でインラインで使用する場合。これにより、小さなベクター グラフィックスの資産管理が簡素化されます。
.icon {
background-image: url('data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZD0iTTEyIDJBMTAgMTAgMCAwIDEgMjIgMTJBMTAgMTAgMCAwIDEgMTIgMjJBMTAgMTAgMCAwIDEgMiAxMkExMCAxMCAwIDAgMSAxMiAyWiIgc3Ryb2tlPSIjMTY1REZGIiBzdHJva2Utd2lkdGg9IjIiLz48L3N2Zz4=');
}
キャンバス画像のエクスポート
HTML5 Canvas API は以下を使用します。 Base64 描画内容を画像データとしてエクスポートします( toDataURL())。これにより、ユーザーが作成したアートワークやスクリーンショットを保存できるようになります。
// Get Base64 data from Canvas
const canvas = document.getElementById('myCanvas');
const base64Image = canvas.toDataURL('image/png'); // "data:image/png;base64,iVBORw0KGgo..."
フロントエンド Base64 コード例
基本 Base64 エンコード/デコード
JavaScript の組み込みを使用する btoa() (バイナリから ASCII) および atob() 単純な (ASCII からバイナリへの) 関数 Base64 操作。注: これらの関数は UTF-8 文字列で動作します。
// Encode text to Base64
function encodeToBase64(text) {
// Encode UTF-8 to avoid issues with special characters
const utf8Text = unescape(encodeURIComponent(text));
return btoa(utf8Text);
}
// Decode Base64 to text
function decodeFromBase64(base64String) {
const utf8Text = atob(base64String);
return decodeURIComponent(escape(utf8Text));
}
// Example usage
const originalText = "Hello, Base64!";
const encodedText = encodeToBase64(originalText);
const decodedText = decodeFromBase64(encodedText);
console.log("Original:", originalText); // "Hello, Base64!"
console.log("Encoded:", encodedText); // "SGVsbG8sIEJhc2U2NCE="
console.log("Decoded:", decodedText); // "Hello, Base64!" 画像をエンコードして、 Base64
画像ファイル (ファイル入力で選択) を次のように変換します。 Base64 FileReader API を使用します。画像をアップロードまたはインラインで埋め込む前にプレビューするのに役立ちます。
// Get elements from DOM
const fileInput = document.getElementById('image-upload');
const previewImage = document.getElementById('image-preview');
const base64Output = document.getElementById('image-base64');
// Handle file selection
fileInput.addEventListener('change', (e) => {
const file = e.target.files[0];
if (!file || !file.type.startsWith('image/')) {
alert('Please select an image file!');
return;
}
// Create FileReader to read the image
const reader = new FileReader();
// On load, get Base64 data
reader.onload = (event) => {
const base64Data = event.target.result;
// Preview the image
previewImage.src = base64Data;
previewImage.style.display = 'block';
// Show Base64 data (truncated for readability)
const truncatedData = base64Data.length > 100
? base64Data.substring(0, 100) + '...'
: base64Data;
base64Output.textContent = truncatedData;
};
// Read the file as Base64
reader.readAsDataURL(file);
}); Base64 データ (切り捨て):
Base64 BLOB (ファイルのダウンロード) へ
変換する Base64 データを Blob (バイナリ ラージ オブジェクト) に戻して、ブラウザーでダウンロード可能なファイル (PDF、画像など) を作成します。
// Convert Base64 to Blob
function base64ToBlob(base64Data, contentType = 'application/octet-stream') {
// Extract Base64 data (remove "data:..." prefix if present)
const base64WithoutPrefix = base64Data.startsWith('data:')
? base64Data.split(',')[1]
: base64Data;
// Decode Base64 to binary string
const binaryString = atob(base64WithoutPrefix);
const byteLength = binaryString.length;
// Convert binary string to Uint8Array
const uint8Array = new Uint8Array(byteLength);
for (let i = 0; i < byteLength; i++) {
uint8Array[i] = binaryString.charCodeAt(i);
}
// Create and return Blob
return new Blob([uint8Array], { type: contentType });
}
// Trigger file download from Blob
function downloadBlobAsFile(blob, fileName) {
// Create temporary URL for Blob
const url = URL.createObjectURL(blob);
// Create anchor element to trigger download
const a = document.createElement('a');
a.href = url;
a.download = fileName;
// Simulate click to start download
document.body.appendChild(a);
a.click();
// Clean up
document.body.removeChild(a);
URL.revokeObjectURL(url);
}
// Example: Download Base64 PDF
const base64Pdf = "JVBERi0xLjQKJeLjz9MNCjYgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlciAvRmxhdGVEZWNvZGU+PgpzdHJlYW0KeAovRjEgMTAgVGYKMDAwLjEwNS4wMDAuMTAwCjAwMC4yOTkuMDAwLjAwMAo...";
const pdfBlob = base64ToBlob(base64Pdf, 'application/pdf');
downloadBlobAsFile(pdfBlob, 'report.pdf'); Vue.js Base64 成分
再利用可能な Vue.js コンポーネント Base64 エンコード/デコード。 Vue の反応性システムと統合して、リアルタイム更新を実現します。
<template>
<div class="base64-converter">
<h3 class="text-lg font-semibold mb-4">Vue Base64 Converter</h3>
<!-- Input for text -->
<div class="mb-4">
<label class="block mb-2 text-sm font-medium">Enter Text:</label>
<textarea
v-model="inputText"
class="w-full p-2 border rounded"
rows="3"
placeholder="Type text to encode..."
></textarea>
<button
@click="encode"
class="mt-2 px-4 py-1 bg-primary text-white rounded"
>Encode to Base64</button>
</div>
<!-- Output for Base64 -->
<div class="mb-4">
<label class="block mb-2 text-sm font-medium">Base64 Result:</label>
<textarea
v-model="base64Output"
class="w-full p-2 border rounded"
rows="3"
readonly
></textarea>
<button
@click="decode"
class="mt-2 px-4 py-1 bg-secondary text-white rounded"
>Decode to Text</button>
</div>
</div>
</template>
<script>
export default {
data() {
return {
inputText: '',
base64Output: ''
};
},
methods: {
encode() {
if (!this.inputText) return;
// Encode UTF-8 text to Base64
const utf8Text = unescape(encodeURIComponent(this.inputText));
this.base64Output = btoa(utf8Text);
},
decode() {
if (!this.base64Output) return;
// Decode Base64 to UTF-8 text
const utf8Text = atob(this.base64Output);
this.inputText = decodeURIComponent(escape(utf8Text));
}
}
};
</script> よくある質問について Base64
使い始める Base64 フロントエンドプロジェクトで
画像を埋め込んだり、API 経由でファイルを送信したり、ユーザーが作成したコンテンツを操作したりする場合でも、 Base64 は現代の Web 開発者にとって不可欠なツールです。上記のコード例を使用して統合します Base64 エンコードとデコードを次のプロジェクトに組み込むことができます。