# 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.

=> /es/portfolio/a-safety-net-that-no-longer-costs-half-an-hour/ El control de calidad del sitio ejecutado en el navegador
=> /es/portfolio/built-a-637-line-print-stylesheet/ La hoja de estilos de impresión
=> /es/portfolio/made-the-reduced-motion-setting-honest/ El trabajo sobre movimiento reducido
=> https://www.w3.org/TR/css-viewport-1/ CSS Viewport Module Level 1
=> https://www.w3.org/TR/css-values-4/#viewport-relative-lengths CSS Values and Units Level 4: viewport-percentage lengths
=> https://www.w3.org/TR/css-position-3/ CSS Positioned Layout Level 3
=> https://www.w3.org/TR/css-env-1/ CSS Environment Variables Level 1
=> https://www.w3.org/TR/mediaqueries-4/ Media Queries Level 4

=> https://engineer.company/es/glossary/viewport/ Esta página en la web
