Skip to content

[Fix/#227] 홈 로고·당겨서 새로고침과 게시판 목록 간격 정리 - #228

Merged
leegain1 merged 3 commits into
mainfrom
fix/#227-home-refresh-board-spacing
Nov 16, 2026
Merged

leegain1 merged 3 commits into
mainfrom
fix/#227-home-refresh-board-spacing

Conversation

@leegain1

Copy link
Copy Markdown
Collaborator

#️⃣연관된 이슈

🎯 해결하려는 문제가 무엇인가요?

  • 홈 로고(stream)를 눌러도 아무 반응이 없었습니다.
  • 공지·열린피드백 목록 간격이 넓어 보였습니다(공지 카드 사이·목록 위아래 16, 열린피드백 필터와 목록 사이 16).
  • 썸네일 있는 공지의 긴 제목이 썸네일 앞에서 줄지 않고 썸네일 쪽으로 밀렸습니다.

❓ 왜 해결해야 하나요?

홈은 대여·신청 현황을 확인하는 화면이라, 앱을 껐다 켜지 않고도 최신 상태로 다시 받을 방법이 필요합니다. 로고·당겨서 새로고침은 사용자가 흔히 기대하는 동작입니다. 목록 간격과 말줄임은 QA에서 지적된 부분입니다.

⭐ 어떻게 해결했나요?

  • 홈 새로고침 (6cc191f)
    • 로고를 누르면 바로 맨 위로 올라가고, 맨 위에서 아래로 당겼다 놓아도(56px 이상) 같은 새로고침을 합니다.
    • 새로고침은 홈 조회와 대여 현황이 쓰는 빌릴게 대여 이력 조회를 비우고 다시 받습니다(resetQueries). 새로고침한 것처럼 보이게 받는 동안 섹션마다 스켈레톤이 뜹니다. 화면이 캐시 key를 모르게 homeQueries.ts에 useRefreshHomeQueries로 두었습니다.
    • 당기는 손짓은 features/home/hooks/useHomePullToRefresh.ts에서 처리합니다.
      • 당기는 동안은 리렌더 없이 DOM에 바로 적용합니다(useLockersPinchZoom과 같은 방식). 스크롤 영역(헤더 포함)이 내려오고, 위에 드러나는 자리에 WDS Loading이 펼쳐집니다.
      • React의 touch 핸들러는 passive라 브라우저 바운스를 막을 수 없어서 touchmove 리스너를 { passive: false }로 직접 답니다. 스크롤 영역에 overscroll-y-contain을 줘서 Android Chrome의 당겨서 새로고침과 겹치지 않게 했습니다.
      • 처음 6px 움직임으로 방향을 정해서, 배너를 가로로 넘기거나 위로 스크롤하는 손짓은 새로고침으로 잡지 않습니다.
  • 목록 간격 (227222e): 공지 목록 카드 사이·위아래 여백, 열린피드백 필터와 목록 사이를 16 → 12로 줄였습니다.
  • 말줄임 (ad241a1): 공지 카드 글 칸에 min-w-0을 줘서 썸네일 앞에서 제목이 말줄임되게 했고, 제목·썸네일 사이에 12 간격을 뒀습니다(Figma는 제목이 짧아 간격이 없습니다).

🧩 이 PR의 한계 & 트레이드오프

  • 당겨서 새로고침은 터치에만 반응합니다. PC에서 마우스로 끌어서는 동작하지 않습니다(PC는 로고로 새로고침).
  • 로고 새로고침은 브라우저 새로고침(F5)이 아니라 홈 데이터만 비우고 다시 받습니다. 앱 전체를 다시 불러오지 않아 흰 화면 깜빡임이 없습니다.
  • 데이터를 비우고 받으므로, 새로고침하면 빌릴게 반납 탭의 대여 이력 캐시도 같이 비워졌다가 다시 받아집니다.

⛓️ 기존 기능에 미치는 영향

  • 홈 스크롤 영역에 overscroll-y-contain이 붙어 스크롤 끝에서 바깥으로 스크롤이 이어지지 않습니다(바깥은 스크롤되지 않는 레이아웃이라 보이는 차이는 없습니다).
  • 공지 카드 간격 변경은 공지 목록에만, 필터 아래 간격은 열린피드백 "전체 피드백"에만 영향을 줍니다.

🔀 Edge Case & 실패 시나리오

  • 새로고침 중에 다시 당기거나 로고를 눌러도 한 번만 받습니다.
  • 다시 받기에 실패하면 각 섹션의 오류 처리를 그대로 따릅니다.

📋 검토한 대안과 선택 이유

  • 데이터를 화면에 둔 채 조용히 다시 받기(invalidateQueries): 새로고침된 티가 나지 않아서, 스켈레톤이 보이도록 비우고 받는 방식으로 바꿨습니다.
  • 브라우저 새로고침(location.reload): 앱 전체를 다시 불러와 흰 화면이 깜빡여서 쓰지 않았습니다.
  • 헤더·본문을 감싸는 div를 새로 두고 그것만 내리기: 홈 화면 대부분의 들여쓰기가 바뀌어서, 스크롤 영역 자체를 내리는 방식으로 했습니다.

💬 리뷰 포인트

  • [c] 타입 검사(tsc -b)와 Biome 검사를 통과했습니다. 헤드리스 Chromium(모바일·터치 흉내, API는 1초 지연 가짜 응답)에서 당기기·로고 새로고침 때 스피너와 스켈레톤이 뜨고 세 조회를 다시 받는 것을 확인했습니다. 실제 기기(iOS WebView)에서의 손맛은 한 번 봐 주세요.
  • WDS Loading은 size를 단위 없이 CSS에 넣어서 숫자를 주면 크기가 0이 됩니다. "24px"처럼 단위를 붙여야 합니다.

@leegain1 leegain1 self-assigned this Nov 16, 2026
@coderabbitai

coderabbitai Bot commented Nov 16, 2026

Copy link
Copy Markdown

Important

  • Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 34e5c102-2203-4bf0-b480-27a3051b6acf
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@leegain1
leegain1 merged commit 828da92 into main Nov 16, 2026
2 checks passed
@leegain1
leegain1 deleted the fix/#227-home-refresh-board-spacing branch November 16, 2026 09:20
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.

1 participant