이미지컨버

주인 Base64 프론트엔드 개발을 위한

이해를 위한 포괄적인 가이드 Base64 현대 웹 디자인의 인코딩, 디코딩 및 실제 응용 프로그램.

노력하다 Base64 인코딩/디코딩

정확히 무엇입니까? Base64?

Base64 바이너리 데이터(예: 이미지, 파일 또는 원시 바이트)를 ASCII 문자로 변환하는 바이너리-텍스트 인코딩 체계입니다. 이러한 변환을 통해 이메일 프로토콜, HTML 또는 API 응답과 같은 텍스트 전용 데이터용으로 설계된 시스템에 바이너리 데이터를 안전하게 전송하고 저장할 수 있습니다.

"Base64"라는 이름은 이진 값을 표시하기 위해 64개의 고유 문자(A-Z, a-z, 0-9, '+' 및 '/')를 사용하는 데서 유래되었습니다. 각 Base64 문자는 6비트 데이터를 인코딩하므로 텍스트 중심 환경에서 바이너리 콘텐츠를 효율적으로 처리할 수 있습니다.

암호화와 달리 Base64 보안 조치가 아니며 순전히 데이터 형식 지정을 위한 것입니다. 누구나 기본 도구를 사용하여 Base64 콘텐츠를 디코딩할 수 있으므로 민감한 정보를 보호하는 데 사용해서는 안 됩니다.

Base64 문자 세트

에이
비
기음
디
이자형
에프
G
시간
나
제이
케이
엘
중
N
영형
피
큐
아르 자형
에스
티
유
다섯
여
X
와이
지
에이
비
기음
디
이자형
에프
g
시간
…
엑스
와이
지
0
1
2
3
4
5
6
7
8
9
+
/

* "="는 불완전한 데이터에 대한 패딩 문자로 사용됩니다.

어떻게 Base64 인코딩 작업?

  1. 1

    바이너리 데이터를 8비트 바이트로 변환

    프로세스는 이진 데이터(예: 이미지 파일)로 시작됩니다. 이 데이터는 8비트(1바이트) 세그먼트로 분할되어 다음의 원시 입력을 형성합니다. Base64 부호화.

  2. 2

    바이트를 24비트 청크로 그룹화

    부터 Base64 6비트 문자를 사용하는 경우 8비트 바이트는 24비트(3바이트) 청크로 그룹화됩니다. 24비트는 4개의 6비트 세그먼트(4 × 6 = 24)로 균등하게 나눌 수 있습니다.

  3. 3

    6비트 세그먼트를 Base64 문자로 변환

    각 6비트 세그먼트는 10진수 값(0~63)으로 변환됩니다. 그런 다음 이 값은 다음의 해당 문자에 매핑됩니다. Base64 문자 집합(예: 0 = “A”, 1 = “B”, …, 63 = “/”).

  4. 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 다음 프로젝트에 인코딩 및 디코딩할 수 있습니다.