CSS overflow 的用法:显示、裁切或滚动溢出内容

CSS 的 overflow 决定内容超出盒子时如何显示。希望仅在需要时在盒内滚动,可以用 auto。如果要裁掉溢出的装饰,hidden 仍允许脚本滚动,而 clip 会禁止滚动。

该用哪个 overflow 值?

取值 内容溢出时的行为
visible 盒外的内容仍可以显示。这是初始值。
auto 可以在盒子内滚动查看溢出的内容。
scroll 盒子成为滚动容器。滚动条的显示取决于平台和浏览器设置。
hidden 裁切内容,但脚本仍然可以滚动。
clip 裁切内容,并阻止包括 JavaScript 在内的滚动。

W3C 对 CSS overflow 属性的定义

用相同的盒子比较滚动

将完整代码以 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。请在目标浏览器中检查两个方向的计算值。

Chrome 开发者文档对单轴滚动容器的说明

需要垂直滚动时,先检查是否通过 max-height 等方式限制了高度。没有高度限制的块可能随内容增高。需要水平滚动时,盒子的实际宽度要小于内容需要的宽度。

盒子无法滚动或页面被撑宽时

如果一行 Flex 布局撑宽了整个页面,请检查包裹滚动盒子的 Flex 项目。基于内容的最小宽度可能让它无法收缩。可尝试给该项目设置 min-width: 0,再给内部盒子设置 overflow-x: auto。在竖向 Flex 布局中,可检查 min-height: 0 是否有效。

W3C 关于 Flex 项目自动最小尺寸的规则

如果希望长网址或字符串换行并保持可读,可以参考CSS 溢出、长文本换行与省略号。