CSS und Layouts

100vh lügt auf dem Smartphone: dvh, svh und lvh

Der Hero-Bereich auf der Startseite soll den ganzen Bildschirm füllen, und unten steht der Button „Zum Angebot“. Der Code ist naheliegend:

css

.hero {
height: 100vh;
display: flex;
flex-direction: column;
justify-content: flex-end;
}

Auf dem Desktop funktioniert das perfekt. Auf dem iPhone ist der Button unter der unteren Leiste von Safari versteckt und erscheint erst nach etwas Scrollen – in der Praxis sieht ihn also der Großteil der Nutzer nie. Chrome auf Android zeigt denselben Effekt, nur sitzt die Adressleiste oben, also wird ein anderer Teil abgeschnitten.

Jahrelang war die Standardlösung ein Stück JavaScript, das bei jedem resize window.innerHeight gemessen und das Ergebnis in eine CSS-Variable geschrieben hat:

javascript

function setVh() {
document.documentElement.style.setProperty(
"--vh",
window.innerHeight * 0.01 + "px"
)
}
window.addEventListener("resize", setVh)
setVh()
/* im CSS: height: calc(var(--vh) * 100); */

Das funktionierte, aber mit Verzögerung – die Adressleiste verschwindet beim Scrollen, resize feuert in Salven, und jeder Aufruf berechnet das Layout auf dem Main Thread neu. Im besten Fall ruckelte der Hero leicht, im schlimmsten bei jedem Scrollen. Seit 2022 ist das nicht mehr nötig, aber um die richtige native Einheit zu wählen, muss man erst verstehen, woher das Problem überhaupt kommt.

Warum 100vh höher ist als der Bildschirm

Auf dem Smartphone hat der sichtbare Bereich einer Seite zwei extreme Höhen. Beim Laden sind Adressleiste und Werkzeugleiste ausgeklappt – man sieht weniger Inhalt. Sobald man nach unten scrollt, blendet der Browser sie aus, und der Seitenbereich wächst um einige Dutzend bis über hundert Pixel.

Die Frage lautet also: Wie viel ist 100vh? Würde die Einheit der aktuellen Höhe folgen, würde jedes Ausblenden der Leiste die Größe aller auf vh basierenden Elemente ändern – während des Scrollens, also im denkbar schlechtesten Moment. Inhalte darunter würden springen, und der Browser müsste das Layout in jedem Frame der Leistenanimation neu berechnen. Deshalb traf das WebKit-Team schon 2015 eine Entscheidung, die die übrigen Browser später übernommen haben: vh entspricht der Höhe bei ausgeblendeten Leisten, also dem größtmöglichen Bereich. Die Einheit ist stabil und ändert sich beim Scrollen nie – um den Preis, dass 100vh bei ausgeklappten Leisten höher ist als das, was tatsächlich sichtbar ist.

Das ist also kein Bug, den jemand vergessen hat zu beheben. Es ist ein Kompromiss, bei dem die Browser Layoutstabilität über Genauigkeit gestellt haben. Die neuen Einheiten ändern diesen Kompromiss nicht – sie erlauben nur, einen anderen zu wählen.

Drei Viewports: svh, lvh, dvh

Die Spezifikation CSS Values 4 hat drei Viewport-Größen benannt und jeder eine eigene Einheitenfamilie gegeben:

  • svh (small viewport) – die Höhe bei ausgeklappten Leisten. Die kleinstmögliche, ändert sich beim Scrollen nicht.
  • lvh (large viewport) – die Höhe bei ausgeblendeten Leisten. Die größtmögliche, ebenfalls konstant.
  • dvh (dynamic viewport) – die Höhe im jeweiligen Moment. Als einzige ändert sie sich beim Scrollen.
  • vh – in der Praxis dasselbe wie lvh.

Jede hat auch Entsprechungen für die Breite (svw, lvw, dvw), logische Varianten (svb, svi und der Rest) sowie svmin/svmax. Auf dem Desktop, wo keine Leisten verschwinden, sind alle drei Viewports gleich groß, und 100svh, 100lvh und 100dvh liefern dasselbe Ergebnis.

Die Falle: dvh wirkt wie die offensichtliche Wahl

