개발자 문서: 작동 방식
업로드 도우미
업로드 도우미
“파일이 너무 큽니다” 오류를 없애세요. PDF, 사진, iPhone HEIC 이미지를 방문자의 브라우저에서 줄여 양식에 넘기므로, 양식은 제한에 맞는 파일을 받습니다.
제한을 지정할 위치
파일이 들어오는 곳에 data-pdfkind-max를 추가하세요. 속성이 있는 가장 가까운 요소가 우선하므로, 다른 제한이 걸린 양식 안에서도 필드마다 별도의 제한을 둘 수 있습니다.
| 업로드 방식 | data-pdfkind-max를 넣을 위치 | 예시 |
|---|---|---|
| 파일 필드 | input 요소 | <input type="file" data-pdfkind-max="5MB"> |
| 드래그 앤 드롭 영역 | 해당 영역 (드롭과 “찾아보기” 버튼 모두 적용) | <div class="dropzone" data-pdfkind-max="5MB"> |
| 양식 전체 | form 요소 | <form data-pdfkind-max="5MB"> |
| 페이지의 모든 필드 | 스크립트 태그 (data-max로) | <script src="…/embed.js" data-max="5MB" defer> |
제한 값 작성법
5MB, 500KB, 2.5 MB, 800ko처럼 쓰거나 5000000처럼 바이트 수로 쓸 수 있습니다. 1 MB는 1,000,000바이트입니다.
알아 두세요. 서버에서 5 × 1,024 × 1,024바이트로 검사하더라도
5MB라고 쓰세요. 이 값이 약간 더 작으므로 줄어든 파일은 항상 서버 검사를 통과합니다.파일별 처리 방식
| 파일 | 도우미의 처리 |
|---|---|
| 제한 이하 | 아무것도 하지 않습니다. 창이 열리지 않고 파일이 그대로 양식에 전달됩니다. |
| 제한을 넘는 PDF | 용량을 줄입니다. 먼저 글꼴과 중복 데이터를 정리하고, 그다음 필요한 만큼만 이미지를 가볍게 만듭니다. 텍스트는 선명하고 선택 가능한 상태로 유지됩니다. |
| 제한을 넘는 JPG, PNG, WebP | 필요한 만큼만 다시 인코딩하고 크기를 조정합니다. 투명 영역이 없는 PNG가 제한에 맞지 않으면 JPG로 바뀝니다. |
| HEIC 또는 HEIF (iPhone 사진) | 대부분의 양식이 HEIC를 받지 않으므로, 제한 이하여도 항상 JPG로 변환합니다. |
| 그 밖의 파일 (Word, ZIP 등) | 그대로 둡니다. |
| 여러 파일을 한 번에 | 파일을 하나씩 차례로 처리하며, 필드는 모든 파일을 받습니다. |
방문자에게 보이는 화면
페이지 위에 작은 PDFkind 창이 열려 “파일 용량을 줄이는 중…”을 표시하고, 결과(“8.2 MB에서 3.9 MB로 줄었습니다”)를 보여 준 뒤 저절로 닫힙니다. 대부분의 파일은 1~5초가 걸리며, 오래된 휴대폰에서 긴 스캔 파일을 처리하면 15초 정도 걸릴 수 있습니다.
| 상황 | 결과 |
|---|---|
| 파일을 제한 이하로 줄일 수 없는 경우 | 창에 이유가 표시된 뒤 원본 파일이 전달되므로, 양식에서 평소의 오류가 표시됩니다. |
| 방문자가 창을 닫은 경우 | 원본 파일이 전달됩니다. |
| 창이 8초 안에 로드되지 않는 경우 | 원본 파일이 즉시 전달됩니다 (오프라인이거나 보안 규칙에 의해 차단된 경우). |
| 스크립트 자체를 로드할 수 없는 경우 | 페이지에 아무런 변화가 없으며, 양식은 이전과 똑같이 작동합니다. |
창의 언어
창은 페이지의 <html lang>을 따릅니다. 직접 지정하려면 필드나 스크립트에 data-lang="fr"을 설정하세요. 언어를 참고하세요.
프레임워크
최종 업데이트: 2026년 11월 3일 · 문의: contact@pdfkind.com