iPhone版X(旧Twitter)の投稿リンクをアプリ内ブラウザで開いたとき、ページ上部に意図しない大きな余白が出ることがあります。viewport-fit=cover と env(safe-area-inset-top) でステータスバーやDynamic Islandとの重なりを避けているWebページで今回確認した症状です。

公開している銭湯マップとポートフォリオサイトでこの問題に遭遇し、実機計測で原因を特定しました。今回確認したiPhone版Xのアプリ内ブラウザでは、ページ上端がすでにステータスバーの下にあるにもかかわらず env(safe-area-inset-top) が 54px を返すため、先頭の余白が二重に入っていました。CSS変数をiPhone版Xのみ 0px にし、本来の余白 8px だけを残すことで解消できました。

上部に余白が出る原因

iOSのSafariなどで画面端まで背景を広げる場合は、<meta name="viewport" content="..., viewport-fit=cover"> を指定し、上部UIに env(safe-area-inset-top) を足して時計表示などとの重なりを防ぐのが一般的です。上端に 8px の間隔を持たせたいツールバーなら calc(8px + env(safe-area-inset-top, 0px)) と書くことで、ページ起点(top: 0)が画面最上部にあるSafariではステータスバー直下に 8px の余白を確保できます。

しかし今回確認したiPhone版Xのアプリ内ブラウザでは、Webビューポートの上端(top: 0)が最初からステータスバー(時計表示)の下にありました。それにもかかわらず、CSSの env(safe-area-inset-top) は 0px にならず 54px(iPhone 17 / iOS 27.2 / X 12.40でのCSS測定値)を返していました。

Xがネイティブ側で何をしているかや、この 54px がどこに由来する値かまでは断定できません。ただWeb側から見ると、すでにステータスバーの下にある先頭要素へさらに 54px が足されるため、本来残したい 8px に 54px が重なって不自然な空白が生じていました。

対処法と実際のコード

env(safe-area-inset-top, 0px) を各セレクタへ直接書くのをやめ、CSS変数 --safe-area-top に集約したうえで、iPhone版Xのアプリ内ブラウザのみ 0px に上書きします。通常のSafariやAndroid、他のWebViewでは env(safe-area-inset-top, 0px) の値をそのまま使います。

:root {
  --safe-area-top: env(safe-area-inset-top, 0px);
}

.toolbar {
  padding-top: calc(8px + var(--safe-area-top));
}

通常環境では各環境が返す env の値に 8px が加算され、iPhone版Xでは --safe-area-top が 0px となって 8px だけが残ります。

判定にはUser-Agentに含まれる Twitter for iPhone/ を使いました。実機のUser-Agentには Twitter for iPhone/12.40 が含まれていました。コードではバージョン番号を含めず、Twitter for iPhone/ が文字列中に現れるかを判定します。

Next.js製のポートフォリオサイトでは、<head> 内で初回描画前にCSSOM経由で上書きするコンポーネントを導入しました。

// X for iPhone already insets its web viewport below the status bar, but still
// reports the screen's top safe area (54px on iPhone 17, iOS 27.2 / X 12.40).
// Apply before paint via CSSOM so React's server-rendered markup stays intact.
const script = String.raw`if (/Twitter for iPhone\//.test(navigator.userAgent)) { var sheet = document.getElementById('x-safe-area').sheet; if (sheet) sheet.insertRule(':root{--safe-area-top:0px!important}', 0); }`;

export default function InAppSafeArea() {
  return (
    <>
      <style id="x-safe-area">{":root{}"}</style>
      <script dangerouslySetInnerHTML={{ __html: script }} />
    </>
  );
}

Reactの useEffect で描画後に適用した場合、初期表示の直後に余白が縮んで表示位置がずれる可能性があります。対策として <head> 内に空の <style id="x-safe-area"> と同期 <script> を置き、sheet.insertRule() でCSSルールだけを注入することで、SSRのマークアップを保ったまま初回描画前に反映させました。単一HTMLの銭湯マップでも同じ同期処理を <head> に入れ、上部の余白と操作UIの参照先を --safe-area-top に揃えています。

