viewport

Qué es

Un viewport es el rectángulo en el que el navegador distribuye y
dibuja un documento: en pantalla, el área de la ventana delimitada
por sus barras de herramientas; en papel, el área de página de cada
hoja. CSS lo usa constantemente como referencia. El bloque
contenedor inicial, la caja en la que se distribuye el elemento
raíz, toma su tamaño; una consulta de medios `width` o `height`
pregunta por él, y las unidades `vw` y `vh` son centésimas de sus
dimensiones. En un teléfono, la palabra viewport y su plural,
viewports, necesitan un calificativo. Las especificaciones
distinguen varios: de disposición, visual, pequeño, grande y
dinámico.

En un ordenador de escritorio, el viewport y la ventana son casi lo
mismo. En un teléfono se separan. Como tantos documentos se
diseñaron para ventanas de escritorio, los navegadores móviles
distribuyen las páginas que no dan instrucciones con un ancho fijo
que imita una de esas ventanas, normalmente entre 980 y 1.024
píxeles CSS según la especificación CSS Viewport, y reducen el
resultado para que quepa en la pantalla. Una página evita ese
comportamiento con un elemento en su cabecera, que acepta `width`,
`height`, tres límites de escala, `user-scalable` e
`interactive-widget`:

```html
<meta name="viewport" content="width=device-width, initial-scale=1" />
```

El zoom divide el viewport en dos. El viewport de disposición es la
referencia con la que CSS distribuye la página; el gesto de ampliar
con los dedos no lo modifica, por lo que los saltos de línea
permanecen. El viewport visual es la parte de la página que se ve en
la pantalla en ese instante: se reduce al ampliar y se desplaza al
mover la vista. De forma predeterminada, el teclado en pantalla solo
reduce el viewport visual; `interactive-widget=resizes-content` pide
al navegador que cambie también el de disposición, y
`overlays-content` le pide que no cambie ninguno.

Los teléfonos añaden barras del navegador que se pueden ocultar. La
barra de direcciones ocupa espacio al cargar una página y se retrae
al desplazarse por ella, de modo que la altura visible cambia aunque
la página no se haya movido. CSS Values 4 define tres tamaños: el
viewport grande supone que todas las barras retráctiles están
ocultas; el pequeño, que todas están visibles; y el dinámico sigue
el estado actual. Las unidades llevan esos prefijos, `lvh`, `svh` y
`dvh`, con sus equivalentes de anchura, mientras que `vh` y `vw` sin
prefijo se definen respecto al viewport grande. Una interfaz que se
superpone al contenido sin desplazarlo, normalmente el teclado en
pantalla, no modifica ninguna de estas longitudes.

Por qué importa

El diseño adaptable se apoya en el viewport. Un punto de ruptura por
anchura en una hoja de estilos pregunta por su ancho. Si una página
omite el elemento `meta`, el teléfono la distribuye con ancho de
escritorio y la reduce hasta volver ilegible el texto, por muy
cuidadas que estén sus consultas de medios.

La altura es el eje difícil. La anchura puede cambiar al girar el
teléfono o redimensionar la ventana; la altura también puede variar
al moverse las barras, abrirse el teclado o girarse el teléfono. Por
eso, todo lo que se dimensione según la altura de la pantalla debe
precisar a qué altura se refiere. El viewport pequeño permite
ajustar el contenido con las barras retráctiles visibles y deja una
franja vacía cuando se ocultan. El grande llena la pantalla y coloca
contenido detrás de las barras mientras están visibles. El dinámico
tiene en cuenta los cambios de estado de las barras; la propia
especificación advierte que puede redimensionar el contenido
mientras el lector se desplaza, moviendo todo lo que queda debajo.

Las pantallas también tienen esquinas. Un teléfono con esquinas
redondeadas o una muesca para la cámara no es un rectángulo. Con el
valor predeterminado, `auto`, la página entera permanece visible.
Añadir `viewport-fit=cover` pide que el viewport sea el rectángulo
que rodea toda la pantalla física y deja a la página la tarea de
mantener el texto lejos de la muesca mediante las variables
`env(safe-area-inset-*)`. Esos márgenes deben ser cero en una
pantalla rectangular, por lo que una sola regla de relleno sirve
para ambas.

El posicionamiento fijo también depende del viewport. Una caja fija
se coloca respecto al viewport de disposición, al que CSS Positioned
Layout asigna el tamaño del viewport dinámico. Así, las barras de
cookies, los fondos de los diálogos modales y los menús de pantalla
completa permanecen quietos mientras la página se desplaza. Todo
ello supone que ningún elemento antecesor haya asumido ese papel,
algo que pueden hacer `transform`, `will-change` y `contain`.

La impresión es el viewport con el que nunca se encuentra una hoja
de estilos pensada solo para pantallas. En papel, las unidades de
viewport miden el área de página, una consulta de medios `width`
pregunta por la caja de página y un elemento fijo se repite en todas
las páginas.

Cómo se aplica en la práctica

Las páginas de este sitio declaran `width=device-width,
initial-scale=1, viewport-fit=cover`: se distribuyen con el ancho
del teléfono y llegan hasta los bordes, por debajo de la muesca. La
hoja de estilos resuelve la otra mitad: el relleno lateral es
`max(1rem, env(safe-area-inset-left))` y su equivalente derecho, de
modo que el texto mantiene una separación de un rem y solo se
desplaza más hacia dentro donde hay una muesca. En pantallas
horizontales bajas, el mínimo sube a `max(2rem, 7vw,
env(safe-area-inset-left))`, porque los márgenes de seguridad son
cero en un teléfono sin muesca y un rem dejaba el texto demasiado
cerca del borde.

