fix(presentation): 검색값만 바뀌면 포커스·스크롤·진단을 건드리지 않는다 (08-02)
문제: RouteLifecycle이 pathname·search·navigationType을 effect 의존값으로 썼다. 그래서 URL에 묶은 필터를 바꾸면 포커스가 컨트롤에서 <main>으로 튀고, POP이 아니면 맨 위로 스크롤하고, route.changed를 한 번 더 남겼다. 이미 보고 있는 화면의 링크를 눌러도(React Router가 REPLACE로 바꿈) navigationType만 바뀌어 같은 일이 났다. 템플릿은 필터를 URL에 두라고 권하므로 첫 목록 화면에서 바로 드러난다(WCAG 3.2.2). 고른 방법: 이동 판단을 route ID 또는 pathname 변경으로 좁혔다(리뷰 5.1 (B)). 포커스·스크롤·진단은 useEffectEvent로 옮겨 navigationType을 읽기만 하고 트리거로 쓰지 않는다. 검색값 변경에 맨 위가 필요한 화면(페이지 번호)은 그 화면이 직접 스크롤한다. routing 문서 6.3절에 규칙을 적었다. 버린 대안: (C) 라우트 계약에 searchChangeIsNavigation 선언 — 그런 라우트가 템플릿에 없고 생성기·문서까지 바뀐다. 필요해지면 (B) 위에 더할 수 있다. navigationType을 ref로 들고 있기 — 렌더 중 ref 쓰기라 React 19의 useEffectEvent보다 의도가 덜 드러난다. 위험·한계: 지금 검색값 변경을 이동으로 세던 대시보드가 있다면 수치가 준다. 실제 브라우저의 스크롤 유지는 jsdom이 스크롤을 건너뛰어 정적 확인만 했다. 테스트용 fixture 페이지에 URL에 묶은 select를 더했다. 검증: - RED: router.test.tsx 새 테스트 2건이 수정 전 실패. 포커스가 <main id="main-content">에 있었고 route.changed가 필터 테스트 1→3, 링크 테스트 1→2로 늘었다. - GREEN: router.test.tsx 11/11, tests/component 34 files 213 tests 통과. tsc(app, test) 통과, eslint(바꾼 파일) 통과, verify-documentation-readiness PASS_SCOPED. - check:architecture는 pnpm 실행을 요구해 이 worktree에서 미실행. Refs: docs/reviews/2026-11-01-maturity-review/08-presentation.md 08-02
This commit is contained in:
@@ -3,6 +3,7 @@ import {
|
||||
type ReactNode,
|
||||
Suspense,
|
||||
useEffect,
|
||||
useEffectEvent,
|
||||
useRef,
|
||||
useState,
|
||||
} from "react";
|
||||
@@ -169,7 +170,7 @@ function RouteLifecycle({
|
||||
definition: RouteDefinition;
|
||||
buildId: string;
|
||||
}) {
|
||||
const { pathname, search } = useLocation();
|
||||
const { pathname } = useLocation();
|
||||
const navigationType = useNavigationType();
|
||||
const { message, resolve } = useLocale();
|
||||
const diagnostics = useApplicationDiagnostics();
|
||||
@@ -180,7 +181,7 @@ function RouteLifecycle({
|
||||
appName: message("common.appName"),
|
||||
});
|
||||
}, [definition, message, resolve]);
|
||||
useEffect(() => {
|
||||
const announceRoute = useEffectEvent(() => {
|
||||
const main = document.getElementById("main-content");
|
||||
main?.focus({ preventScroll: true });
|
||||
try {
|
||||
@@ -199,7 +200,15 @@ function RouteLifecycle({
|
||||
routeId: definition.routeId,
|
||||
buildId,
|
||||
});
|
||||
}, [buildId, definition, diagnostics, navigationType, pathname, search]);
|
||||
});
|
||||
// 08-02. Only a new route or path is a navigation. A query-only change
|
||||
// (a filter bound to the URL) or a link to the current URL is input on the
|
||||
// same screen: focus stays on the control, the scroll stays, and no
|
||||
// route.changed is reported. A screen that wants the top on a query change
|
||||
// (a page number) scrolls itself.
|
||||
useEffect(() => {
|
||||
announceRoute();
|
||||
}, [definition.routeId, pathname]);
|
||||
return null;
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user