AD JB Toolbox 01

CSS / Reference / white-space

white-space는 연속 공백과 원문의 줄바꿈을 보존할지, 너비에 맞춰 자동 줄바꿈을 허용할지 정합니다. 일반 문장은 normal, 입력한 줄바꿈과 공백을 유지하면서 자동으로 감싸려면 pre-wrap을 사용하는 것이 기본적인 선택입니다.

문법과 주요 값

.copy { white-space: normal; }
.log { white-space: pre-wrap; overflow-wrap: anywhere; }
값 또는 구분 동작과 선택 기준
normal 공백·원문 줄바꿈 병합, 자동 줄바꿈 허용
nowrap 공백 병합, 자동 줄바꿈 막음
pre 공백·원문 줄바꿈 보존, 자동 줄바꿈 막음
pre-wrap 공백·원문 줄바꿈 보존, 자동 줄바꿈 허용
pre-line 공백 병합, 원문 줄바꿈 보존, 자동 줄바꿈 허용

값의 적용 범위와 문법은 MDN의 white-space 문서에서 확인할 수 있습니다.

실행 예제와 결과 비교

아래 전체 코드를 UTF-8 형식의 white-space-example.html 파일로 저장한 뒤 브라우저로 여세요. 예제용 CSS는 이 파일 안에만 넣고 사이트 전체 스타일시트에 그대로 붙여 넣지 않습니다.

<!doctype html>
<html lang="ko">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>white-space 비교 예제</title>
<style>
body { margin: 0; color: #20242b; background: #fff; font: 16px/1.7 "Malgun Gothic", sans-serif; }
#demo { padding: 24px; max-width: 820px; margin: auto; }
h1 { font-size: 22px; margin: 0 0 20px; }
.samples { display: flex; flex-wrap: wrap; gap: 24px; }
.label { margin: 0 0 8px; font-weight: 700; }
.target, .reference { width: 240px; padding: 12px; border: 1px solid #718096; }
.target { white-space: pre-wrap; }
.reference { white-space: normal; }
</style>
</head>
<body>
<main id="demo">
<h1>white-space 적용 비교</h1>
<section class="samples"><div class="a"><p class="label">pre-wrap</p><div class="target">첫째    둘째
셋째 줄에는 조금 더 긴 문장이 들어 있습니다.</div></div><div class="b"><p class="label">normal</p><div class="reference">첫째    둘째
셋째 줄에는 조금 더 긴 문장이 들어 있습니다.</div></div></section>
</main>
</body>
</html>

pre-wrap에서는 연속 공백과 원문의 줄바꿈이 남고, normal에서는 같은 텍스트가 일반적인 문장처럼 합쳐집니다. 두 경우 모두 너비에 따른 자동 줄바꿈은 가능합니다.

pre-wrap에서는 연속 공백과 원문의 줄바꿈이 남고, normal에서는 같은 텍스트가 일반적인 문장처럼 합쳐집니다.

긴 한 단어의 처리까지 분리하기

자동 줄바꿈을 허용해도 긴 URL이나 공백 없는 식별자는 넘칠 수 있습니다. white-space는 공백 처리와 감싸기를 제어하며, 단어 내부의 비상 줄바꿈은 overflow-wrap이나 word-break의 역할입니다. nowrap이 있으면 비상 줄바꿈 설정만으로 감싸기가 생기지 않을 수 있습니다.

최신 단축 속성과 기존 키워드

현재 white-space는 white-space-collapse와 text-wrap-mode를 묶는 단축 속성으로 설명됩니다. 위의 전통적인 키워드는 널리 쓰이는 조합입니다. break-spaces는 보존한 공백의 줄바꿈과 끝 공백 처리에서 pre-wrap과 다르므로 공백 자체의 배치가 중요한 경우 별도로 확인하세요.

적용되지 않거나 예상과 다를 때

  • HTML 편집 과정에서 원문의 공백과 줄바꿈이 실제로 남아 있는지 확인합니다.
  • 상위 요소나 테마의 nowrap 규칙이 적용되는지 Computed에서 확인합니다.

관련 설정을 함께 조정할 때는 긴 단어의 비상 줄바꿈, word-break의 언어별 줄바꿈을 참고하세요.

같은 카테고리의 다른 글
CSS / Reference / word-wrap

CSS / Reference / word-wrap

word-wrap의 문법과 주요 값, 실제 적용 조건을 설명합니다. 첫 박스는 긴 주소를 영역에 맞춰 나누지만 normal은 정상적인 줄바꿈 기회가 부족하면 넘칠 수 있습니다.

CSS / Reference / line-height

CSS / Reference / line-height

line-height의 문법과 주요 값, 실제 적용 조건을 설명합니다. 글자 크기가 20px인 첫 박스는 줄 높이가 32px입니다.

CSS / Reference / accent-color

CSS / Reference / accent-color

accent-color의 문법과 주요 값, 실제 적용 조건을 설명합니다. 현재 브라우저가 지원하는 체크·라디오·범위·진행 표시의 강조 부분을 비교합니다.

CSS / Reference / overflow

CSS / Reference / overflow

overflow의 문법과 주요 값, 실제 적용 조건을 설명합니다. auto 박스는 내용이 긴 만큼 내부를 스크롤할 수 있습니다.

CSS / Reference / border-spacing

CSS / Reference / border-spacing

border-spacing의 문법과 주요 값, 실제 적용 조건을 설명합니다. 첫 표에서는 셀 사이에 가로 12px, 세로 6px의 간격이 생깁니다.

CSS / Reference / background-size

CSS / Reference / background-size

background-size의 문법과 주요 값, 실제 적용 조건을 설명합니다. 예제의 배경 도형은 160×80 비율입니다.

CSS / Reference / aspect-ratio

CSS / Reference / aspect-ratio

aspect-ratio의 문법과 주요 값, 실제 적용 조건을 설명합니다. 너비 240px인 첫 박스의 높이는 135px, 두 번째 정사각형은 240px입니다.

CSS / Reference / align-content

CSS / Reference / align-content

align-content의 문법과 주요 값, 실제 적용 조건을 설명합니다. 첫 grid는 두 행이 위아래에 배치되고 그 사이 공간이 늘어납니다.

CSS / Reference / clip

CSS / Reference / clip

clip의 문법과 주요 값, 실제 적용 조건을 설명합니다. 200×120px 도형에서 네 변 안쪽 20px만큼 제외한 영역이 보입니다.

CSS / Reference / text-decoration

CSS / Reference / text-decoration

text-decoration의 문법과 주요 값, 실제 적용 조건을 설명합니다. 첫 예문은 물결 밑줄, 두 번째는 취소선입니다.