CSS overflow: mostrare, ritagliare o scorrere i contenuti

In CSS, overflow determina cosa succede quando il contenuto esce dal proprio riquadro. Usa auto per consentire lo scorrimento quando serve. Per ritagliare una decorazione, hidden consente ancora lo scorrimento via codice e clip lo impedisce.

Quale valore di overflow usare?

Valore Effetto sul contenuto che esce
visible Il contenuto può restare visibile fuori dal riquadro. È il valore iniziale.
auto Il contenuto in eccesso può scorrere dentro il riquadro.
scroll Crea un contenitore di scorrimento. La visualizzazione delle barre dipende dalla piattaforma e dal browser.
hidden Ritaglia il contenuto ma consente lo scorrimento via codice.
clip Ritaglia il contenuto e impedisce lo scorrimento anche tramite JavaScript.

Specifica W3C delle proprietà CSS di overflow

Confrontare lo scorrimento in riquadri identici

Salva il codice completo in UTF-8 come overflow-example.html e aprilo nel browser. I tre riquadri alti 72px hanno lo stesso contenuto.

<!doctype html>
<html lang="it">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Confrontare lo scorrimento in riquadri identici</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">Contenuto di prova per lo scorrimento. Il testo e lo sfondo chiaro si trovano in un’area più alta della parte visibile.</div>
  </div>
  <p>overflow: hidden</p>
  <div class="box hidden"><div class="content">Contenuto di prova per lo scorrimento. Il testo e lo sfondo chiaro si trovano in un’area più alta della parte visibile.</div></div>
  <p>overflow: clip</p>
  <div class="box clip"><div class="content">Contenuto di prova per lo scorrimento. Il testo e lo sfondo chiaro si trovano in un’area più alta della parte visibile.</div></div>
  <p>
    <button type="button" id="move">Scorri di 50px</button>
    <button type="button" id="reset">Torna all’inizio</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>

Il primo riquadro si scorre con la rotella o con il tocco. Premi Scorri di 50px per vedere auto: 50 px / hidden: 50 px / clip: 0 px. Torna all’inizio riporta tutte e tre le posizioni a zero.

Da tastiera, premi Tab per mettere a fuoco il primo riquadro e usa le frecce per scorrerlo. Assegna un nome descrittivo alle aree di scorrimento e verifica che da tastiera sia possibile entrarvi e uscirne.

La differenza tra hidden e clip

hidden crea un contenitore di scorrimento. Modificare scrollTop o spostare il focus a un discendente può far scorrere il contenuto. Con clip il contenuto resta fermo, perché il riquadro non diventa un contenitore di scorrimento.

Per ritagliare una decorazione e contenere elementi flottanti in un blocco, combina overflow: clip con display: flow-root. clip da solo non crea un contesto di formattazione a blocchi indipendente. Verifica che i controlli e gli indicatori del focus restino visibili.

Impostare l’overflow orizzontale e verticale

Con due valori, il primo imposta overflow-x e il secondo overflow-y. Per esempio, overflow: visible auto dà auto su entrambi gli assi.

Con overflow: clip auto, il valore calcolato sull’asse orizzontale dipende dal browser. Le regole precedenti lo trasformano in hidden. I browser che supportano lo scorrimento su un solo asse mantengono clip. Controlla i valori calcolati nei browser a cui ti rivolgi.

Documentazione Chrome sui contenitori di scorrimento a un solo asse

Per lo scorrimento verticale, verifica che l’altezza sia limitata, ad esempio da max-height. Un blocco senza limiti può crescere con il contenuto. Per quello orizzontale, la larghezza usata deve essere inferiore a quella necessaria al contenuto.

Quando il riquadro non scorre o la pagina si allarga

Se una riga Flex allarga l’intera pagina, controlla l’elemento Flex che contiene il riquadro da scorrere. La sua larghezza minima legata al contenuto può impedirgli di restringersi. Prova min-width: 0 sull’elemento e overflow-x: auto nel riquadro interno. In una colonna Flex prova min-height: 0.

Regole W3C sulla dimensione minima automatica degli elementi Flex

Per mandare a capo URL o stringhe lunghe, consulta Overflow, testo lungo a capo e puntini di sospensione in CSS.