Skip to content

docs(recipes): safe-area-layout partner/game 분기 + subscribe stale (#93)#94

Merged
DaveDev42 merged 1 commit into
mainfrom
docs/93-safe-area-partner-game-branch
May 28, 2026
Merged

docs(recipes): safe-area-layout partner/game 분기 + subscribe stale (#93)#94
DaveDev42 merged 1 commit into
mainfrom
docs/93-safe-area-partner-game-branch

Conversation

@DaveDev42

Copy link
Copy Markdown
Contributor

Summary

  • partner WebView 에서 토스 상단바가 viewport 밖에 그려지므로 SafeAreaInsets.get().top 을 padding 으로 적용하면 헤더 위 중복 공간이 생긴다. 코드 예제에 __WEB_VIEW_TYPE__ (vite define 으로 granite.config.tswebViewProps.type 노출) 분기를 추가하고 :::caution 블록으로 명시. game/external 은 기존대로 padding 적용.
  • SafeAreaInsets.subscribe payload 가 landscape→portrait 회전 직후 top 채널을 직전 landscape 의 left/right 값으로 stale 전달하는 사례가 실측 확인됐다 (deterministic). callback 안에서 payload 를 버리고 get() 으로 재독하는 패턴으로 예제 갱신 + :::caution 명시.
  • ko (primary) / en (mirror) 양쪽 동기 갱신 — i18n drift 방지.

Closes #93

Test plan

  • pnpm build 통과 (Docusaurus prod 빌드).
  • docs.aitc.dev/recipes/safe-area-layout (ko) 및 /en/recipes/safe-area-layout (en) 두 페이지에서 :::caution 블록 두 개가 올바르게 렌더링되는지 미리보기 확인.

#93)

- partner WebView 는 토스 상단바가 viewport 밖이라 SafeAreaInsets.get().top
  을 padding 으로 쓰면 중복 공간이 생긴다. 코드 예제에 __WEB_VIEW_TYPE__
  분기를 추가하고 :::caution 으로 명시.
- subscribe payload 가 회전 후 stale 일 수 있으므로 signal 로만 쓰고
  get() 으로 다시 읽는다.
- ko (primary) / en mirror 양쪽 동기 갱신.
@DaveDev42 DaveDev42 merged commit c7379a7 into main May 28, 2026
3 checks passed
@DaveDev42 DaveDev42 deleted the docs/93-safe-area-partner-game-branch branch May 28, 2026 13:58
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.

recipes/safe-area-layout: webViewType 분기 + subscribe stale 주의 추가

1 participant