From 6cc191f29929c0af9b7de9210c4c1c0aa5f8b4db Mon Sep 17 00:00:00 2001
From: gain <163835628+leegain1@users.noreply.github.com>
Date: Mon, 16 Nov 2026 18:14:40 +0900
Subject: [PATCH 1/3] =?UTF-8?q?feat:=20=ED=99=88=20=EB=A1=9C=EA=B3=A0?=
=?UTF-8?q?=EB=A5=BC=20=EB=88=84=EB=A5=B4=EA=B1=B0=EB=82=98=20=EB=A7=A8=20?=
=?UTF-8?q?=EC=9C=84=EC=97=90=EC=84=9C=20=EB=8B=B9=EA=B8=B0=EB=A9=B4=20?=
=?UTF-8?q?=ED=99=88=20=EC=83=88=EB=A1=9C=EA=B3=A0=EC=B9=A8?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
src/features/home/HomeScreen.tsx | 24 ++-
.../home/hooks/useHomePullToRefresh.ts | 153 ++++++++++++++++++
src/shared/entities/home/homeQueries.ts | 15 +-
3 files changed, 188 insertions(+), 4 deletions(-)
create mode 100644 src/features/home/hooks/useHomePullToRefresh.ts
diff --git a/src/features/home/HomeScreen.tsx b/src/features/home/HomeScreen.tsx
index 90e7f5ca..84a72f69 100644
--- a/src/features/home/HomeScreen.tsx
+++ b/src/features/home/HomeScreen.tsx
@@ -1,4 +1,4 @@
-import { PushBadge, TopNavigationButton } from "@wanteddev/wds";
+import { Loading, PushBadge, TopNavigationButton } from "@wanteddev/wds";
import { IconBell, IconSearch, IconSetting } from "@wanteddev/wds-icon";
import { Suspense, useState } from "react";
import { useNavigate } from "react-router-dom";
@@ -25,11 +25,13 @@ import HomeNoticeBannerSkeleton from "@/features/home/components/HomeNoticeBanne
import HomeRentalSection from "@/features/home/components/HomeRentalSection";
import HomeRentalSkeleton from "@/features/home/components/HomeRentalSkeleton";
import { HOME_HAS_UNREAD_NOTIFICATION } from "@/features/home/constants/homeMock";
+import { useHomePullToRefresh } from "@/features/home/hooks/useHomePullToRefresh";
import { LOCKER_ASSIGNMENT_PATH } from "@/features/lockers/constants/lockers";
import { NOTIFICATIONS_PATH } from "@/features/notifications/constants/notifications";
import { getSearchPath } from "@/features/search/constants/search";
import { SETTINGS_PATHS } from "@/features/settings/constants/settings";
import { openExternalLink } from "@/lib/openExternalLink";
+import { useRefreshHomeQueries } from "@/shared/entities/home/homeQueries";
import type {
HomeApplySection,
HomeBanner,
@@ -45,6 +47,10 @@ function HomeScreen() {
const navigate = useNavigate();
const [isScrolled, setIsScrolled] = useState(false);
+ // 로고를 누르거나 맨 위에서 당기면 맨 위로 올리고 홈 데이터를 다시 받는다
+ const refreshHomeQueries = useRefreshHomeQueries();
+ const { indicatorRef, isRefreshing, refresh, scrollRef } =
+ useHomePullToRefresh(refreshHomeQueries);
// 상세·신청·내 내역처럼 화면을 쌓는 이동은 슬라이드로, 하단 탭 화면(빌릴게·행사와 그 탭)으로는 바로 바꾼다
const push = (to: string) => navigate(to, { viewTransition: true });
@@ -72,10 +78,20 @@ function HomeScreen() {
return (
+ {/* 새로고침 로딩 표시 — 당기거나 새로고침하는 동안 스크롤 영역이 내려간 만큼 위에 펼쳐진다(useHomePullToRefresh) */}
+
+ {/* WDS Loading은 size를 단위 없이 CSS에 넣어서 숫자(24)를 주면 크기가 0이 된다 — 단위를 붙인다 */}
+
+
{/* 스크롤 영역 자체를 flex로 두면 내용이 길 때 섹션이 줄어들어서(배너 가로 스크롤 영역은 최소 높이가 0) 안쪽에서 쌓는다 */}
setIsScrolled(event.currentTarget.scrollTop > 0)}
+ ref={scrollRef}
>
{/* Figma: Top Navigation State=Home (nodeId 547:31364), 알림 있을 때 (3147:146473)
홈만 헤더를 스크롤 영역 안에 둔다. Figma는 헤더 배경이 없어 배너 그림자가 헤더까지 번지는데,
@@ -87,7 +103,9 @@ function HomeScreen() {
-
+
}
trailing={
diff --git a/src/features/home/hooks/useHomePullToRefresh.ts b/src/features/home/hooks/useHomePullToRefresh.ts
new file mode 100644
index 00000000..e9fbf3bd
--- /dev/null
+++ b/src/features/home/hooks/useHomePullToRefresh.ts
@@ -0,0 +1,153 @@
+import {
+ useCallback,
+ useEffect,
+ useLayoutEffect,
+ useRef,
+ useState,
+} from "react";
+
+// 당긴 거리의 절반만 따라 내려온다 — 손가락을 그대로 따라오면 살짝 끌어도 새로고침된다
+const PULL_RESISTANCE = 0.5;
+// 내용이 이만큼 내려온 채로 놓으면 새로고침한다. 새로고침하는 동안 로딩 표시가 이 높이로 떠 있다
+const REFRESH_OFFSET = 56;
+const MAX_PULL_OFFSET = 96;
+// 손가락이 이만큼 움직이기 전에는 방향을 정하지 않는다 — 배너를 가로로 넘기는 손짓과 섞이지 않게 한다
+const DIRECTION_LOCK_DISTANCE = 6;
+const SETTLE_TRANSITION = "transform 200ms ease-out, height 200ms ease-out";
+
+// 로딩 표시 높이와 스크롤 영역이 내려온 거리를 같이 맞춘다. 0이면 transform을 지워서 흔적을 남기지 않는다
+function applyOffset(
+ scroller: HTMLElement | null,
+ indicator: HTMLElement | null,
+ offset: number,
+ animate: boolean,
+) {
+ for (const element of [scroller, indicator]) {
+ if (element) {
+ element.style.transition = animate ? SETTLE_TRANSITION : "";
+ }
+ }
+ if (scroller) {
+ scroller.style.transform = offset > 0 ? `translateY(${offset}px)` : "";
+ }
+ if (indicator) {
+ indicator.style.height = `${offset}px`;
+ }
+}
+
+// 홈 맨 위에서 아래로 당겼다 놓으면 onRefresh를 부른다(당겨서 새로고침). 로고를 눌렀을 때 쓰는 refresh도 같이 준다 —
+// 맨 위로 올리고 같은 로딩 표시를 띄운 채 onRefresh가 끝나기를 기다린다.
+// 스크롤 영역(헤더 포함)이 통째로 내려오고, 그 위로 드러나는 자리에 로딩 표시(indicatorRef)가 펼쳐진다.
+// 당기는 동안은 리렌더 없이 DOM에 바로 적용하고(useLockersPinchZoom과 같은 방식), 새로고침 중인지만 상태로 둔다.
+// 당기는 손짓은 touchmove를 preventDefault해서 브라우저 바운스로 넘기지 않는다 — React의 touch 핸들러는 passive라
+// 막을 수 없어서 리스너를 직접 단다. Android Chrome의 당겨서 새로고침은 스크롤 영역의 overscroll-behavior로 막는다.
+export function useHomePullToRefresh(onRefresh: () => Promise) {
+ const scrollRef = useRef(null);
+ const indicatorRef = useRef(null);
+ const [isRefreshing, setIsRefreshing] = useState(false);
+ const isRefreshingRef = useRef(false);
+ const onRefreshRef = useRef(onRefresh);
+
+ useLayoutEffect(() => {
+ onRefreshRef.current = onRefresh;
+ }, [onRefresh]);
+
+ const refresh = useCallback(async () => {
+ if (isRefreshingRef.current) {
+ return;
+ }
+ isRefreshingRef.current = true;
+ setIsRefreshing(true);
+ scrollRef.current?.scrollTo({ top: 0 });
+ applyOffset(scrollRef.current, indicatorRef.current, REFRESH_OFFSET, true);
+ try {
+ await onRefreshRef.current();
+ } finally {
+ isRefreshingRef.current = false;
+ setIsRefreshing(false);
+ applyOffset(scrollRef.current, indicatorRef.current, 0, true);
+ }
+ }, []);
+
+ useEffect(() => {
+ const scroller = scrollRef.current;
+ if (!scroller) {
+ return;
+ }
+
+ let gesture: {
+ startX: number;
+ startY: number;
+ isPulling: boolean;
+ } | null = null;
+ let offset = 0;
+
+ const handleTouchStart = (event: TouchEvent) => {
+ // 맨 위가 아니거나 이미 새로고침 중이면 평소 스크롤로 둔다
+ if (
+ isRefreshingRef.current ||
+ scroller.scrollTop > 0 ||
+ event.touches.length !== 1
+ ) {
+ gesture = null;
+ return;
+ }
+ gesture = {
+ isPulling: false,
+ startX: event.touches[0].clientX,
+ startY: event.touches[0].clientY,
+ };
+ offset = 0;
+ };
+
+ const handleTouchMove = (event: TouchEvent) => {
+ if (!gesture) {
+ return;
+ }
+ const dx = event.touches[0].clientX - gesture.startX;
+ const dy = event.touches[0].clientY - gesture.startY;
+ if (!gesture.isPulling) {
+ if (Math.hypot(dx, dy) < DIRECTION_LOCK_DISTANCE) {
+ return;
+ }
+ // 가로로 넘기거나 위로 밀면(아래 내용 보기) 당기기가 아니다
+ if (Math.abs(dx) > Math.abs(dy) || dy < 0) {
+ gesture = null;
+ return;
+ }
+ gesture.isPulling = true;
+ }
+ event.preventDefault();
+ offset = Math.min(Math.max(dy, 0) * PULL_RESISTANCE, MAX_PULL_OFFSET);
+ applyOffset(scroller, indicatorRef.current, offset, false);
+ };
+
+ const handleTouchEnd = () => {
+ const wasPulling = gesture?.isPulling === true;
+ gesture = null;
+ if (!wasPulling) {
+ return;
+ }
+ if (offset >= REFRESH_OFFSET) {
+ void refresh();
+ } else {
+ applyOffset(scroller, indicatorRef.current, 0, true);
+ }
+ };
+
+ scroller.addEventListener("touchstart", handleTouchStart, {
+ passive: true,
+ });
+ scroller.addEventListener("touchmove", handleTouchMove, { passive: false });
+ scroller.addEventListener("touchend", handleTouchEnd);
+ scroller.addEventListener("touchcancel", handleTouchEnd);
+ return () => {
+ scroller.removeEventListener("touchstart", handleTouchStart);
+ scroller.removeEventListener("touchmove", handleTouchMove);
+ scroller.removeEventListener("touchend", handleTouchEnd);
+ scroller.removeEventListener("touchcancel", handleTouchEnd);
+ };
+ }, [refresh]);
+
+ return { indicatorRef, isRefreshing, refresh, scrollRef };
+}
diff --git a/src/shared/entities/home/homeQueries.ts b/src/shared/entities/home/homeQueries.ts
index b4a2574d..2eeb7c6c 100644
--- a/src/shared/entities/home/homeQueries.ts
+++ b/src/shared/entities/home/homeQueries.ts
@@ -1,7 +1,8 @@
-import { queryOptions } from "@tanstack/react-query";
+import { queryOptions, useQueryClient } from "@tanstack/react-query";
import { z } from "zod";
import { api } from "@/shared/api";
+import { billilgeKeys } from "@/shared/entities/billilge/billilgeKeys";
import { FEE_STATUSES } from "@/shared/entities/fee/feeQueries";
import { homeKeys } from "@/shared/entities/home/homeKeys";
@@ -87,3 +88,15 @@ export const homeQueries = {
),
}),
};
+
+// 홈 새로고침(로고·당겨서 새로고침) — 홈 조회와, 대여 현황이 쓰는 빌릴게 대여 이력(반납 필요·대여 내역) 조회를 다시 받는다.
+// 페이지를 새로고침한 것처럼 보이게 받아 둔 데이터를 비우고(resetQueries) 받는다 — 받는 동안 섹션마다 스켈레톤이 보인다.
+// 다 받은 뒤에 끝나는 Promise를 돌려준다.
+export function useRefreshHomeQueries() {
+ const queryClient = useQueryClient();
+ return () =>
+ Promise.all([
+ queryClient.resetQueries({ queryKey: homeKeys.root() }),
+ queryClient.resetQueries({ queryKey: billilgeKeys.histories() }),
+ ]);
+}
From 227222eb2f86a0c7188cfda10886491c0f70ca80 Mon Sep 17 00:00:00 2001
From: gain <163835628+leegain1@users.noreply.github.com>
Date: Mon, 16 Nov 2026 18:14:40 +0900
Subject: [PATCH 2/3] =?UTF-8?q?fix:=20=EA=B3=B5=EC=A7=80=C2=B7=EC=97=B4?=
=?UTF-8?q?=EB=A6=B0=ED=94=BC=EB=93=9C=EB=B0=B1=20=EB=AA=A9=EB=A1=9D=20?=
=?UTF-8?q?=EA=B0=84=EA=B2=A9=EC=9D=84=2012=EB=A1=9C=20=EC=A4=84=EC=9E=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
src/features/feedbacks/components/FeedbacksAllSection.tsx | 3 ++-
src/features/notices/components/NoticesList.tsx | 5 +++--
2 files changed, 5 insertions(+), 3 deletions(-)
diff --git a/src/features/feedbacks/components/FeedbacksAllSection.tsx b/src/features/feedbacks/components/FeedbacksAllSection.tsx
index 2c6c22a6..e65b5cc3 100644
--- a/src/features/feedbacks/components/FeedbacksAllSection.tsx
+++ b/src/features/feedbacks/components/FeedbacksAllSection.tsx
@@ -30,8 +30,9 @@ function FeedbacksAllSection() {
});
};
+ // 필터와 목록 사이 — 공지 목록 위 여백과 같은 12다
return (
-
+
-
+
+
{notices.map((notice, index) => (
{index > 0 && (
From ad241a1e08778102dd4cf46b83a44798bf2a4180 Mon Sep 17 00:00:00 2001
From: gain <163835628+leegain1@users.noreply.github.com>
Date: Mon, 16 Nov 2026 18:14:41 +0900
Subject: [PATCH 3/3] =?UTF-8?q?fix:=20=EC=8D=B8=EB=84=A4=EC=9D=BC=20?=
=?UTF-8?q?=EC=9E=88=EB=8A=94=20=EA=B3=B5=EC=A7=80=20=EC=A0=9C=EB=AA=A9?=
=?UTF-8?q?=EC=9D=84=20=EC=8D=B8=EB=84=A4=EC=9D=BC=20=EC=95=9E=EC=97=90?=
=?UTF-8?q?=EC=84=9C=20=EB=A7=90=EC=A4=84=EC=9E=84?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
src/features/notices/components/NoticesCard.tsx | 6 ++++--
1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/src/features/notices/components/NoticesCard.tsx b/src/features/notices/components/NoticesCard.tsx
index 85e01f66..0f99eaf0 100644
--- a/src/features/notices/components/NoticesCard.tsx
+++ b/src/features/notices/components/NoticesCard.tsx
@@ -26,11 +26,13 @@ function NoticesCard({
hasThumbnail = false,
thumbnailUrl,
}: NoticesCardProps) {
+ // 썸네일이 있으면 제목이 한 줄(noWrap)이라, 글 칸이 제목 길이만큼 버티지 않게 min-w-0으로 줄여서 썸네일 앞에서
+ // 말줄임되게 한다. Figma는 제목이 짧아 제목·썸네일 사이 간격이 없는데, 말줄임표가 썸네일에 붙지 않게 12를 둔다.
return (
-
+
{/* 고정 공지의 핀은 썸네일 유무와 상관없이 제목 앞에 붙는다. 썸네일이 없으면 제목이 여러 줄로 이어진다 */}
{isPinned &&

}