CSS overflow 的用法:显示、裁切或滚动溢出内容
CSS 的 overflow 决定内容超出盒子时如何显示。希望仅在需要时在盒内滚动,可以用 auto。如果要裁掉溢出的装饰,hidden 仍允许脚本滚动,而 clip 会禁止滚动。
该用哪个 overflow 值?
| 取值 | 内容溢出时的行为 |
|---|---|
visible |
盒外的内容仍可以显示。这是初始值。 |
auto |
可以在盒子内滚动查看溢出的内容。 |
scroll |
盒子成为滚动容器。滚动条的显示取决于平台和浏览器设置。 |
hidden |
裁切内容,但脚本仍然可以滚动。 |
clip |
裁切内容,并阻止包括 JavaScript 在内的滚动。 |
用相同的盒子比较滚动
将完整代码以 UTF-8 编码保存为 overflow-example.html,再用浏览器打开。三个 72px 高的盒子使用相同的内容。
<!doctype html>
<html lang="zh-Hans">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>用相同的盒子比较滚动</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">这段内容用于测试滚动。文字和浅色背景所在区域比盒子的可见部分更高。</div>
</div>
<p>overflow: hidden</p>
<div class="box hidden"><div class="content">这段内容用于测试滚动。文字和浅色背景所在区域比盒子的可见部分更高。</div></div>
<p>overflow: clip</p>
<div class="box clip"><div class="content">这段内容用于测试滚动。文字和浅色背景所在区域比盒子的可见部分更高。</div></div>
<p>
<button type="button" id="move">滚动 50px</button>
<button type="button" id="reset">回到起点</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>
第一个盒子可以用滚轮或触摸滚动。点击滚动 50px后,会看到 auto: 50 px / hidden: 50 px / clip: 0 px。点击回到起点会把三项都恢复为零。
使用键盘时,按 Tab 聚焦第一个盒子,再用方向键滚动。实际页面中的滚动区域应有说明内容的名称,也要确认键盘用户可以进入和离开该区域。
hidden 与 clip 的区别
hidden 会创建滚动容器。修改 scrollTop,或将焦点移到其内部元素,都可能滚动内容。clip 不会创建滚动容器,进行相同操作时内容保持原位。
如果一个块要裁切装饰,同时还要包住浮动元素,可以结合 overflow: clip 与 display: flow-root。仅设置 clip 不会创建独立的块格式化上下文。还要检查控件和焦点轮廓是否可见。
设置水平和垂直方向
写两个值时,第一个设置 overflow-x,第二个设置 overflow-y。例如,overflow: visible auto 的两个方向都会计算为 auto。
使用 overflow: clip auto 时,水平方向的计算值因浏览器而异。旧规则将它转换为 hidden,支持单轴滚动的浏览器则保留 clip。请在目标浏览器中检查两个方向的计算值。
需要垂直滚动时,先检查是否通过 max-height 等方式限制了高度。没有高度限制的块可能随内容增高。需要水平滚动时,盒子的实际宽度要小于内容需要的宽度。
盒子无法滚动或页面被撑宽时
如果一行 Flex 布局撑宽了整个页面,请检查包裹滚动盒子的 Flex 项目。基于内容的最小宽度可能让它无法收缩。可尝试给该项目设置 min-width: 0,再给内部盒子设置 overflow-x: auto。在竖向 Flex 布局中,可检查 min-height: 0 是否有效。
如果希望长网址或字符串换行并保持可读,可以参考CSS 溢出、长文本换行与省略号。



