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.