Skip to content

[Fix/#231] iPhone에서 사물함 미니맵이 막대로 줄어드는 문제 - #232

Merged
sangrae2325 merged 1 commit into
mainfrom
fix/#231-lockers-minimap-webkit
Nov 18, 2026
Merged

sangrae2325 merged 1 commit into
mainfrom
fix/#231-lockers-minimap-webkit

Conversation

@sangrae2325

Copy link
Copy Markdown
Collaborator

#️⃣연관된 이슈

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

iPhone(Safari·WebView)에서 사물함 칸 선택·내 사물함 화면의 미니맵이 폭 16px 세로 막대로 줄어들어 보이지 않았다.

  • 미니맵은 본문 칸 배치를 CSS zoom으로 줄여 그리고, 미니맵 영역 크기가 바뀔 때마다 getBoundingClientRect().height / 지금 배율로 원래 높이를 다시 쟀다
  • WebKit은 zoom이 걸린 요소의 크기를 크롬과 다르게 돌려주고, rem 크기(Tailwind 간격·크기는 calc(0.25rem * N))에는 zoom을 적용하지 않는다
  • 그래서 다시 잴 때마다 배율이 이전보다 작아져(0.53 → 0.29 → 0.00007 → 0) 상자 여백만 남았다. 실제 기기에서는 처음 그려지는 동안의 크기 변화 몇 번만으로 사라진다

❓ 왜 해결해야 하나요?

학생 대부분이 iPhone 앱(WebView)으로 사물함을 신청한다. 미니맵이 없으면 큰 구역에서 지금 어디를 보고 있는지 알 수 없고, 미니맵으로 이동하지도 못한다.

⭐ 어떻게 해결했나요?

  • 미니맵 축소를 zoom 대신 transform: scale()(기준점 왼쪽 위)로 한다. 미니맵은 스크롤이 없는 고정 상자라 transform으로 충분하고, 단위와 상관없이 모든 브라우저에서 같게 줄어든다
  • 배치 높이는 transform 배율과 상관없는 offsetHeight로 잰다 — 다시 재도 값이 같아 줄어드는 게 쌓이지 않는다

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

  • 본문 두 손가락 확대(useLockersPinchZoom)도 zoom을 써서 iPhone에서 rem 크기 칸이 제대로 안 커질 수 있다. 스크롤 영역 크기가 같이 바뀌어야 해서 transform으로 바로 바꿀 수 없어 이번 범위에서 뺐다
  • 처음 열 때 본문 가로 위치가 WebKit은 왼쪽 끝, 크롬은 가운데다(확대 훅의 처음 가운데 맞춤). 미니맵 테두리는 두 경우 모두 실제 위치와 맞고, 이 PR에서 바뀐 건 아니다
  • 실제 iPhone 기기 확인은 못 했다(Playwright WebKit 26으로 확인)

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

  • LockersMinimap만 바뀐다. 칸 선택·내 사물함 화면 미니맵의 크기 계산, 테두리 위치, 누르기·끌기 이동은 그대로다

🔀 Edge Case & 실패 시나리오

Playwright WebKit·Chromium, 375·393px, 응답 가로채기로 확인했다.

  • 배치 3종: 가로로 긴 배치(4×14), 세로로도 긴 배치(14×14), 작은 배치(6칸+계단, 스크롤 없음)
  • 모든 칸이 미니맵 상자 안에 들어오는지, 스크롤 없을 때 테두리를 숨기는지
  • 본문을 끝·처음으로 스크롤할 때 테두리가 상자 끝에 붙는지
  • 미니맵 끝을 누르면 본문이 끝까지, 끌어서 가운데에 놓으면 테두리 가운데가 손가락 위치(±1px)에 오는지
  • 화면 폭을 여러 번 바꿔도 배율이 그대로인지(고치기 전 WebKit은 두 번 만에 0)

📋 검토한 대안과 선택 이유

  • zoom을 두고 높이 재는 방법만 바꾸기 — WebKit이 rem 크기에 zoom을 적용하지 않아 칸이 줄지 않고 상자 밖으로 잘리는 문제가 남는다
  • 미니맵을 칸·글자 크기를 따로 정한 별도 배치로 그리기(Figma 방식) — 배치를 두 벌 관리해야 하고 4px 글자가 브라우저 최소 글자 크기에 걸린다

💬 리뷰 포인트

  • [c] 실제 iPhone(특히 미니)에서 미니맵이 보이는지 한 번 확인 부탁

@coderabbitai

coderabbitai Bot commented Nov 17, 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: a2291f7d-c623-49fb-b567-7efb9266d630
  • 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

@sangrae2325
sangrae2325 merged commit dcf3108 into main Nov 18, 2026
2 checks passed
@sangrae2325
sangrae2325 deleted the fix/#231-lockers-minimap-webkit branch November 18, 2026 14:39
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.

iPhone에서 사물함 미니맵이 막대로 줄어드는 문제

1 participant