# navigationBar.transparentBackground 적용 시 상단 영역(상태바+네비바 높이) 터치가 웹뷰에 전달되지 않습니다

**URL:** <https://techchat-apps-in-toss.toss.im/t/navigationbar-transparentbackground/4273>\
**Category:** 개발\
**Tags:** webview\
**Created:** [7월 5, 2026, 3:21오후 UTC](https://techchat-apps-in-toss.toss.im/t/navigationbar-transparentbackground/4273 "2026-07-05T15:21:15Z")\
**Posts on this page:** 9\
**Page:** 1

<div class="post-metadata">

**Author:** ![tory](https://avatars.discourse-cdn.com/v4/letter/t/41988e/32.png) [@tory](https://techchat-apps-in-toss.toss.im/u/tory)\
**Post date:** [7월 5, 2026, 3:21오후 UTC](https://techchat-apps-in-toss.toss.im/t/navigationbar-transparentbackground/4273/1 "2026-07-05T15:21:15Z")

</div>

### 이 글의 성격은 무엇인가요?

질문 / 문제 해결

### 내용을 설명해주세요

안녕하세요. 게임 미니앱 설화를 개발 중입니다.

[게임 미니앱 iOS 상단 상태바 영역이 흰색으로 남고 풀스크린이 안 됩니다](https://techchat-apps-in-toss.toss.im/t/ios/4200) 해당 게시글의 안내에 따라 navigationBar: { transparentBackground: true }를 적용해 상단 흰색 영역 문제는 해결했는데, 이후 상단 스트립 전체에서 터치가 웹뷰에 전달되지 않는 문제가 발생해 문의드립니다.

개발 환경

- SDK: @apps-in-toss/web-framework 2.10.1
- 웹 스택: React 19.2 + PixiJS 8.14 + Vite 6.3 (granite dev / ait build)
- granite.config.ts 주요 설정:  
webViewProps: { type: ‘game’ },  
navigationBar: { transparentBackground: true },
- index.html viewport: viewport-fit=cover 적용

테스트 환경

- iOS 실기기: 아이폰17 / OS 26.5.1v
- ait deploy 샌드박스 배포로 확인

문제 현상

transparentBackground: true로 설정후 화면 상단 스트립에서 터치가 웹뷰에 전혀 도달하지 않습니다.  
토스 정지/나가기버튼과 동일한 높이값 좌측에 메뉴들을 설정해두었는데 터치가 되지않는 상태입니다.  
혹시 의도된 동작일까요?

진단 빌드에서 window 레벨 pointerdown 카운터가 해당 영역 탭 시 증가하지 않는 것을 확인했습니다. 웹 쪽 hit-test 문제가 아니라 터치 이벤트가 웹뷰에 도달 자체를 못 하는 상태입니다.

### appName (선택)

설화

---

<div class="post-metadata">

**Author:** ![Dylan](https://yyz1.discourse-cdn.com/flex007/user_avatar/techchat-apps-in-toss.toss.im/dylan/32/597_2.png) [@Dylan](https://techchat-apps-in-toss.toss.im/u/Dylan)\
**Post date:** [7월 6, 2026, 1:12오전 UTC](https://techchat-apps-in-toss.toss.im/t/navigationbar-transparentbackground/4273/2 "2026-07-06T01:12:46Z")

</div>

안녕하세요 🙂  
확인해보겠습니다!

---

<div class="post-metadata">

**Author:** ![tory](https://avatars.discourse-cdn.com/v4/letter/t/41988e/32.png) [@tory](https://techchat-apps-in-toss.toss.im/u/tory)\
**Post date:** [7월 9, 2026, 9:42오전 UTC](https://techchat-apps-in-toss.toss.im/t/navigationbar-transparentbackground/4273/3 "2026-07-09T09:42:06Z")

</div>

안녕하세요, 혹시 원인 파악되었는지 문의드립니다

---

<div class="post-metadata">

**Author:** ![Dylan](https://yyz1.discourse-cdn.com/flex007/user_avatar/techchat-apps-in-toss.toss.im/dylan/32/597_2.png) [@Dylan](https://techchat-apps-in-toss.toss.im/u/Dylan)\
**Post date:** [7월 10, 2026, 12:56오전 UTC](https://techchat-apps-in-toss.toss.im/t/navigationbar-transparentbackground/4273/4 "2026-07-10T00:56:15Z")

</div>

이슈 확인하였고, 빠르게 조치하겠습니다 🙇‍♂️

---

<div class="post-metadata">

**Author:** ![Dylan](https://yyz1.discourse-cdn.com/flex007/user_avatar/techchat-apps-in-toss.toss.im/dylan/32/597_2.png) [@Dylan](https://techchat-apps-in-toss.toss.im/u/Dylan)\
**Post date:** [7월 10, 2026, 4:49오전 UTC](https://techchat-apps-in-toss.toss.im/t/navigationbar-transparentbackground/4273/5 "2026-07-10T04:49:26Z")

</div>

`@apps-in-toss/web-framework`를 `2.10.5` 버전으로 업데이트 후 테스트 부탁드려도 될까요 ?

---

<div class="post-metadata">

**Author:** ![xmarty](https://avatars.discourse-cdn.com/v4/letter/x/9fc348/32.png) [@xmarty](https://techchat-apps-in-toss.toss.im/u/xmarty)\
**Post date:** [7월 10, 2026, 6:36오전 UTC](https://techchat-apps-in-toss.toss.im/t/navigationbar-transparentbackground/4273/6 "2026-07-10T06:36:10Z")

</div>

혹시 이버전에 iOS에서 네비게이션바가 흰색 불투명바로 나오는거 해결됐나요. SDK업데이트한 모든 게임에서 안드로이드는 투명바가 나오고 iOS는 불투명바가 나와서 너무 당황스럽습니다.

---

<div class="post-metadata">

**Author:** ![sublevelgames](https://yyz1.discourse-cdn.com/flex007/user_avatar/techchat-apps-in-toss.toss.im/sublevelgames/32/177_2.png) [@sublevelgames](https://techchat-apps-in-toss.toss.im/u/sublevelgames)\
**Post date:** [7월 10, 2026, 7:51오전 UTC](https://techchat-apps-in-toss.toss.im/t/navigationbar-transparentbackground/4273/7 "2026-07-10T07:51:17Z")

</div>

iOS, SDK 2.10.5에서 투명 네비게이션 바의 터치가 먹지 않던 문제가 수정된 것을 확인했습니다. 감사합니다.

---

<div class="post-metadata">

**Author:** ![tory](https://avatars.discourse-cdn.com/v4/letter/t/41988e/32.png) [@tory](https://techchat-apps-in-toss.toss.im/u/tory)\
**Post date:** [7월 19, 2026, 10:39오전 UTC](https://techchat-apps-in-toss.toss.im/t/navigationbar-transparentbackground/4273/8 "2026-07-19T10:39:25Z")

</div>

안녕하세요, 해당 버전으로 업데이트 후 문제없이 정상작동하는것확인하였습니다. 빠른 처리 감사드립니다

---

<div class="post-metadata">

**Author:** ![system](https://canada1.discourse-cdn.com/flex007/uploads/toss/original/1X/04f077f5dd5f664f7f31421aab5be9e937a5c59f.png) [@system](https://techchat-apps-in-toss.toss.im/u/system)\
**Post date:** [7월 21, 2026, 10:39오전 UTC](https://techchat-apps-in-toss.toss.im/t/navigationbar-transparentbackground/4273/9 "2026-07-21T10:39:42Z")

</div>

이 주제는 마지막 댓글로부터 2일 뒤 자동으로 종료되었습니다. 새 댓글을 달 수 없습니다.
