PDF 양식 채우기

브라우저에서 동작하는 AcroForm 채우기 도구예요. pdf-lib로 PDF를 파싱해 모든 폼 필드를 열거하고, 각 필드 영역 위에 HTML 입력 요소(텍스트, 텍스트 영역, 체크박스, 라디오, 드롭다운)를 겹쳐서 표시합니다. 저장할 때는 같은 라이브러리로 입력값을 양식에 기록해 파일을 내려받게 돼요. "저장 시 평탄화"를 켜 두면 값이 페이지 콘텐츠에 구워 넣어져, 폼을 지원하지 않는 뷰어 — 예를 들어 이메일 미리보기 — 에서도 채워진 값이 그대로 보입니다. PDF는 기기를 떠나지 않아요.

예시

세금 신고서, 관공서 신청서, 또는 입력 필드가 있는 어떤 PDF든 끌어다 놓아 보세요. 각 필드가 화면 위에서 편집 가능한 입력창으로 바뀝니다. 이름 / 주소 / 서명 필드를 채우고, 알맞은 체크박스를 선택한 뒤 다운로드를 누르세요. 결과 파일은 어떤 뷰어에서 열어도 입력한 값이 제자리에 그대로 보입니다.

자주 마주치는 오류와 함정

AcroForm 채우기로 해결되지 않는 몇 가지 경우 — 대부분 도구의 한계가 아니라 PDF가 어떻게 만들어졌는지의 문제예요.

• 평면화된(AcroForm이 아닌) PDF. 양식처럼 보여도 프로그램이 인식할 수 있는 필드가 전혀 없는 경우가 있어요. 흔한 원인은 스캔 문서, 인쇄 전용으로 디자인된 양식, 또는 폼 필드 옵션을 켜지 않고 Word에서 내보낸 PDF 등이에요. 이때는 "채울 수 있는 필드 없음"이라고 표시됩니다 — PDF Annotator로 바꿔서 페이지에 직접 텍스트를 입력하세요.
• 비밀번호가 걸린 PDF. 열 때 비밀번호를 묻는 PDF는 도구가 파싱할 수 없어요. 권한이 있다면 PDF Restriction Remover로 먼저 잠금을 풀거나, 뷰어에서 열어 비밀번호를 제거한 뒤 사용하세요.
• XFA 양식. XFA는 Adobe 독자 규격으로, 일부 오래된 관공서나 은행 PDF에서 쓰여요. 오픈소스 PDF 라이브러리(이 도구 포함)는 XFA 필드를 읽지 못합니다. Adobe Acrobat에서 열어 거기서 채우거나, 인쇄해서 다시 스캔해 일반적인 AcroForm으로 만든 뒤 사용하세요.
• 입력 후 필드 위치가 어긋나요. 필드 오버레이 사각형이 인쇄된 양식 그림과 정확히 맞지 않는다면, 그 PDF는 시각적 페이지와 필드 메타데이터가 어긋나게 만들어진 거예요. 저장 결과의 값 자체는 정확합니다 — 화면 위 오버레이만 살짝 밀려 있어요. "저장 시 평탄화"를 켜면 저장된 PDF가 양식 그림이 아닌 필드 메타데이터를 기준으로 자리잡게 됩니다.
• 필드가 형식에 안 맞는 값을 받아 줍니다. 일부 필드는 형식(날짜, 통화, 정규식)을 강제해요. 이 도구는 형식 검증을 하지 않습니다 — 양식이 기대하는 값을 입력하면 입력 그대로 저장됩니다. 대부분의 PDF 뷰어는 나중에 양식이 열릴 때 검증을 수행해요.

제 파일이 어딘가로 업로드되나요?

아니요. PDF는 브라우저 탭 안에서 파싱되고 pdf-lib로 저장돼요 — 전부 클라이언트 측에서 처리됩니다. 업로드도, 저장도, 로그도 없어요. 브라우저의 DevTools 네트워크 탭에서 직접 확인해 보셔도 됩니다 — 저장할 때 어떤 요청도 발생하지 않아요.

AcroForm이 뭔가요?

AcroForm은 PDF 표준에 정의된 일반적인 PDF 양식 형식이에요 — 텍스트 필드, 체크박스, 라디오 버튼, 드롭다운, 서명 등이 문서 안에 객체로 들어가 있죠. 요즘 대부분의 PDF 양식(세무 서식, 신청서, 계약서 템플릿)이 AcroForm입니다. 이 도구는 그걸 읽고 쓸 수 있어요. 다른 형식인 XFA는 Adobe 독자 규격이라 지원하지 않습니다.

"저장 시 평탄화"는 어떤 동작인가요?

평탄화는 폼 필드를 페이지 콘텐츠로 굳히는 작업이에요 — 입력값이 페이지 그래픽의 일부가 되고 필드는 사라집니다. 더는 편집되지 않는 최종본이 필요할 때 쓰세요(예: 서명한 양식을 메일로 보낼 때). 받는 사람이 양식을 더 편집하길 원한다면 꺼 두세요.

필드가 없는 PDF에 새 필드를 추가할 수 있나요?

이 도구로는 안 돼요. 새 필드를 추가하려면 Acrobat이나 LibreOffice Draw 같은 폼 디자이너가 필요합니다. 그냥 페이지에 텍스트만 입력하면 된다면 PDF Annotator를 쓰세요.

탭을 닫으면 입력값이 저장되나요?

아니요. 입력값은 다운로드를 누르기 전까지 메모리에만 있어요. 새로고침하거나 탭을 닫는 순간 모두 사라집니다. 물론 다운로드한 PDF에는 값이 그대로 구워 넣어져 있어요.

PDF 양식에 어떻게 서명하나요?

눈에 보이는 서명 도장이 필요하다면 PDF Sign 도구로 서명을 그려 페이지에 배치하세요. AcroForm의 서명 필드라면, 여기서 양식을 채워 저장한 뒤 그 파일에 PDF Sign으로 서명 도장을 추가하면 됩니다. 암호 기반 전자서명(감사 추적, 인증서 기반)은 어떤 브라우저 도구로도 다룰 수 없는 영역이에요.