Skip to content

ELOG 002 note table page overflow

wcorn edited this page Jun 6, 2026 · 1 revision

ELOG-002: 노트 표가 페이지 전체를 좌우로 넓힘

항목 내용
분류 🔧 트러블슈팅
날짜 2026-06
영역 FE (Tiptap / CSS 레이아웃)
관련 이슈/PR #431, #440, #441, #442
상태 해결

인덱스로 돌아가기: Engineering Log

1. 상황 (Before)

노트 본문에 넓은 표(열 여러 개)를 넣으면, Notion처럼 표 영역만 좌우 스크롤되어야 하는데 페이지 전체가 좌우로 늘어나 화면 전체를 드래그해야 했다.

2. 원인 분석

처음엔 표 자체 CSS 문제로 보고 .tiptap table을 width:max-content로, .tableWrapper를 overflow-x-auto로 바꿨다(#440, #441). 그래도 재현돼서 실제 prod 브라우저로 부모 체인의 width/scrollWidth를 측정했다.

  • .tableWrapper는 overflow-x:auto로 정상 (자기 안에선 스크롤 가능)
  • 부모를 타고 올라가니 AppLayout의 <main className="flex-1 p-6">가 표 너비만큼 늘어남
  • <main>은 flex 자식인데 min-width: auto(기본값)라 콘텐츠(넓은 표)를 밀어내지 못하고 같이 늘어남 → documentElement.scrollWidth > viewport → 페이지 가로 스크롤

즉 NoteEditor/tableWrapper만 보고 공통 레이아웃의 <main>을 놓친 것이 진짜 원인.

3. 조치

AppLayout의 <main>에 min-w-0 추가 (#442):

- <main className="flex-1 p-6">
+ <main className="min-w-0 flex-1 p-6">

4. 결과 (After)

실측 (1280px viewport, 넓은 표):

수정 전 수정 후
documentElement.scrollWidth 1443 (> vw 1280) → 페이지 넘침 1280 (안 넘침)
<main> width 1219 (콘텐츠만큼 늘어남) 760 (부모에 맞음)
표 가로 스크롤 무력 동작 (scrollWorks: true)

5. 교훈 / 후속

  • flex 레이아웃에서 자식이 콘텐츠로 늘어나는 문제는 min-width: auto 기본값 때문. 가로 스크롤 컨테이너를 만들 때는 그 위 flex 자식 체인 전체에 min-w-0이 필요하다.
  • CSS 레이아웃 문제는 추측으로 자식만 고치지 말고 실제 브라우저로 부모 체인의 scrollWidth를 측정해 어느 요소가 넘치는지 먼저 특정한다. (#440, #441 두 PR을 추측으로 소비한 뒤에야 #442에서 실측으로 한 번에 해결)

참고

  • 측정: Playwright getBoundingClientRect() / scrollWidth 부모 체인 순회

Clone this wiki locally