구형 Android WebView에서 fixed CTA가 오른쪽으로 쏠리는 이유
left: 50% + translateX(-50%) 중앙 정렬이 Android 12 WebView에서 어긋나는 원인과, inset·margin·visualViewport 보정으로 고친 패턴을 정리했습니다.
갤럭시 노트10+(Android 12)의 골디 앱 WebView에서만 하단 CTA가 오른쪽으로 밀려 보였습니다. iOS Safari와 Chrome Android, 최신 기기에서는 멀쩡했습니다.
범인은 left: 50% + translateX(-50%)였습니다. 데스크톱 Chrome에서는 교과서 같은 중앙 정렬인데, 구형 Android WebView에서는 믿을 수 없습니다. 모바일 웹을 앱 WebView로 감싸 서비스한다면 "iOS와 Chrome에서 맞으면 끝"이라는 가정부터 깨집니다.
구형 WebView에서만 fixed CTA와 칩이 가로로 어긋난다
하단 fixed CTA
온보딩, 탭 하단 플로팅, 여러 퍼널의 하단 고정 버튼이 WebView에서만 오른쪽으로 밀려 보였습니다.
safe area(env(safe-area-inset-bottom))는 맞는데 가로 중앙만 틀어지는 패턴이었습니다.
히어로 카드 위 칩(뱃지)
히어로 카드 위 뱃지에서도 같은 증상이 났습니다. 이 뱃지도 같은 클래스 패턴을 쓰고 있었습니다.
class="absolute top-[60px] left-1/2 -translate-x-1/2 ..."WebView에서만 칩이 중앙에서 살짝 밀려 보였습니다. 두 증상의 공통점은 % 기반 translate로 중앙을 잡는다는 것이었습니다.
원인 1: left: 50% + translateX(-50%)의 함정
데스크톱 Chrome에서는 잘 맞는 패턴입니다. 하지만 구형 Android WebView에서는:
transform이 별도 합성 레이어로 처리되면서- layout viewport와 visual viewport가 어긋날 때
%기반 translate가 기대와 다른 픽셀 값으로 계산되는 경우가 있습니다.
특히 fixed 요소 + transform 조합은 위치와 터치 히트 영역이 어긋나는 사례도 있습니다.
원인 2: visualViewport와 innerWidth·innerHeight가 다르다
여기에 viewport 문제가 겹칩니다. 키보드, 줌, 삼성 WebView, 폴더블 등에서는 window.visualViewport와 window.innerWidth/innerHeight가 다를 수 있습니다.
그래서 하단 fixed 바를 bottom: 0만으로 두면:
- 화면에서는 떠 보이거나
- 가로 inset(
offsetLeft,width차이)이 생겨 쏠려 보일 수 있습니다.
translate 중앙 정렬, GPU 레이어, inset, 런타임 보정
translateZ(0)만으로는 부족하다
Android WebView 이슈를 찾다 보면 translateZ(0) GPU 가속 이야기가 자주 나옵니다.
fixed 레이어에는 적용했습니다. 다만 이건 합성 레이어 분리용이라 left-1/2 translate를 대체하지는 못합니다. 역할을 나누면 이렇습니다.
| 방법 | 역할 |
|---|---|
translateZ(0) / transform-gpu | fixed 합성·터치 어긋남 완화 |
inset + mx-auto | 가로 중앙 (구형 Android에 더 안전) |
visualViewport inset | 런타임 가로·세로 보정 |
px bottom-* | 세로 위치 (% + transform 혼용 지양) |
CSS만으로 끝낼까, 런타임 보정을 넣을까
% translate를 inset + margin으로 바꾸면 가로 중앙 문제는 CSS 안에서 풀립니다. 하지만 CSS만으로는 visual viewport가 어긋나는 경우를 막지 못합니다. 그래서 하단 fixed에는 visualViewport 기반 런타임 보정을 더했습니다.
런타임 보정은 이벤트를 구독하는 비용이 있습니다. 모든 화면에 쓰기보다 하단 fixed가 있는 화면에만 적용하는 편이 낫다고 판단했습니다.
transform 없이 중앙 잡기
패턴 A — translate 대신 inset + margin
나쁜 예
className="absolute left-1/2 -translate-x-1/2"좋은 예 (칩·뱃지)
className="absolute right-0 left-0 top-15 mx-auto w-max"좋은 예 (가로 전체 중앙 flex)
className="absolute right-0 left-0 flex justify-center"% transform 없이 양쪽 inset + auto margin 또는 flex center로 중앙을 잡습니다.
패턴 B — 하단 fixed 바 공통 레이아웃
칩은 클래스 한 줄로 끝나지만, 하단 바는 화면마다 흩어져 있어서 상수로 묶었습니다. 모바일 웹뷰 열(최대 480px) 기준으로 translate 중앙 정렬을 없애고 inset을 씁니다.
// lib/layout/pcWebviewColumnLayout.ts
export const WEBVIEW_MOBILE_COLUMN_CENTER =
'max-[1199px]:left-0 max-[1199px]:right-0 max-[1199px]:mx-auto';
export const WEBVIEW_FIXED_LAYER_GUARD =
'transform-gpu backface-hidden isolate [transform:translateZ(0)]';WEBVIEW_MOBILE_COLUMN_CENTER: 모바일에서left-1/2 translate대체WEBVIEW_FIXED_LAYER_GUARD: fixed + 형제 transform 합성 버그 완화용 GPU 레이어
하단 바는 공통 레이아웃 상수 + device-max-width 조합으로 통일했습니다.
패턴 C — visualViewport inset 보정
하단 fixed에 런타임 보정을 넣었습니다.
// shared/lib/webview/webViewFixedBottomOffset.ts (요지)
export function computeWebViewLayoutHorizontalInset() {
const vv = window.visualViewport;
if (!vv) return { leftPx: 0, rightPx: 0 };
const leftPx = Math.max(0, Math.round(vv.offsetLeft));
const rightPx = Math.max(
0,
Math.round(window.innerWidth - vv.offsetLeft - vv.width),
);
return { leftPx, rightPx };
}const { fixedBarStyle } = useWebViewFixedBottomOffset();
<footer
className={cn(PC_WEBVIEW_BOTTOM_BAR_LAYOUT, 'z-20')}
style={fixedBarStyle}
/>resize / scroll / orientationchange / visualViewport 이벤트에 맞춰 갱신합니다.
실기기 WebView 핫픽스로 확인한 것
확인 방법과 결과
증상은 갤럭시 노트10+(Android 12) 골디 앱 WebView에서 재현됐고, 위 패턴은 그 실기기 WebView 핫픽스에서 나왔습니다. 하단 fixed CTA와 히어로 칩 모두 % translate를 걷어내는 방향으로 정리했습니다.
배운 것
구형 Android WebView에서는 "CSS 중앙 정렬 베스트 프랙티스"가 그대로 통하지 않습니다. 이번에 얻은 가장 실용적인 한 줄은 이겁니다.
WebView에서 가로 중앙은 translate 말고 inset + margin 또는 flex center로 잡자.
비슷한 증상을 보면 PR 전에 left-1/2 translate부터 찾아보세요. 시간을 꽤 아낄 수 있습니다.
참고
같은 주제의 글
Chrome에서 맞고 Safari에서 틀리는 레이아웃 체크리스트
flex min-width, button flex, gap 지원 버전, 100vh, sticky처럼 Safari(WebKit)와 앱 WebView에서 자주 어긋나는 지점과 대응을 한 장으로 정리했습니다.