블로그 목록

CSS Flexbox 자식 요소 텍스트 말줄임표 미적용 해결 방법과 min-width 0 설정 가이드

CSS Flexbox 레이아웃 안에서 긴 텍스트에 말줄임표가 적용되지 않고 컨테이너 밖으로 넘치는 원인을 짚어보고, flex 아이템의 min-width 속성을 재설정하여 안정적으로 한 줄 말줄임표를 구현하는 방법을 단계별로 안내합니다.

개발 CSS Flexbox 자식 요소 텍스트 말줄임표 미적용 해결 방법
CSS Flexbox 레이아웃에서 텍스트 말줄임표가 정상 작동하도록 min-width 속성을 편집하는 코드 에디터 화면

목표와 준비 사항: Flexbox 텍스트 넘침 현상과 실습 환경

웹 UI를 제작할 때 아이콘과 텍스트를 가로로 배치하거나 카드 레이아웃의 제목을 구성하기 위해 CSS Flexbox를 자주 활용합니다. 이때 흔히 텍스트가 부모 너비를 초과하면 말줄임표(...)로 축소되도록 'white-space: nowrap;', 'overflow: hidden;', 'text-overflow: ellipsis;'라는 세 가지 필수 속성을 지정합니다. 일반적인 블록 요소에서는 이 스타일만으로 말줄임표가 자연스럽게 동작하지만, 부모 컨테이너가 'display: flex;'로 지정된 환경에서는 텍스트가 잘리지 않고 부모 영역을 뚫고 나가거나 우측 버튼을 화면 밖으로 밀어내는 레이아웃 깨짐 현상이 빈번하게 발생합니다.

이번 가이드의 목표는 Flex 컨테이너의 기본 크기 계산 방식 때문에 발생하는 말줄임표 미적용 오류를 이해하고, flex 자식 요소의 속성을 올바르게 교정하여 반응형 화면에서도 의도한 너비에 맞춰 텍스트가 줄어들도록 만드는 것입니다. 실습을 위해 최신 데스크톱 브라우저(크롬, 파이어폭스, 엣지 등)와 간단한 텍스트 에디터(VS Code 등)를 준비해 주시면 됩니다. 브라우저 개발자 도구(F12)의 요소 검사 기능을 함께 활용하면 계산된 너비 변화를 실시간으로 확인하며 학습할 수 있습니다.

flexbox-text-overflow-layout-preparation

실행 순서: flex 아이템의 최소 너비 재설정 단계

Flexbox 내부에서 텍스트 말줄임표가 동작하지 않는 근본적인 이유는 CSS Flexible Box Layout 명세에 정의된 'min-width'의 기본 동작 방식에 있습니다. 일반 블록 요소의 'min-width' 기본값은 0이지만, flex 자식 요소(Flex item)의 'min-width' 기본값은 키워드 값인 'auto'로 지정됩니다. 이로 인해 flex 아이템은 자신이 포함한 콘텐츠의 최소 고유 너비(min-content size) 이하로 줄어들지 않으려는 성질을 갖게 되며, 긴 텍스트 문자열이 컨테이너의 가용 폭보다 넓으면 텍스트 전체 너비를 유지하기 위해 부모 영역을 초과해 확장됩니다.

이를 해결하기 위한 실행 순서는 명확합니다. 첫 번째로 flex 컨테이너에 'display: flex'를 지정하고 자식 요소들의 비율을 구성합니다. 두 번째로 텍스트를 감싸고 있거나 텍스트를 직접 담고 있는 flex 자식 요소에 'min-width: 0;'을 명시적으로 선언합니다. 이 선언은 flex 아이템이 콘텐츠 크기에 얽매이지 않고 flex 알고리즘에 따라 지정된 비율이나 부모 폭만큼 줄어들 수 있도록 강제합니다. 마지막으로 해당 요소 또는 내부 텍스트 노드에 'overflow: hidden;'과 'text-overflow: ellipsis;', 'white-space: nowrap;'을 결합하여 말줄임 처리를 활성화합니다.

flexbox-min-width-zero-step-sequence

구체적인 입력 예시: HTML 마크업과 CSS 코드 구성

실무에서 자주 쓰이는 프로필 목록이나 알림 카드 컴포넌트를 가정한 예제 코드입니다. 아바타 이미지 영역과 긴 사용자 이름, 그리고 우측 버튼이 한 줄에 나란히 배치되는 UI 구조를 작성해 보겠습니다.

