화면에서는 스크롤하면 끝까지 보이는데 인쇄 미리보기나 PDF에는 앞부분만 나온다면, 먼저 출력할 내용이 DOM에 있는지, 인쇄 스타일이 적용됐는지, 본문을 가두는 크기·넘침 규칙이 있는지 나눠 보세요. 글자 크기를 계속 줄이거나 모든 영역에 페이지 나눔 금지를 붙이면 누락 원인을 찾기 어려워집니다.
이 글은 브라우저의 일반 HTML 문서를 인쇄하거나 ‘PDF로 저장’하는 경우를 다룹니다. 화면 캡처를 이미지로 바꾸는 라이브러리, 별도 서버의 PDF 엔진, canvas 도표의 고해상도 출력은 다른 경로입니다. 아래 예제는 인쇄 전용 스타일을 설명하는 코드이며 이 사이트의 본문 스타일을 바꾸거나 실제 PDF 출력을 완료한 결과가 아닙니다.
잘리는 모양으로 첫 점검 위치를 고르세요
| 증상 | 먼저 볼 것 | 확인 방법 |
|---|---|---|
| 안쪽 스크롤 영역의 앞부분만 보임 | 본문과 부모의 height·max-height·overflow | print 조건에서 계산된 스타일과 전체 내용 유무 대조 |
| 오른쪽 코드·표가 잘림 | 고정 폭·min-width·white-space | 종이 폭에 맞는 줄바꿈·열 구성부터 비교 |
| 중간 항목 자체가 없음 | 가상 목록·접힌 영역·미완료 데이터 | 인쇄 전에 해당 항목이 실제 DOM에 있는지 확인 |
| 메뉴·배너가 본문을 덮음 | fixed·sticky 요소와 출력 대상 | 조작 UI를 인쇄 스타일에서 숨겨 비교 |
| 큰 빈칸 뒤에 내용이 몰림 | 넓게 적용한 break-inside: avoid와 강제 나눔 | 짧은 묶음만 분할을 피하도록 범위 축소 |
| 인쇄창을 닫았는데 ‘저장 완료’ 표시 | print 호출·afterprint를 완료 판정에 사용했는지 | 사용자 취소와 실제 저장 확인을 구분 |
먼저 브라우저·OS, 용지 크기·방향·배율·여백, 머리말/꼬리말·배경 옵션을 기록하세요. 같은 문서라도 이 조건이 다르면 줄바꿈과 페이지 수가 달라집니다. 특정 페이지 수만 같다는 사실보다 시작·끝 항목과 중간 내용이 빠짐없이 있는지가 더 좋은 판정 기준입니다.
내용 준비와 CSS 적용을 따로 확인하세요
가상 목록이 현재 화면 근처의 항목만 DOM에 만들거나 ‘더 보기’를 눌러야 내용을 가져온다면, CSS로 스크롤을 풀어도 아직 생성되지 않은 항목은 생기지 않습니다. 출력할 범위·개수·현재 필터를 먼저 확정하고 데이터와 화면 생성을 마친 뒤 인쇄를 요청하는 흐름이 필요합니다. 접힌 상세 영역이나 아직 로드되지 않은 그림도 별도로 확인하세요.
MDN 인쇄 스타일 문서처럼 @media print 또는 media=”print” 스타일시트로 출력 규칙을 나눌 수 있습니다. 개발자 도구의 인쇄 미디어 에뮬레이션은 어떤 규칙이 적용되는지 찾는 데 쓰고, 최종 페이지 나눔 판정은 실제 미리보기와 저장한 파일에서 하세요. 일반적인 CSS 우선순위도 그대로 적용되므로 규칙을 썼다는 사실만으로 적용됐다고 결론 내리지 않습니다.
내부 본문만 보지 말고 상위 레이아웃까지 고정 높이·overflow: hidden/clip·가로 최소 폭을 확인하세요. overflow 문서는 스크롤과 잘림을 구분하며 인쇄기는 넘친 내용을 출력할 수도 있다고 설명합니다. 따라서 overflow: auto 하나만으로 모든 브라우저에서 잘린다고 단정하기보다 크기 제한과 실제 출력 결과를 함께 확인해야 합니다.
고정 높이를 인쇄에서 푸는 비교용 예제
report.html과 report.css를 같은 폴더에 두는 구성입니다. 화면에서는 14rem 높이의 안쪽 영역을 스크롤하고, 인쇄에서는 내용 높이에 맞춰 흐르게 합니다. 시작·끝 표식과 번호 01~12를 넣어 누락·중복을 비교할 수 있게 했습니다. 테스트 메모는 작성한 샘플이며 특정 브라우저에서 이 출력 결과를 직접 관찰했다는 의미는 아닙니다.
<!doctype html>
<html lang="ko">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>인쇄 범위 비교용 메모</title>
<link rel="stylesheet" href="report.css">
</head>
<body>
<p class="toolbar">화면에서는 안쪽 영역을 스크롤합니다. 브라우저 인쇄 메뉴로 비교하세요.</p>
<main class="report-shell">
<h1 id="report-title">인쇄 범위 비교용 메모</h1>
<p>시작 표식: PRINT-BEGIN-01 / 테스트 항목 12개</p>
<section class="report-body" tabindex="0" role="region" aria-labelledby="report-title">
<h2>확인할 항목</h2>
<ol class="report-lines">
<li class="keep-together">항목 01 — 화면과 인쇄의 첫 줄</li>
<li class="keep-together">항목 02 — 고정 높이 확인</li>
<li class="keep-together">항목 03 — 안쪽 스크롤 확인</li>
<li class="keep-together">항목 04 — 부모 영역의 잘림 확인</li>
<li class="keep-together">항목 05 — 인쇄 스타일 적용 확인</li>
<li class="keep-together">항목 06 — 글자 크기와 줄바꿈 확인</li>
<li class="keep-together">항목 07 — 페이지 사이의 누락 확인</li>
<li class="keep-together">항목 08 — 중복 출력 확인</li>
<li class="keep-together">항목 09 — 인쇄 방향과 여백 확인</li>
<li class="keep-together">항목 10 — 작은 화면과 구분</li>
<li class="keep-together">항목 11 — 저장한 PDF에서 확인</li>
<li class="keep-together">항목 12 — 마지막 항목</li>
</ol>
<pre>긴 식별자: report-demo-abcdefghijklmnopqrstuvwxyz-0123456789-abcdefghijklmnopqrstuvwxyz-0123456789</pre>
<p>끝 표식: PRINT-END-12</p>
</section>
</main>
</body>
</html>
body {
margin: 1rem;
color: #172b3a;
background: #fff;
font-family: sans-serif;
line-height: 1.6;
}
.report-shell { max-width: 52rem; margin: auto; }
.report-body {
height: 14rem;
overflow: auto;
border: 1px solid #777;
padding: 1rem;
}
.report-lines { padding-left: 1.6rem; }
.report-lines li { padding-block: 0.6rem; }
.report-body pre { overflow: auto; }
@page { size: A4; margin: 14mm; }
@media print {
body { margin: 0; color: #000; background: #fff; }
.toolbar { display: none; }
.report-shell { width: auto; max-width: none; margin: 0; }
.report-body {
height: auto;
max-height: none;
overflow: visible;
border: 0;
padding: 0;
}
.report-body pre {
white-space: pre-wrap;
overflow-wrap: anywhere;
overflow: visible;
}
.report-body h2 { break-after: avoid; }
.keep-together { break-inside: avoid; }
}
height: auto와 max-height: none은 세로 크기 제한을 풀고 overflow: visible은 출력용 본문을 스크롤 상자 밖의 흐름으로 보이게 하는 의도입니다. 대상은 이 예제의 report-body로 좁혔습니다. 모든 요소의 overflow를 전역으로 바꾸는 방식은 다른 레이아웃의 겹침을 만들 수 있으므로 피하세요. 실제 앱에서는 부모의 제한도 따로 풀어야 할 수 있습니다.
긴 식별자는 pre의 공백·개행을 유지하면서 줄바꿈하도록 pre-wrap과 overflow-wrap: anywhere를 사용했습니다. 소스 파일의 줄바꿈이 바뀌는 것은 아니지만, 출력 화면에서 코드 줄을 접는 것이 허용되는지는 문서 목적에 맞춰 정해야 합니다. 표가 너무 넓다면 글자만 줄이기 전에 열을 나누거나 요약·상세 출력을 분리하는 방법도 검토하세요.
페이지 나눔을 피할 범위는 짧은 묶음으로 제한하세요
break-inside는 요소 내부의 분할을 제어합니다. 예제는 한 줄짜리 항목처럼 짧은 묶음에만 avoid를 붙였습니다. 긴 보고서 전체에 붙인다고 한 장에 들어가지는 않습니다. CSS Fragmentation 표준은 공간이 부족하면 일부 분할 회피 규칙을 완화할 수 있다고 설명하므로, avoid를 내용 보존의 절대 보장으로 다루지 마세요.
예제의 @page는 A4와 14mm 여백을 목표로 지정한 샘플입니다. 사용자 설정·출력 엔진·프린터 조건을 포함해 결과를 확인해야 하며 모든 서비스에 맞는 수치는 아닙니다. 먼저 폭과 높이 제약을 고친 뒤 실제 사용할 용지에서 제목이 홀로 남는지, 항목이 쪼개지는지 조정하세요.
미리보기와 저장 파일에서 이 순서로 비교하세요
아래는 독자가 대상 환경에서 수행할 검증 계획입니다. 이 글에서는 예제의 파일 구성·선택자 대상·코드 표시를 정적으로 검토했으며, 예제를 브라우저에서 실행하거나 인쇄 미리보기·PDF 생성·실물 출력을 시험하지 않았습니다. 자동 테스트 통과 건수나 출력 성공 페이지 수를 제시하지 않습니다.
- 기준 문서를 하나 고정합니다. 시작 PRINT-BEGIN-01, 번호 01~12, 끝 PRINT-END-12가 DOM에 있는지 봅니다. 더 긴 사례는 항목을 늘리되 기대 개수도 함께 기록합니다.
- 화면에서 안쪽 스크롤 끝까지 이동해 끝 표식을 확인합니다. 화면에서 보인다는 사실은 인쇄 통과와 별개로 기록합니다.
- 예제 사본에서 @media print 블록을 뺀 경우와 넣은 경우를 같은 용지·방향·배율·여백으로 비교합니다. 제거한 쪽이 반드시 실패한다고 가정하지 말고 실제 차이를 기록합니다.
- 미리보기에서 모든 번호의 누락·중복과 긴 식별자의 오른쪽 잘림을 확인합니다. 페이지가 늘어나도 내용이 보존된다면 무조건 실패로 보지 않습니다.
- PDF로 저장한 뒤 파일을 다시 열어 중간 페이지와 끝 표식을 대조합니다. 미리보기에서 보인 내용이 저장 파일에도 있는지 확인합니다.
- 제품에서 지원하는 다른 브라우저·용지와 인쇄 취소 경로를 확인합니다. 실제 종이가 필요하면 별도로 출력해 장치의 인쇄 가능 영역도 점검합니다.
| 사례 | 기록할 관찰 | 통과 기준 |
|---|---|---|
| 짧은 12개 항목 | 시작·끝 표식과 순서 | 번호 01~12가 빠짐없이 한 번씩 존재 |
| 여러 장을 넘는 긴 목록 | 페이지 경계 앞뒤의 항목 번호 | 중간 누락·중복 없음 |
| 긴 식별자·코드·넓은 표 | 오른쪽 끝과 줄 접힘 | 의미 있는 문자가 잘리지 않고 읽을 수 있음 |
| 조작 UI와 고정 헤더 | 숨김 대상·본문 겹침 | 출력할 본문이 UI에 가려지지 않음 |
| 미리보기 취소 | 화면 복귀·상태 안내 | 취소를 저장·출력 완료로 표시하지 않음 |
인쇄창을 닫은 사실을 저장 완료로 쓰지 마세요
window.print()는 현재 문서의 인쇄창을 여는 함수이며 저장 경로나 성공 결과를 반환하지 않습니다. afterprint도 인쇄 시작 뒤 또는 미리보기 창이 닫힌 때 발생할 수 있습니다. 이 이벤트만으로 ‘PDF 저장 완료’나 ‘프린터 출력 완료’를 표시하면 취소한 사용자에게도 거짓 안내가 될 수 있습니다.
인쇄 중 임시 UI를 복원하는 용도와 실제 산출물 확인을 나누세요. 서버가 PDF를 만드는 별도 기능이라면 작업 상태·파일 생성·다운로드 결과를 그 기능의 계약으로 판단해야 하며, 브라우저 인쇄 이벤트로 대신할 수 없습니다.
공식 자료와 이어서 볼 가이드
2026년 10월 28일 아래 공식 문서를 직접 읽고 예제의 적용 조건과 확인 절차를 대조했습니다. 설명용 HTML·CSS와 검증 계획을 제공하며, 실제 인쇄 결과를 검증한 기록은 포함하지 않습니다.