앱개발
2026.09.16 · 2분
아이용 공룡 퀴즈 게임 공룡 척척박사를 만들고 태블릿에 올려 줬더니 아이의 불만이 들려왔다. 두 손으로 잡으면 화면이 확대된다. 아이가 문제를 풀다 말고 화면을 키워 놓고는 되돌리지 못한다.
코드를 열어 보니 막는 설정은 이미 있었다.
// app/layout.tsx
export const viewport = {
maximumScale: 1,
userScalable: false,
}
그 전부터 있었다. 그런데 안 막힌다.
찾아보니 버그가 아니었다.
iOS Safari 는 10 버전부터 이 값을 접근성 이유로 의도적으로 무시한다. 눈이 불편한 사용자가 확대할 수 없게 만드는 것을 브라우저가 막는 것이다. 취지는 옳다.
안드로이드 크롬도 마찬가지다. 접근성 설정에 "강제로 확대 사용" 이 있고 켜져 있으면 페이지 설정을 무시한다.
즉 이 메타 태그는 지키는 브라우저에서만 지켜진다. 요청이지 명령이 아니다.
아이용 앱이라 이건 넘어갈 수 없었다. 확대되면 게임 판이 화면 밖으로 나가고 아이는 되돌리는 법을 모른다. 그래서 세 겹으로 막았다.
그대로 둔다. 무시하는 브라우저가 있을 뿐, 지키는 브라우저도 있다.
touch-actionhtml {
touch-action: pan-x pan-y;
}
여기서 한 번 틀렸다. 처음에 manipulation 을 썼는데 핀치를 못 막는다.
manipulation 이 막는 건 더블탭 확대뿐이고 핀치는 허용한다. 스크롤은 살리고 확대만
막으려면 pan-x pan-y 로 허용할 제스처를 직접 적어야 한다.
그래도 새는 경로가 남아서 가드를 하나 뒀다. 손가락이 둘 이상인 touchmove 와, Safari
전용 제스처 이벤트를 취소한다.
el.addEventListener('touchmove', (e) => {
if (e.touches.length > 1) e.preventDefault()
}, { passive: false })
// Safari 전용
el.addEventListener('gesturestart', (e) => e.preventDefault())
el.addEventListener('gesturechange', (e) => e.preventDefault())
{ passive: false } 가 핵심이다. 크롬은 touchmove 리스너를 기본 passive 로
잡고 passive 리스너의 preventDefault() 는 조용히 무시된다. 에러도 경고도 없다.
이걸 빼면 코드는 멀쩡해 보이는데 아무것도 안 막힌다.
고쳤으니 재봐야 하는데, 여기서 한 번 더 속았다.
헤드리스 크롬으로 핀치를 흉내 내는 명령이 있다. 그걸로 재보니 확대가 안 됐고 "막혔다" 는 결론을 얻었다. 틀린 결론이었다.
그 명령은 제스처 소스를 명시하지 않으면 ctrl + 휠로 대체된다. 터치 경로를 아예 타지 않으니 우리가 건 방어가 도는지 마는지와 무관하게 확대가 안 된다. 막았든 안 막았든 같은 결과가 나오는 검사였다.
한 손가락 스크롤이 여전히 되는지도 재야 했는데, 스크롤 흉내 명령은 터치 소스로는 이 환경에서 아예 동작하지 않았다 — 막지 않은 대조군도 0px 였다. 대조군을 안 뒀으면 "스크롤까지 막혔다" 는 또 다른 틀린 결론을 얻을 뻔했다.
결국 터치 이벤트를 직접 만들어 보내고 defaultPrevented 가 무엇인지 읽는 쪽으로
바꿨다. 확대되는지를 재는 대신 우리 핸들러가 이벤트를 취소했는지를 본다.
세 가지를 배웠다.
passive 기본값이 방어를 조용히 무력화한다. preventDefault() 를 썼는데 아무
일도 안 일어나면 여기부터 본다.세 번째가 제일 크다. 이 프로젝트에서 측정을 잘못해 틀린 결론을 낸 게 이번이 처음이 아니었다. 다음에 그 이야기를 쓰겠다 — 60fps 로도 1fps 로도 측정되던 애니메이션 이야기다.
이 글은 AI 가 조사·초안을 작성하고 사람이 검수한 뒤 발행했습니다.