Las secciones de pantalla completa toman su altura de una variable
compartida con valor `100dvh` y `100vh` como alternativa. El
comentario adjunto explica el motivo: `100vh` puede superar la
altura visible cuando aparece la barra de direcciones y había dejado
asomar la siguiente sección por debajo de la cabecera principal. Dos
elementos ignoran esa variable de forma deliberada. El símbolo de la
cabecera usa `vh` estático, porque, si dependiera del viewport
dinámico, cambiaría de tamaño al ocultarse las barras y
redistribuiría la cabecera durante el desplazamiento. El fondo fijo
de las pantallas táctiles mide `100lvh` de alto para no
redimensionarse cuando aparece o desaparece la barra de direcciones.
Tiene su propia capa de composición porque los navegadores táctiles
lo fragmentaban en bandas claras y oscuras durante el desplazamiento
por inercia.

En un diseño anterior de la página principal, cada bloque de
servicios tenía una altura mínima de `100dvh`, de modo que ocupaba
una pantalla mientras el contenido fuera más bajo que esta. Los
comentarios de la hoja de estilos revisados en noviembre de 2026
documentan una prueba a 852 por 393 píxeles: el contenido de un
bloque llegaba a 412 y los bloques se tocaban. En ese diseño, el
relleno interior dentro de `100dvh`, mediante `box-sizing:
border-box`, no consumía espacio adicional en una pantalla alta y
solo abría una separación cuando el contenido desbordaba.

En la etapa documentada de implementación del control de calidad de
agosto de 2026, las pruebas seguían las consultas de medios. El
control de calidad del sitio ejecutado en el navegador amplió sus
comprobaciones a una tabla común de veintidós formatos de ventana,
obtenidos de todas las consultas de medios de la hoja de estilos.
Solo la comprobación de la distribución pasó así de 95 segundos a
405.

La impresión puso de manifiesto las diferencias entre motores. La
hoja de estilos de impresión documenta que un motor calculaba las
unidades de viewport respecto a la caja de página y otro respecto a
la ventana. En el segundo, imprimir desde una ventana ancha
recortaba un tercio de cada línea. La hoja de estilos de la cabecera
documenta la otra cara del mismo problema: al imprimir se
conservaban la orientación, la altura y la anchura de la ventana,
por lo que las cabeceras de las hojas impresas desde una ventana
ancha y otra estrecha diferían en 47 píxeles. Añadir `screen and` al
principio de la consulta limitó la regla a las ventanas.

La trampa del bloque contenedor también está documentada. El trabajo
sobre movimiento reducido detectó que cinco propiedades distintas
convierten por separado un elemento en el bloque contenedor de lo
que se posiciona respecto al viewport. Eso había reducido sin aviso
una capa destinada a cerrar una superposición a una fracción de la
pantalla.

Dónde surgen los problemas

El teléfono muestra una diminuta página de escritorio. Sin el
elemento `meta` del viewport, el navegador distribuye la página con
ancho de escritorio y la reduce; las consultas de medios ven ese
ancho. Añada `width=device-width, initial-scale=1` y mantenga el
zoom: `user-scalable=no` elimina el recurso del lector para ampliar
por sí mismo el texto pequeño.

Una sección de pantalla completa rebasa el borde inferior. `100vh`
es el viewport grande, de modo que, mientras la barra de direcciones
está visible, la parte inferior de la sección y cualquier botón
situado allí quedan detrás de ella. Use `svh` para mantener un
elemento fuera del área ocupada por las barras desplegadas del
navegador, y `dvh` solo donde sea aceptable cambiar de tamaño
durante el desplazamiento.

Una capa de pantalla completa se reduce a una caja dentro de la
página. Un antecesor con `transform`, un `will-change` que lo
mencione o determinadas opciones de containment puede convertirse en
el bloque contenedor de `position: fixed`; la capa toma entonces el
tamaño de ese antecesor. Sitúe las capas fuera de cualquier elemento
transformado.

Una página impresa pierde el final de cada línea. Las unidades de
viewport y las consultas de medios dimensionadas para ventanas se
filtran a la impresión. Un motor que las calcula respecto a la
ventana distribuye la hoja como si fuera una pantalla. Evite las
unidades de viewport en todo lo que se imprima y anteponga `screen
and` a las consultas destinadas a ventanas.

Lecturas adicionales

  * CSS Viewport Module Level 1 — el elemento `meta` del viewport y
los tres comportamientos de `interactive-widget`.

  * CSS Values and Units Level 4: viewport-percentage lengths — los
tamaños de viewport pequeño, grande y dinámico, y todas sus
unidades.

  * CSS Positioned Layout Level 3 — el posicionamiento fijo, las
propiedades que establecen otro bloque contenedor y su
comportamiento en papel.

  * CSS Environment Variables Level 1 — los márgenes de seguridad y
la regla que los hace cero en pantallas rectangulares.

  * Media Queries Level 4 — `width`, `height` y `orientation`,
medidos respecto al viewport en pantalla y a la caja de página al
imprimir.

hEsta página en la web	URL:https://engineer.company/es/glossary/viewport/	engineer.company	70