Die meisten Tutorials enden mit „ersetze 100vh durch 100dvh“ – und genau das ist der Fehler, vor dem uns die Browser 2015 bewahren wollten. dvh folgt der aktuellen Höhe, ändert sich also beim Scrollen. Ein Hero mit height: 100dvh wächst, wenn die Adressleiste verschwindet, und schrumpft, wenn sie zurückkommt – und der gesamte Inhalt darunter verschiebt sich mit. Der Nutzer scrollt die Seite, und der Text, den er gerade liest, rutscht ihm unter dem Finger um einige Dutzend Pixel weg. Je nach Browser passiert die Änderung fließend während der Leistenanimation oder sprunghaft danach – in beiden Fällen ist es eine Neuberechnung des Layouts und eine Verschiebung von Inhalt, die man leicht für einen CLS-Fehler hält.

Deshalb ist die vernünftige Standardwahl svh:

css

.hero {
min-height: 100vh; /* Fallback für Browser vor 2022 */
min-height: 100svh;
display: flex;
flex-direction: column;
justify-content: flex-end;
}

100svh ist die Höhe bei ausgeklappten Leisten, der Button unten im Hero ist also direkt nach dem Laden sichtbar. Beginnt der Nutzer zu scrollen und die Leisten verschwinden, erscheint unter dem Hero ein Stück des nächsten Abschnitts – mehr nicht. Nichts springt, weil sich svh nicht ändert. Beachte auch min-height statt height: Passt der Inhalt des Heros auf einem kleinen Smartphone nicht auf einen Bildschirm, wächst der Abschnitt einfach, statt Text abzuschneiden.

dvh ist dort sinnvoll, wo ein Element den Bildschirm die ganze Zeit exakt ausfüllen muss und darunter kein Inhalt liegt, den eine Größenänderung verschieben könnte:

css

/* Vollbild-App: Kopf, scrollbarer Inhalt, Fuß.
Nur .app__content scrollt, nicht die ganze Seite – eine
Höhenänderung verschiebt also nichts, was der Nutzer gerade liest. */
.app {
height: 100dvh;
display: grid;
grid-template-rows: auto 1fr auto;
}
.app__content {
overflow-y: auto;
}

Hier würde svh nach dem Ausblenden der Browserleisten einen leeren Streifen unter dem Fuß hinterlassen, und lvh würde den Fuß darunter verstecken. dvh ist die einzige Einheit, die den Fuß in jedem Zustand genau an der Unterkante hält. Und weil das Innere der App scrollt und nicht das Dokument, blenden sich die Browserleisten in vielen Fällen gar nicht aus – Größenänderungen sind also selten.

lvh ist am seltensten nützlich: hauptsächlich für Hintergründe und Dekorationen, die immer bis an die Bildschirmkante reichen sollen, auch wenn ein Teil davon gerade unter einer Leiste liegt.

Die Tastatur: ein Viewport, den die Einheiten nicht sehen

Das zweite klassische Problem taucht in Formularen auf. Ein Chat oder Checkout mit einem „Senden“-Button, der unten am Bildschirm klebt:

css

.composer {
position: fixed;
inset: auto 0 0 0;
}

Der Nutzer tippt ins Textfeld, die Tastatur fährt hoch – und der Button verschwindet darunter. Keine der Einheiten svh, lvh, dvh hilft hier, denn standardmäßig ändert die Tastatur die Größe des Layout-Viewports nicht. Seit Chrome 108 auf Android (Safari auf iOS hat das schon immer so gemacht) verkleinert die Tastatur nur den visuellen Viewport – also das, was man sieht –, während das Layout der Seite unverändert bleibt. Die Seite verhält sich, als wäre die Tastatur ein Overlay, das die Ansicht verschiebt.

In Chromium-basierten Browsern lässt sich dieses Verhalten im Viewport-Tag ändern:

html

<meta
name="viewport"
content="width=device-width, initial-scale=1, interactive-widget=resizes-content"
>

interactive-widget kennt drei Werte: resizes-visual (das oben beschriebene Standardverhalten), resizes-content (die Tastatur verkleinert den Layout-Viewport, sodass sich dvh, position: fixed; bottom: 0 und alles andere automatisch anpassen) und overlays-content (die Tastatur ändert gar nichts, nicht einmal den visuellen Viewport). Für eine App mit einem Textfeld an der Unterkante erledigt resizes-content die Sache meist mit einer Zeile.

Der Haken: Safari auf iOS unterstützt dieses Attribut nicht. Dort bleibt die einzige zuverlässige Informationsquelle über die Tastatur die API visualViewport – das Event resize auf window.visualViewport sowie dessen height und offsetTop. Das ist eine Rückkehr zu JavaScript, aber nur für einen schmalen Fall, nicht für jedes Element mit Bildschirmhöhe. (Chromium bietet außerdem die VirtualKeyboard API mit der Variablen env(keyboard-inset-height), ohne Unterstützung in Safari ist das aber eher eine Kuriosität als eine Lösung.)

Safe Area: ein Button über der Home-Leiste

Wenn wir schon bei Buttons an der Unterkante sind: Ein iPhone ohne physischen Home-Button hat unten am Bildschirm eine Gestenleiste, die Inhalte überlagert, wenn die Seite bis an den Rand reicht. Ein Button mit bottom: 0 landet teilweise darunter. Hier hilft ein Paar: viewport-fit=cover im Viewport-Tag und die Umgebungsvariable env(safe-area-inset-bottom):

css

.composer {
position: fixed;
inset: auto 0 0 0;
padding-bottom: max(12px, env(safe-area-inset-bottom));
}

max() sorgt dafür, dass der Button auf Geräten ohne Home-Leiste einen normalen Abstand von 12px bekommt und auf dem iPhone genau so viel, wie der Gestenbereich einnimmt.

Bonus: Auch 100vw lügt auf dem Desktop

Wenn vh nicht ist, was es scheint, lohnt es sich zu wissen, dass auch sein horizontales Gegenstück ein eigenes Problem hat – diesmal auf dem Desktop. 100vw ist die Breite des Viewports einschließlich der Scrollleiste. Unter Windows, wo Scrollleisten Platz belegen (meist etwa 15–17px), ist ein Element mit width: 100vw breiter als der Inhaltsbereich, und die Seite bekommt eine horizontale Scrollleiste. Unter macOS mit den standardmäßig eingeblendeten Overlay-Scrollleisten sieht man das Problem nicht – deshalb rutscht dieser Bug so oft unbemerkt durch das Code-Review.

css

/* Falsch: breiter als die Seite, wenn es eine vertikale Scrollleiste gibt */
.full-bleed {
width: 100vw;
}
/* Richtig: volle Breite des Containers, ohne über die Seite hinauszuragen */
.full-bleed {
width: 100%;
}

Soll ein Element aus einem schmalen Inhaltscontainer auf die volle Seitenbreite „ausbrechen“, ist ein Grid mit benannten Linien sicherer als 100vw mit negativen Margins.

Fallen und Best Practices

  • Standardmäßig svh, nicht dvh. Die kleine Höhe ist stabil und garantiert, dass nichts unter den Browserleisten verschwindet. dvh bleibt Layouts vorbehalten, die innen scrollen und den Bildschirm exakt füllen müssen.
  • min-height statt height für Vollbild-Abschnitte. Ein Smartphone im Querformat oder eine große Systemschrift sorgen dafür, dass der Inhalt nicht passt – und eine feste Höhe schneidet ihn ab.
  • Die Tastatur ist ein eigenes Problem. Viewport-Einheiten sehen sie nicht. Auf Android nutze interactive-widget=resizes-content, auf iOS visualViewport – und teste auf einem echten Gerät, denn die Emulation in den DevTools zeigt keine Tastatur.
  • Buttons an der Unterkante brauchen env(safe-area-inset-bottom) zusammen mit viewport-fit=cover, sonst verschwindet ein Teil davon unter der Gestenleiste des iPhones.
  • Verwende 100vw nicht für volle Breite. Auf Systemen mit sichtbarer Scrollleiste erzeugt es horizontales Scrollen, das du auf dem Mac nicht siehst.
  • Entferne den alten --vh-Hack. Die Einheiten svh, lvh und dvh funktionieren seit Safari 15.4, Firefox 101 und Chrome 108 (2022), ein resize-Listener, der die Höhe neu berechnet, ist heute also unnötiger Aufwand auf dem Main Thread. Für sehr alte Browser genügt eine Deklaration mit vh direkt vor der mit svh.

Fazit

100vh ist auf dem Smartphone nicht kaputt – es entspricht der Bildschirmhöhe bei ausgeblendeten Browserleisten, weil nur dieser Wert sich beim Scrollen nicht ändert. Die neuen Einheiten erlauben einen anderen Bezugspunkt: svh für die Höhe bei ausgeklappten Leisten, lvh bei ausgeblendeten und dvh für einen Wert, der dem aktuellen Zustand folgt. Entscheidend ist, dass dvh – in Tutorials am häufigsten empfohlen – genau das Problem zurückbringt, vor dem uns die Browser schützen wollten: ein Layout, das sich beim Scrollen unter dem Finger verändert. Für die meisten Vollbild-Abschnitte ist min-height: 100svh die richtige Wahl, für die Bildschirmtastatur interactive-widget oder visualViewport und für Buttons an der Kante env(safe-area-inset-bottom). Keine dieser Lösungen braucht mehr einen resize-Listener.