実機での実測結果

挙動を切り分けるため、位置確認マーカーとサンプル要素の safe-area 加算切り替えだけを置いた診断ページを公開し、iPhone 17(iOS 27.2 / X 12.40)のXアプリ内ブラウザ実機で確認しました。

スクロール量 0 の初期表示を画像で見ると、position: fixed; top: 0(赤)と position: absolute; top: 0(緑)のマーカーはどちらも時計表示の下に現れ、top: env(safe-area-inset-top) のマーカーはさらに下へ離れて描画されています。

safe-area加算あり(スクロール0):赤と緑のtop:0マーカーはすでに時計の下にあり、サンプル要素の上部に余白が空いている
safe-area加算なし(スクロール0):加算を外して8pxのみ残しても時計表示と重ならず、ステータスバーの下に収まる

加算をオフにして 8px のみ残しても、時計やステータスアイコンと重ならず直下に収まることが画像で分かります。

続いて 160px スクロールした状態(scroll.y = 160)で、加算オン/オフ双方のDOM矩形と計算済みスタイルをJSONで取得しました。共通条件は screen が 402 × 874、innerWidth × innerHeight と visualViewport が 402 × 691(offsetTop: 0、pageTop: 160、scale: 1)、CSSの env(safe-area-inset-top) が 54px(右・下・左は 0px)でした。高さ 8px のプローブは fixed が top: 0、absolute が top: -160、safe が top: 54 でした。

項目(scroll.y = 160 共通)safe-area加算ありsafe-area加算なし差分
padding-top62px8px-54px
要素の top-160px-160px0px
要素の bottom-21px-75px-54px
要素の height139px85px-54px

同じ scroll.y = 160 の条件で、padding-top が 62px(8px + 54px)から 8px へ減り、要素の高さと下端もCSS測定値の 54px 分だけ縮んでいることを確認できました。

検証範囲

確認範囲は、iPhone版Xの実機で確認したものとChrome再現で確認したものを分けて紹介します。

  • iPhone版X 実機確認: 銭湯マップとポートフォリオサイトは、本番反映後にiPhone 17のXアプリ内ブラウザ実機で上部余白が解消したことを確認しました。
  • Chrome再現確認: 他の公開サイトも、実機のUA・ビューポート(402 × 691)・safe-area-inset-top: 54px を再現したデスクトップ版Chromeとソースで点検しました。同型の余白が再現した complemEnter の公開LPと、上部バーやメニュー・ダイアログの top 参照を共通変数に揃えた「配置管理」「月間シフト」の計3サイトにも同じ補正を本番公開しています。追加の3サイトは、公開後のX実機確認までは行っていません。

補足

ノッチに地図を描けるか

今回確認したiPhone版Xの表示ではWebビューポートの上端(top: 0)自体がステータスバーの下にあるため、Web側のCSSを変えても時計やノッチ/Dynamic Islandの背後に地図を描画できません。今回解消したのは、その下に二重で空いていた 54px の余白です。

viewport-fitだけでは直らない理由

今回は viewport-fit=cover を指定した状態で、ビューポートがステータスバー下から始まりつつ env(safe-area-inset-top) が 54px を返すために余白が重なっていました。一方で viewport-fit=cover 自体を外すと、通常Safariなどで画面端まで背景を広げる表示まで崩れるため、viewport-fit=cover は維持してCSS変数で加算分を調整しています。

全環境で0pxにしない理由

通常のSafariや画面最上部から描画されるWebViewでは、env(safe-area-inset-top) の余白がないと上部UIがステータスバーと重なる場合があります。セーフエリアの大きさは端末や画面の向きでも変わるため、一律 0px や固定値にはせず、通常環境では env(safe-area-inset-top, 0px) を保持して Twitter for iPhone/ の場合に限り 0px にしました。