html
<div class="card-item">
<div class="avatar">IMG</div>
<div class="content-box">
<p class="user-title">가정용 테스트 계정: 이것은 매우 길어서 부모 컨테이너를 넘어갈 수 있는 긴 사용자명 텍스트입니다</p>
</div>
<button type="button" class="action-btn">확인</button>
</div>

다음으로 CSS 스타일시트에 Flexbox와 텍스트 말줄임 속성을 다음과 같이 적용합니다. 핵심은 텍스트를 감싼 flex 아이템인 '.content-box'에 'min-width: 0;'을 부여하는 것입니다.

css
.card-item {
display: flex;
align-items: center;
gap: 12px;
width: 100%;
max-width: 380px;
padding: 12px;
border: 1px solid #e2e8f0;
border-radius: 8px;
box-sizing: border-box;
}

.avatar {
flex-shrink: 0;
width: 40px;
height: 40px;
background-color: #cbd5e1;
border-radius: 50%;
}

.content-box {
flex: 1;
min-width: 0; /* flex 아이템이 축소되도록 허용하는 핵심 속성 */
}

.user-title {
margin: 0;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}

.action-btn {
flex-shrink: 0;
padding: 6px 12px;
}

css-flex-child-ellipsis-code-snippet

기대 결과 확인: 브라우저 개발자 도구 점검과 렌더링 검증

코드를 브라우저에 띄우고 개발자 도구(F12)를 열어 검증을 진행합니다. 올바르게 설정되었다면 '.card-item'의 폭이 380px로 제한된 상태에서, 가운데 위치한 '.user-title'의 긴 문장이 오른쪽 버튼을 밀어내지 않고 영역 끝에서 깔끔하게 '...' 기호로 잘려 렌더링되어야 합니다. 우측의 '확인' 버튼 역시 찌그러지지 않고 온전한 크기를 유지합니다.

반응형 동작을 확인하기 위해 브라우저 창 너비를 좁히거나 모바일 뷰포트 시뮬레이터를 켜고 카드의 가로 폭을 줄여보십시오. 카드의 가로 폭이 줄어듦에 따라 '.content-box'의 계산된 너비(Computed width)가 함께 감소하면서 말줄임표가 나타나는 지점이 실시간으로 유연하게 조절되는 것을 확인할 수 있습니다. 만약 'min-width: 0;'을 임시로 주석 처리하면 텍스트가 다시 버튼을 화면 바깥으로 밀어내거나 카드 우측 테두리를 뚫고 나가는 현상을 즉시 관찰할 수 있으므로, 해당 속성의 영향력을 직접 체감할 수 있습니다.

browser-responsive-ellipsis-rendered-output

주의점: 다단 중첩 Flex 구조와 세로 정렬 시 발생 가능한 오류

실무 작업에서는 Flex 컨테이너가 1단계로 끝나지 않고 2단계 이상 중첩(Nested Flexbox)되는 경우가 많습니다. 부모 요소뿐 아니라 그 상위 래퍼까지 연쇄적으로 Flexbox로 선언되어 있다면, 가장 안쪽 텍스트 요소에만 'min-width: 0;'을 주는 것으로는 문제가 해결되지 않을 수 있습니다. 텍스트를 감싸고 있는 모든 상위 flex 아이템 계층마다 'min-width: 0;' 혹은 'overflow: hidden;'이 선언되어 있는지 상향식으로 점검해야 합니다.

또한 Flex 컨테이너의 주 축(flex-direction)이 'column'인 환경에서는 너비(width)가 아닌 높이(height) 기준으로 기본값이 작동합니다. 이때는 'min-width' 대신 'min-height: 0;'을 고려해야 할 상황이 생기며, 가로 너비 기준 말줄임을 원할 경우 자식 요소에 'width: 100%;'를 명시하여 블록 가로 폭을 확정해야 합니다. 아울러 다국어 환경에서 아랍어나 히브리어와 같은 RTL(오른쪽에서 왼쪽 읽기) 텍스트를 다룰 때는 텍스트 정렬 방향과 인라인 축 특성에 따라 말줄임표 위치가 달라질 수 있으므로 레이아웃 테스트 시 다국어 샘플 데이터를 반드시 대입해 보아야 합니다.

nested-flexbox-overflow-edge-cases
조회 17