CSS Flex에서 긴 파일명이 버튼을 밀어낼 때: 최소 폭과 줄바꿈

파일 목록에서 짧은 이름은 잘 보이는데, 공백 없는 긴 파일명 하나 때문에 옆의 상세 보기 버튼이 행 밖으로 밀리나요? 가로 Flex 행에서는 파일명 상자가 얼마나 좁아질 수 있는지와, 좁아진 상자 안에서 글자가 어디서 줄을 바꾸는지를 따로 확인해야 합니다. 이 글은 버튼을 같은 행에 두면서 파일명도 전부 읽을 수 있게 하는 경우를 다룹니다.

버튼이 밀리는지, 글자만 넘치는지 확인하세요

관찰 먼저 볼 곳 고치는 방향
파일명 상자와 버튼이 함께 행 밖으로 나간다 display: flex의 직계 자식인 파일 정보 상자 그 항목의 자동 최소 크기가 긴 텍스트에 끌려가는지 확인한다. 필요하면 min-inline-size: 0을 시험한다.
버튼은 제자리인데 파일명이 버튼에 겹치거나 행을 넘는다 파일명 텍스트가 있는 요소의 white-space와 overflow-wrap 줄바꿈이 허용된 상태에서 overflow-wrap: anywhere를 시험한다. 한 줄만 허용하는 화면이라면 전체 이름을 볼 방법도 마련한다.
짧은 이름에서도 버튼이나 간격이 행 너비를 거의 다 쓴다 버튼 최소 너비, 고정 폭 요소, gap 파일명만 줄여서는 공간이 생기지 않는다. 좁은 화면에서는 버튼을 다음 줄에 배치하는 편이 읽기 쉽다.

이 예제처럼 내용이 있는 가로 Flex 항목에 min-inline-size: auto가 적용되고 overflow가 스크롤을 만들지 않는 값이면, 브라우저는 주축의 자동 최소 크기를 내용에 맞춰 정합니다. flex-shrink: 1은 줄어들 수 있는 비율을 정하지만 그 최소 크기 아래로 상자를 줄여 주지는 않습니다. 파일명만 담은 안쪽 span에 최소 폭을 지정하기 전에, 어느 상자가 실제로 Flex 항목인지 찾으세요.

한 파일에서 파일명 상자와 버튼을 비교하세요

아래를 flex-file-row.html로 저장해 브라우저에서 엽니다. 테두리는 행이 차지하는 영역입니다. 먼저 기본 상태를 본 뒤 CSS 마지막의 두 줄을 하나씩 켜 보세요. 버튼은 위치를 비교하기 위한 것으로 클릭 동작은 없습니다.

<!doctype html>
<html lang="ko">
<meta charset="utf-8">
<title>파일 목록의 flex 최소 폭 실험</title>
<style>
  .file-row {
    display: flex;
    align-items: start;
    gap: 12px;
    width: 280px;
    outline: 1px solid #777;
    font: 16px/1.5 system-ui;
  }
  .file-meta { flex: 1 1 auto; }
  .file-name { display: block; }
  .file-row button { flex: 0 0 auto; font: inherit; }

  /* 해결 조합을 비교하려면 아래 두 줄의 주석을 해제합니다. */
  /* .file-meta { min-inline-size: 0; } */
  /* .file-name { overflow-wrap: anywhere; } */
</style>
<div class="file-row">
  <div class="file-meta">
    <span class="file-name">Q4INVENTORYEXPORT202611090830BRANCHNORTHEASTRECONCILIATIONUNREVIEWED.csv</span>
    <small>검토 대기</small>
  </div>
  <button type="button">상세 보기</button>
</div>
</html>

이 가로 쓰기 예제에서 min-inline-size: 0은 파일 정보 상자의 최소 너비를 0으로 명시합니다. 파일명을 줄바꿈하는 규칙은 이름 요소에 따로 적용합니다. overflow-wrap: anywhere가 추가한 줄바꿈 기회는 내용이 요구하는 최소 폭에도 반영됩니다. break-word는 좁아진 상자에서 단어를 줄바꿈할 수 있지만, 그 줄바꿈 기회를 내용의 최소 폭을 계산할 때는 쓰지 않습니다.

Chrome에서 행 너비와 텍스트 줄 수를 측정했습니다

2026년 11월 9일, Chrome 157.0.8103.38 헤드리스에서 위 HTML을 실행했습니다. 행의 clientWidth와 scrollWidth, 버튼의 오른쪽 경계와 파일명 텍스트의 줄 수를 비교했습니다. 두 너비가 같아야 행의 가로 넘침이 사라진 것으로 봤습니다.

파일 정보 상자 / 파일명에 적용한 값 행 너비 / 내용이 차지한 너비 버튼이 행 안에 있음 파일명 줄 수
기본값: auto / normal 280px / 772px 아니요 1
최소 크기만 0 / normal 280px / 674px 예 1
auto / break-word 280px / 772px 아니요 1
auto / anywhere 280px / 280px 예 4
0 / anywhere 280px / 280px 예 4
0 / anywhere (좁은 행) 220px / 220px 예 6

이 예제에서는 anywhere 한 줄로도 파일 정보 상자가 충분히 줄었습니다. 최소 폭만 0으로 만든 경우는 버튼이 들어왔어도 긴 텍스트가 넘쳤습니다. 두 속성은 각각 상자의 최소 크기와 글자의 줄바꿈을 제어하므로, 실제 화면에서 필요한 조건만 골라 적용하세요. 측정은 로컬 HTML 한 개에서 진행했으며 운영 화면, 모바일 기기, 다른 브라우저 엔진은 시험하지 않았습니다.

실제 파일 목록에서는 세 가지를 다시 확인하세요

  1. 개발자 도구에서 버튼과 같은 Flex 행에 들어가는 직계 자식을 찾습니다. 이름이 중첩된 레이아웃 안에 있다면 각 Flex 행의 직접 자식 중 실제로 폭을 막는 상자를 좁힙니다. 관련 없는 항목의 최소 크기를 일괄 해제하지 않습니다.
  2. 파일명이 넘치면 white-space: nowrap이 적용됐는지 확인합니다. 전체 이름을 읽어야 하는 화면이면 줄바꿈을 허용합니다. 디자인상 말줄임이 필요하다면 상세 보기 등에서 전체 이름을 확인할 수 있어야 합니다.
  3. 공백 없는 파일명, 짧은 한글 파일명, 긴 버튼 라벨을 각각 넣고 좁은 너비와 확대 상태에서 봅니다. 행의 scrollWidth가 clientWidth보다 커지는지, 이름 끝과 확장자가 읽히는지, 키보드로 버튼에 도달했을 때 초점 표시가 가려지지 않는지 확인하세요.

공식 문서와 관련 가이드