「iOS Safariの100vh問題」dvh・svh・lvhで画面の高さを指定する

トップの大きな画像を height: 100vh で画面いっぱいにしたら、スマートフォンでは下のボタンが隠れてしまった。この記事では、その原因と、CSSの新しい単位 svh・lvh・dvh を使った直し方を説明します。

100vh がはみ出す原因はツールバー

スマートフォンのブラウザは、画面の上や下にアドレスバーなどのツールバーを表示しています。このツールバーは、ページを下にスクロールすると縮み、上に戻ると元の大きさに戻ります。つまり、ページを表示できる高さは、操作によって変わります。

一方、vh は「表示できる高さの1%」を表す単位ですが、ツールバーの伸び縮みに合わせては変わりません。web.dev の解説によると、ページを開いた直後(ツールバーが出ている状態)では 100vh の要素が画面からはみ出し、スクロールしてツールバーが縮むとちょうど収まります。

MDN では、今のブラウザの vh は、ツールバーが縮んだときの高さ(後で説明する lvh)と同じだと説明されています。開いた直後は、そのぶん大きすぎるというわけです。

⚠️ パソコンでは気づきにくい
パソコンのブラウザにはツールバーの伸び縮みがないので、100vh でも問題は起きません。スマートフォンの実機か、開発者ツールのスマートフォン表示で確かめる必要があります。

3つの新しい単位:svh・lvh・dvh

この問題のために、CSS に3種類の高さの単位が加わりました。どれも「1 = 高さの1%」で、基準にする高さだけが違います。

単位基準にする高さ値の変化
svh(small)ツールバーが出ているときの高さ(いちばん小さい)変わらない
lvh(large)ツールバーが縮んだときの高さ(いちばん大きい)変わらない
dvh(dynamic)いまの高さ。ツールバーの状態に合わせて svh と lvh の間で変わるスクロールで変わる
vh(従来)今のブラウザでは lvh と同じ変わらない

幅や最小値・最大値にも同じ仲間があります(svw・lvw・dvw、svmin・dvmax など)。web.dev によると、Chrome 108、Edge 108、Firefox 101、Safari 15.4 から使えます。

デモ:いまの画面で値を測る

それぞれの単位で 100 を指定した要素の高さを、ピクセルで表示します。パソコンでは4つとも同じ値になります。スマートフォンでこのページを開き、上下にスクロールしながら見比べると、svh と lvh の差、dvh の変化がわかります。

▶ Live Demo — 100vh・100svh・100lvh・100dvh の実際の高さ
100vh-
100svh-
100lvh-
100dvh-
window.innerHeight-

使い分けの目安

迷ったら、次の3つを基準にすると選びやすくなります。

  1. ページを開いたとき画面に収めたい → svhトップの大きな画像やタイトル画面など。ツールバーが出ていてもはみ出さず、スクロール中に高さが変わってガタつくこともありません。ツールバーが縮むと、下に少し隙間が見えるだけです。
  2. 常に画面ぴったりにしたい → dvhチャットやゲームなど、画面全体をアプリのように使うページ。ツールバーの状態に合わせて高さが変わります。ただし web.dev によると、ブラウザは dvh の更新を間引いたり、操作によっては遅らせたりするので、アニメーションのような滑らかさは期待しないでください。
  3. はみ出してもかまわない背景など → lvh(または従来の vh)スクロールで背景が途切れないようにしたいときに使います。
CSS
/* トップの大きな画像:開いた瞬間に画面へ収める */
.hero {
  min-height: 100vh;   /* 新しい単位に対応していないブラウザ用 */
  min-height: 100svh;
}

/* 画面全体を使うアプリ風の画面 */
.app {
  height: 100vh;
  height: 100dvh;
}

同じプロパティを2回書くと、ブラウザは理解できる最後の値を使います。古いブラウザは 100svh を読み飛ばして 100vh を使うので、表示が崩れることはありません。

また、height より min-height を使うほうが安全です。文字が多くて画面に入りきらないとき、height だと中身があふれてしまいますが、min-height なら要素のほうが伸びてくれます。

以前の対処法は外してよい

新しい単位が使えるようになる前は、次のような回避策がよく使われていました。今から作るページでは、どちらも必要ありません。

  • JavaScript で高さを測って CSS 変数に入れる:window.innerHeight を読んで --vh に入れ、calc(var(--vh) * 100) で使う方法。dvh でほぼ同じことができ、スクリプトもいりません。
  • -webkit-fill-available:Safari 向けの古い指定です。svh で置き換えられます。

既存のサイトにこれらが残っている場合は、上の書き方に置き換えてから、スマートフォンの実機で表示を確かめてください。

まとめ

  • スマートフォンの 100vh がはみ出すのは、ツールバーの伸び縮みを vh が考えに入れていないから。今の vh は、ツールバーが縮んだときの高さ(lvh)と同じ。
  • svh はツールバーが出ているときの高さ、lvh は縮んだときの高さ、dvh はいまの高さを基準にする。
  • ページを開いたときに画面へ収めたいなら svh、常にぴったりにしたいなら dvh を使う。
  • 古いブラウザ向けに vh を先に書き、続けて新しい単位を書けば、表示は崩れない。
  • JavaScript で高さを測る方法や -webkit-fill-available は、もう使わなくてよい。

参考・出典

対応ブラウザのバージョンは確認日の情報です。