CSS overflow: exiba, recorte ou role conteúdo que transborda
No CSS, overflow define o que acontece quando o conteúdo ultrapassa a caixa. Use auto para rolar dentro dela quando for preciso. Para recortar uma decoração, hidden ainda permite rolagem por código, enquanto clip impede a rolagem.
Qual valor de overflow usar?
| Valor | Efeito quando o conteúdo transborda |
|---|---|
visible |
O conteúdo pode aparecer fora da caixa. É o valor inicial. |
auto |
Permite rolar o conteúdo excedente dentro da caixa. |
scroll |
Cria uma caixa de rolagem. A exibição das barras depende do sistema e do navegador. |
hidden |
Recorta o conteúdo, mas a rolagem por código ainda funciona. |
clip |
Recorta o conteúdo e impede a rolagem, inclusive com JavaScript. |
Especificação do W3C para as propriedades CSS de overflow
Compare a rolagem em caixas iguais
Salve o código completo como overflow-example.html em UTF-8 e abra-o no navegador. As três caixas de 72px de altura contêm o mesmo conteúdo.
<!doctype html>
<html lang="pt">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Compare a rolagem em caixas iguais</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">Conteúdo para testar a rolagem. O texto e o fundo claro ocupam uma área mais alta do que a parte visível da caixa.</div>
</div>
<p>overflow: hidden</p>
<div class="box hidden"><div class="content">Conteúdo para testar a rolagem. O texto e o fundo claro ocupam uma área mais alta do que a parte visível da caixa.</div></div>
<p>overflow: clip</p>
<div class="box clip"><div class="content">Conteúdo para testar a rolagem. O texto e o fundo claro ocupam uma área mais alta do que a parte visível da caixa.</div></div>
<p>
<button type="button" id="move">Rolar 50px</button>
<button type="button" id="reset">Voltar ao início</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>
A primeira caixa pode rolar com a roda do mouse ou por toque. Clique em Rolar 50px para ver auto: 50 px / hidden: 50 px / clip: 0 px. Voltar ao início zera as três posições.
No teclado, pressione Tab para focar a primeira caixa e use as setas para rolar. Dê um nome descritivo às áreas de rolagem da página e confirme que é possível entrar e sair delas pelo teclado.
A diferença entre hidden e clip
hidden cria um contêiner de rolagem. Alterar scrollTop ou mover o foco para um descendente pode deslocar o conteúdo. Com clip, ele fica no lugar porque a caixa não se torna um contêiner de rolagem.
Quando um bloco precisa recortar uma decoração e conter elementos flutuantes, combine overflow: clip com display: flow-root. clip sozinho não cria um contexto de formatação de bloco independente. Confira se os controles e indicadores de foco continuam visíveis.
Defina o transbordamento horizontal e vertical
Com dois valores, o primeiro define overflow-x e o segundo define overflow-y. Por exemplo, overflow: visible auto resulta em auto nos dois eixos.
Com overflow: clip auto, o valor computado no eixo horizontal depende do navegador. As regras antigas o convertem em hidden. Navegadores com rolagem em um só eixo mantêm clip. Confira os dois valores computados nos navegadores que você precisa atender.
Documentação do Chrome sobre contêineres de rolagem em um só eixo
Para rolagem vertical, veja se a altura está limitada por algo como max-height. Um bloco sem limite pode crescer conforme o conteúdo. Para a rolagem horizontal, a largura usada precisa ser menor que o espaço exigido pelo conteúdo.
Quando a caixa não rola ou a página fica larga
Se uma linha Flex alargar toda a página, examine o item Flex que envolve a caixa de rolagem. A largura mínima baseada no conteúdo pode impedir que ele encolha. Teste min-width: 0 nesse item e overflow-x: auto na caixa interna. Em uma coluna Flex, confira o efeito de min-height: 0.
Regras do W3C sobre tamanhos mínimos automáticos de itens Flex
Para quebrar URLs e textos longos em várias linhas, veja Overflow, quebra de texto longo e reticências em CSS.



