마지막 업데이트 2026-11-18
PR #1334 (PPI-1467), 커밋 3개. 고객 LogRocket(iPad, iPadOS 27.2.1, iOS용 Chrome)에서 이름 입력칸에 포커스한 직후 키보드 때문에 레이아웃이 약 1180×190으로 줄었고, 입장 화면 본문이 0px로 접혀 입력칸과 입장 버튼이 사라졌습니다. 1차 커밋(27ca2d81)은 본문이 접히지 않게 하한을 두었고, 2차 커밋(2af57221)은 낮은 높이에서 헤더를 줄이고 포커스된 입력칸으로 자동 스크롤해 키보드가 뜬 직후 첫 화면에 입력칸이 보이게 했습니다. 3차 커밋(018f0fe8)은 자동 스크롤이 레이아웃 높이가 실제로 줄 때(window resize)만 동작하게 좁혀, 키보드가 화면을 덮기만 하는 환경에서는 기존 동작을 그대로 유지합니다. 리뷰할 때는 정상 높이 화면이 수정 전과 같은지와 자동 스크롤이 iOS 자체 키보드 스크롤과 부딪히지 않는지(실기기 미검증)를 먼저 보세요.
고객이 말한 "입력창 비활성화"는 실제 disabled 상태가 아니었습니다. 입력칸은 isSubmitting 등 입장 처리 중에만 비활성화되는데, 이 상태는 입장하기를 누른 뒤에만 생깁니다. 실제로는 입력칸이 화면에서 사라졌던 것입니다. 내려받은 JSON에는 화면 크기 기록이 없어, 높이 값은 리플레이 화면 비율로 추정했습니다.
2026-11-16 iPad에서 "이름·전화번호를 입력할 수 없었다"는 문의가 들어왔습니다. 로컬 재현 결과, GuestPreparationShell이 h-dvh overflow-hidden으로 화면 높이를 고정하고 본문을 min-h-0 flex-1로 두기 때문에, 낮은 화면에서는 본문이 0px로 줄어드는 것을 확인했습니다. 짧은 가로 화면용 압축 조건은 너비 900px 이하에만 적용돼 1180px 폭 iPad는 보호하지 못합니다.
main이 스크롤되어 본문을 보여줍니다.guest-entry), 대기실(waiting-room-view), 바로체험(trial-device-check), client-guest?mode=test.shell 안의 input/textarea에 포커스가 있을 때만 동작하고, requestAnimationFrame으로 한 프레임에 한 번만 실행합니다. 언마운트하면 리스너를 해제합니다.
visualViewport 리스너는 018f0fe8에서 뺐습니다. Safari처럼 키보드가 화면 위에 덮이기만 하는 경우에는 레이아웃이 그대로인데 visualViewport만 줄어듭니다. 이때도 반응하면 본문이 한 번 스크롤되어 수정 전과 달라질 수 있기 때문입니다. 고객 사례처럼 레이아웃 높이가 실제로 줄면 window resize가 발생하므로 효과는 그대로입니다.
바깥 wrapper의 min-h-0과 본문의 overflow-y-auto는 일부러 남겼습니다. 둘 중 하나를 빼면 측정에서 사이드 이펙트가 나왔습니다.
overflow-y-auto를 빼면: 모바일 가로(844×390)에 원래 없던 페이지 스크롤 73px이 생깁니다.| 뷰포트 | 수정 전 | 수정 후 |
|---|---|---|
| 1180×210 | 입력칸 2개·입장 버튼 모두 0/48px만 보임 (FAIL) | 세 요소 모두 도달 가능 |
| 1180×450, 844×200 | — | 세 요소 모두 도달 가능 |
| 1180×820, 1440×900, 820×1180, 844×390, 390×844 | 기준값 | 패널 위치·크기·스크롤 여부가 기준값과 같음 |
| 1180×820 이름 칸 포커스 → 1180×190 축소 (2차) | — | 스크롤하지 않은 상태에서 입력칸 48/48px이 보임(main 자동 스크롤 102px). 전화번호 칸으로 옮겨도 보임. 820으로 복구하면 원래 레이아웃 |
| 1180×450 (2차) | 본문 안에서 스크롤해야 입력칸이 보임 | 첫 화면에 입력칸이 보임 |
Trial Devices (trial.css 재정의) | 기준값 | 정상 크기에서 같음. 낮은 높이에서만 본문 132→280px |
관련 vitest 통과(훅 테스트 5개 포함, visualViewport만 변할 때 스크롤하지 않는지도 검증), Storybook 정적 빌드 성공, 훅 mutation 20/21 제거(남은 1개는 동작이 같은 등가 mutant). 측정에는 브라우저 zoom(90%)을 보정한 CSS 뷰포트를 썼고, 사용자가 스크롤할 수 없는 overflow-hidden 영역이 스크롤된 경우는 도달 불가로 판정했습니다.
| 레이어 | 파일 | 핵심 변경 |
|---|---|---|
| UI | apps/web/components/ui/guest-preparation-shell.tsx | main overflow-y-auto, 본문 min-h-[280px], 높이 500px 이하 헤더 압축, 훅 연결 |
| UI 훅 | apps/web/components/ui/use-keep-focused-field-visible.ts (+ test) | 포커스된 shell 입력칸을 window resize 때 가운데로 스크롤 (visualViewport만 변하면 반응하지 않음) |
| Storybook | apps/web/components/ui/guest-preparation-shell.stories.tsx | LowHeightLandscape(1180×210) story 추가. 높이를 되돌린 상태는 TabletLandscape로 검토 |
고객과 같은 1180×820급 iPad와 iOS용 Chrome에서 TC1~TC4를 확인해야 합니다. 특히 scrollIntoView가 iOS 자체의 키보드 스크롤과 부딪혀 화면이 튀지 않는지 봐야 합니다. 레이아웃이 줄지 않는 환경(Safari 등)에서는 자동 스크롤이 동작하지 않으므로 기존 동작과 같아야 합니다. 화면이 큰 iPad Pro나 Safari에서는 레이아웃이 줄지 않거나 덜 줄어 재현되지 않을 수 있습니다(재현 여부는 키보드를 띄운 뒤 innerHeight가 약 207px 이하인지로 갈림).
화면이 헤더+280px보다 낮으면 main 스크롤과 본문 스크롤이 겹칩니다. iPad 터치에서 스크롤이 자연스럽게 이어지는지 확인이 필요합니다.
아주 낮은 화면에서는 main의 하단 padding(20~28px)이 넘친 본문 뒤에 붙지 않습니다. 보기에만 영향이 있습니다.
Shell을 쓰는 입장·대기실·바로체험·client-guest 테스트 모드가 모두 영향을 받습니다. 정상 높이에서는 측정값이 수정 전과 같아 사이드 이펙트가 없습니다. 바로체험은 trial.css가 헤더 스타일을 덮어써 헤더 압축이 적용되지 않습니다(코드 판단, 미측정).
관련 문서: iPad 입장 입력 지연과 화면 잘림 조사 — 이 PR의 원인 조사와 로컬 재현(R1~R3) 증거