Skip to content

Conversation

@jk-kim0
Copy link
Contributor

@jk-kim0 jk-kim0 commented Dec 18, 2025

Description

문서 페이지의 테이블이 main element의 폭을 초과하여 오른쪽 일부가 가려지는 문제를 수정합니다.

문제 현상

  • main element의 폭(832px)보다 테이블의 실제 콘텐츠 폭(1557px, 920px)이 더 넓게 렌더링됨
  • thead의 첫 번째 행은 main element 폭에 맞게 그려지지만, tbody의 이후 행들은 더 넓게 그려짐
  • 테이블 오른쪽 일부가 가려져서 내용을 확인할 수 없음

해결 방안

  • globals.css에 테이블 스타일 규칙 추가: table을 display: block으로 설정하고 overflow-x: auto 적용
  • table-width-fix.tsx 컴포넌트 추가: thead의 열 너비를 계산하여 tbody의 모든 행에 동일하게 적용
  • layout.tsxTableWidthFix 컴포넌트 추가하여 모든 페이지에서 자동 실행

Additional notes

  • 총 3개 파일 변경 (165줄 추가, 1줄 삭제)
  • GFM 마크다운 테이블과 HTML 테이블 모두 지원
  • 윈도우 리사이즈 시에도 열 너비 동기화 유지

## Description

문서 페이지의 테이블이 main element의 폭을 초과하여 오른쪽 일부가 가려지는 문제를 수정합니다.

### 문제 현상
- main element의 폭(832px)보다 테이블의 실제 콘텐츠 폭(1557px, 920px)이 더 넓게 렌더링됨
- thead의 첫 번째 행은 main element 폭에 맞게 그려지지만, tbody의 이후 행들은 더 넓게 그려짐
- 테이블 오른쪽 일부가 가려져서 내용을 확인할 수 없음

### 해결 방안
- `globals.css`에 테이블 스타일 규칙 추가: table을 `display: block`으로 설정하고 `overflow-x: auto` 적용
- `table-width-fix.tsx` 컴포넌트 추가: thead의 열 너비를 계산하여 tbody의 모든 행에 동일하게 적용
- `layout.tsx`에 `TableWidthFix` 컴포넌트 추가하여 모든 페이지에서 자동 실행

## Additional notes
- 총 3개 파일 변경 (165줄 추가, 1줄 삭제)
- GFM 마크다운 테이블과 HTML 테이블 모두 지원
- 윈도우 리사이즈 시에도 열 너비 동기화 유지
@jk-kim0 jk-kim0 self-assigned this Dec 18, 2025
@vercel
Copy link

vercel bot commented Dec 18, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Review Updated (UTC)
querypie-docs Ready Ready Preview, Comment Dec 18, 2025 11:51am

@keIIy-kim
Copy link

문제가 되던 페이지의 주소는 어디인가용?

@jk-kim0
Copy link
Contributor Author

jk-kim0 commented Dec 18, 2025

@keIIy-kim 여기에 있습니다.
https://querypie-docs-git-jk-fix-css-for-table-querypie.vercel.app/ko/installation/container-environment-variables

@jk-kim0 jk-kim0 marked this pull request as draft December 18, 2025 15:15
@jk-kim0
Copy link
Contributor Author

jk-kim0 commented Dec 18, 2025

부작용이 좀 있네요. 일단.. 보류...?

https://querypie-docs-git-jk-fix-css-for-table-querypie.vercel.app/ko/user-manual

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants