Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / CSS

vw — unidade de largura da área de visualização

A unidade vw expressa um comprimento relativo à largura da área de visualização grande: 1vw corresponde a 1% dessa largura, independentemente da largura do elemento pai.

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

Sintaxe

<number>vw

vw é uma unidade CSS relativa de comprimento. Escreva um número diretamente antes da unidade, por exemplo, 50vw. 1vw equivale a 1% da largura da área de visualização grande; por isso, 50vw representa metade dessa largura. Pode ser usada em propriedades que aceitam um comprimento, e não apenas em width.

Ao contrário de width: 50%, que usa como referência a largura do bloco contentor, width: 50vw não depende da largura do elemento pai. A unidade refere-se à largura física, independentemente da direção da escrita.

vw corresponde a lvw: pressupõe-se que a interface do navegador, que pode recolher-se dinamicamente, está oculta. svw usa a área de visualização pequena, enquanto dvw usa a área de visualização dinâmica. Com overflow: auto, as barras de deslocamento não reduzem a base das unidades da área de visualização, pelo que 100vw pode causar transbordamento horizontal. O exemplo desativa as barras de deslocamento para isolar o cálculo da largura.

Exemplos

<!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>

Resultado

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

O exemplo compara a largura da barra de `50vw` com metade da largura medida de um elemento de `100lvw`. Em seguida, altera a largura do elemento pai e verifica se a largura da barra se mantém.

Fontes