WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / CSS

vw — Einheit für die Viewportbreite

Die Einheit vw gibt eine Länge relativ zur Breite des großen Viewports an: 1vw entspricht 1 % dieser Breite, unabhängig von der Breite des Elternelements.

Version: CSS modules; structured CSSWG indexes reconciled with pinned MDN BCD; Chromium 152 scope gate, per-example verification still required

Syntax

<number>vw

vw ist eine relative CSS-Längeneinheit. Schreibe eine Zahl direkt vor die Einheit, zum Beispiel 50vw. 1vw entspricht 1 % der Breite des großen Viewports; 50vw bedeutet also die Hälfte dieser Breite. Die Einheit funktioniert in Eigenschaften, die Längenwerte akzeptieren, nicht nur in width.

Anders als bei width: 50%, dessen Berechnungsgrundlage die Breite des umschließenden Blocks ist, hängt width: 50vw nicht von der Breite des Elternelements ab. Die Einheit bezieht sich unabhängig von der Schreibrichtung auf die physische Breite.

vw entspricht lvw: Dabei wird angenommen, dass eine dynamisch einklappbare Browseroberfläche ausgeblendet ist. svw verwendet den kleinen Viewport, dvw den dynamischen Viewport. Bei overflow: auto verkleinern Scrollleisten nicht die Berechnungsgrundlage der Viewport-Einheiten, daher kann 100vw zu horizontalem Überlauf führen. Im Beispiel werden Scrollleisten deaktiviert, um die Berechnung der Breite isoliert zu zeigen.

Beispiele

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Measuring 50vw</title>
  <style>
    html { overflow: hidden; }
    body { margin: 0; }
    #container { width: 25%; }
    #bar { width: 50vw; height: 40px; background: teal; }
    #reference { width: 100lvw; }
  </style>
</head>
<body>
  <h1>A bar sized in viewport units</h1>
  <div id="container" aria-hidden="true"><div id="bar"></div></div>
  <div id="reference" aria-hidden="true"></div>
  <script>
    const container = document.getElementById('container');
    const bar = document.getElementById('bar');
    const width = element => element.getBoundingClientRect().width;
    const firstParentWidth = width(container);
    const firstBarWidth = width(bar);
    container.style.width = '75%';
    const largeViewportWidth = width(document.getElementById('reference'));
    console.log(`Bar width is half the large viewport width: ${Math.abs(firstBarWidth - largeViewportWidth / 2) < 0.03125}`);
    console.log(`Changing the parent width leaves the bar width unchanged: ${width(container) > firstParentWidth && width(bar) === firstBarWidth}`);
  </script>
</body>
</html>

Ergebnis

Bar width is half the large viewport width: true
Changing the parent width leaves the bar width unchanged: true

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen