주인 Base64 프론트엔드 개발을 위한
이해를 위한 포괄적인 가이드 Base64 현대 웹 디자인의 인코딩, 디코딩 및 실제 응용 프로그램.
노력하다 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) | H(72), i(105), ! (33) | 01001000, 01101001, 00100001 | – |
| 3. 24비트 청크 | 72, 105, 33 | 010010000110100100100001 | – |
| 4. 6비트 세그먼트로 분할 | – | 010010, 000110, 100100, 100001 | – |
| 5. 십진수로 변환 | – | – | 18, 6, 36, 33 |
| 6. Base64 문자에 매핑 | – | – | "피부" |
프런트엔드 Base64 사용 사례
이미지의 데이터 URL
다음을 사용하여 작은 이미지(아이콘이나 아바타 등)를 HTML/CSS에 직접 삽입하세요. Base64 데이터 URL. 이렇게 하면 HTTP 요청이 줄어들고 작은 자산의 페이지 로드 속도가 향상됩니다.
<img src="data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..." alt="Icon">
API 바이너리 데이터 전송
REST API를 통해 바이너리 데이터(예: 파일 또는 PDF)를 인코딩하여 전송합니다. Base64. 이렇게 하면 텍스트 기반 API 페이로드(예: JSON)에서 바이너리 데이터 손상 문제를 방지할 수 있습니다.
{ "fileData": "JVBERi0xLjQKJeLjz9MNCjYgMCBvYmoKPDwvTGVuZ3RoIDMgMCBSL0ZpbHRlciAvRmxhdGVEZWNvZGU+PgpzdHJlYW0KeAovRjEgMTAgVGYKMDAwLjEwNS4wMDAuMTAwCjAwMC4yOTkuMDAwLjAwMAo...", "fileName": "report.pdf" }
쿠키 및 LocalStorage 텍스트 제약 조건
작은 바이너리 데이터를 쿠키나 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 현대 웹 개발자에게 필수적인 도구입니다. 위의 코드 예제를 사용하여 통합 Base64 다음 프로젝트에 인코딩 및 디코딩할 수 있습니다.