CSS overflow: muestra, recorta o desplaza el contenido desbordado
En CSS, overflow determina qué ocurre cuando el contenido sobresale de su caja. Usa auto para permitir el desplazamiento cuando haga falta. Para recortar un adorno que sobresale, hidden permite desplazar mediante código y clip impide hacerlo.
Qué valor de overflow debes usar
| Valor | Qué pasa con el contenido que sobresale |
|---|---|
visible |
Puede verse fuera de la caja. Es el valor inicial. |
auto |
Permite desplazar el contenido desbordado dentro de la caja. |
scroll |
Crea un contenedor desplazable. Las barras dependen del sistema y del navegador. |
hidden |
Recorta el contenido y permite desplazarlo mediante código. |
clip |
Recorta el contenido e impide también el desplazamiento por JavaScript. |
Especificación del W3C sobre las propiedades de desbordamiento
Compara el desplazamiento en cajas iguales
Guarda el ejemplo completo como overflow-example.html en UTF-8 y ábrelo en un navegador. Las tres cajas de 72px de alto contienen lo mismo.
<!doctype html>
<html lang="es">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Compara el desplazamiento en cajas iguales</title>
<style>
body { margin: 1rem; font: 1rem/1.5 system-ui, sans-serif; }
.box { height: 72px; max-width: 20rem; border: 1px solid #547399; }
.content { min-height: 180px; padding: .5rem; background: #edf5ff; }
.auto { overflow: auto; }
.hidden { overflow: hidden; }
.clip { overflow: clip; }
.box:focus-visible { outline: 2px solid #104da2; outline-offset: 2px; }
</style>
</head>
<body>
<p id="auto-label">overflow: auto</p>
<div class="box auto" tabindex="0" role="region" aria-labelledby="auto-label">
<div class="content">Contenido para probar el desplazamiento. El texto y el fondo claro están dentro de un área más alta que la caja visible.</div>
</div>
<p>overflow: hidden</p>
<div class="box hidden"><div class="content">Contenido para probar el desplazamiento. El texto y el fondo claro están dentro de un área más alta que la caja visible.</div></div>
<p>overflow: clip</p>
<div class="box clip"><div class="content">Contenido para probar el desplazamiento. El texto y el fondo claro están dentro de un área más alta que la caja visible.</div></div>
<p>
<button type="button" id="move">Desplazar 50px</button>
<button type="button" id="reset">Restablecer posición</button>
</p>
<p id="result" role="status"></p>
<script>
const boxes = [...document.querySelectorAll(".box")];
const modes = ["auto", "hidden", "clip"];
const result = document.querySelector("#result");
function moveTo(top) {
boxes.forEach(box => { box.scrollTop = top; });
result.textContent = boxes.map((box, i) =>
modes[i] + ": " + box.scrollTop + " px"
).join(" / ");
}
document.querySelector("#move").addEventListener("click", () => moveTo(50));
document.querySelector("#reset").addEventListener("click", () => moveTo(0));
</script>
</body>
</html>
Puedes desplazar la primera caja con la rueda o mediante un gesto táctil. Pulsa Desplazar 50px para ver auto: 50 px / hidden: 50 px / clip: 0 px. Restablecer posición devuelve los tres valores a cero.
Con el teclado, pulsa Tab para enfocar la primera caja y usa las flechas para desplazarla. Si creas una zona desplazable, ponle un nombre descriptivo y comprueba que se puede entrar y salir de ella con el teclado.
En qué se diferencian hidden y clip
hidden crea un contenedor desplazable. Su contenido puede moverse si cambia scrollTop o si se enfoca un elemento descendiente. Con clip, el contenido queda fijo porque no hay contenedor desplazable.
Para recortar un adorno y contener elementos flotantes en un bloque, combina overflow: clip con display: flow-root. clip por sí solo no crea un contexto de formato de bloque independiente. Comprueba que los controles y los indicadores de foco queden visibles.
Define el desbordamiento horizontal y vertical
Con dos valores, el primero define overflow-x y el segundo define overflow-y. Por ejemplo, overflow: visible auto da auto en ambos ejes.
Con overflow: clip auto, el valor horizontal calculado depende del navegador. Las reglas anteriores lo convierten en hidden. Los navegadores con desplazamiento de un solo eje conservan clip. Comprueba ambos valores calculados en los navegadores que necesites admitir.
Documentación de Chrome sobre los contenedores de desplazamiento de un solo eje
Para el desplazamiento vertical, comprueba si algo como max-height limita la altura. Un bloque sin ese límite puede crecer con el contenido. Para el desplazamiento horizontal, la anchura efectiva debe ser inferior a la que necesita el contenido.
Si la caja no se desplaza o la página se ensancha
Si una fila Flex ensancha toda la página, revisa el elemento Flex que envuelve la caja desplazable. Su ancho mínimo basado en el contenido puede impedir que se reduzca. Prueba min-width: 0 en ese elemento y overflow-x: auto en la caja interior. En una columna, comprueba el efecto de min-height: 0.
Reglas del W3C sobre tamaños mínimos automáticos de elementos Flex
Para partir URL o cadenas largas sin perder texto, consulta Desbordamiento, texto largo y puntos suspensivos en CSS.



