971 字
5 分鐘

CSS overscroll-behavior:面板捲到底後,如何停止帶動整頁

本文目錄

側欄裡的訊息已捲到底,再滑一下,整個頁面也跟著移動,這叫 scroll chaining(捲動串連)。要讓這個區域的垂直捲動停在邊界,將 overscroll-behavior-y: contain 設在真正負責捲動的容器上。

它控制的是到達邊界後的行為。容器本身仍要有尺寸限制與 overflow;若目前連內部捲軸都沒有,先處理版面,才輪到 overscroll。MDN 模組說明

auto、contain、none 對應不同邊界需求#

值繼續帶動祖先捲動容器邊界回彈等視覺效果
auto依瀏覽器預設行為依預設行為
contain阻止可保留
none阻止同時抑制

單純希望側欄捲到底後停住,可先選 contain。需要連容器邊界效果一起抑制,再評估 none。具體手勢效果受瀏覽器與作業系統影響;CSSWG 規範與 MDN 屬性文件描述了這個區分,實際裝置仍須驗收。

用一個可獨立開啟的面板測試#

將下列完整 HTML 存成 scroll-chain.html,在瀏覽器開啟。外頁刻意留出捲動高度,面板限制為 12rem,方便觀察到達邊界後是否帶動背景。

<!doctype html>
<html lang="zh-TW">
<meta charset="utf-8">
<title>捲動串連測試</title>
<style>
body { font: 18px/1.6 sans-serif; margin: 2rem; min-height: 180vh; }
.messages {
max-width: 28rem;
height: 12rem;
overflow-y: auto;
overscroll-behavior-y: contain;
border: 2px solid #16736b;
padding: 1rem;
}
.messages p { margin: 0 0 2rem; }
</style>
<h1>把游標放進面板,再捲到最底</h1>
<div class="messages" tabindex="0" role="region" aria-label="測試訊息">
<p>訊息一:第一段可見內容。</p>
<p>訊息二:繼續向下捲動。</p>
<p>訊息三:確認面板自己的捲軸。</p>
<p>訊息四:接近底部。</p>
<p>訊息五:到底後繼續滑動,觀察外頁。</p>
<p>訊息六:最後一段。</p>
</div>
<p>把游標移出面板後,外頁仍可捲動。</p>
</html>

在 DevTools 選取 .messages,先核對 scrollHeight > clientHeight。如果不成立,表示目前沒有可比較的垂直溢出量。捲到最底後再看 scrollTop 是否接近 scrollHeight - clientHeight,避免把「尚未到底」誤認成隔離成功。

接著用相同手勢比較 auto 與 contain:游標保持在面板內,到底後繼續向下滑,觀察外頁是否移動;再把游標移到面板外,確認整頁仍能捲。最後換 none,檢查你在意的回彈效果。

設在裝飾外框上,可能控制不到內層#

實際元件常分成外框、標題與訊息清單。若 overflow-y: auto 在訊息清單上,就把 overscroll 設在那一層,因為這個屬性不會繼承。把它設在沒有負責捲動的外框,無法替內層完成這個工作。

Flex 欄位若被內容撐開,請先對照 min-height: 0 與內部捲動。如果需求是只有一個軸能捲,則看單軸捲動容器;那篇處理 overflow 軸向,這篇處理到達邊界後的串連。

iframe 的捲動容器位於其文件內,應在框架文件內處理相關根元素,而非只對外面的 iframe 元素設屬性。跨來源頁面能否調整,取決於你是否控制該文件。MDN 的 iframe 限制

面板邊界與整頁鎖定分開驗收#

contain 對面板內開始的捲動控制邊界,游標移到面板外仍能捲頁面。Modal 若要求整個背景完全不能動,需另外設計背景捲動鎖定、焦點與關閉後還原;可從原生 dialog 的關閉流程一起檢查。

這份範例供本機重現與比較,本文只檢閱 HTML/CSS 和官方語意,尚未執行真實滾輪、觸控或跨瀏覽器驗收。程式呼叫 scrollTop 能驗尺寸與位置,合成 WheelEvent 也不等同真實裝置的預設捲動,驗收時保留手勢測試這一關。

參考資料:

CSSWG:CSS Overscroll Behavior Module Level 1

MDN:CSS overscroll behavior

MDN:overscroll-behavior

CSS overscroll-behavior:面板捲到底後,如何停止帶動整頁
https://laplusda.com/posts/css-overscroll-behavior-scroll-chaining/
作者
Zero
發佈於
2026-11-18
許可協議
CC BY-NC-SA 4.0