[FEE-11001] CSS Anchor Positioning — 錨點定位
INFO
使用純 CSS 將任何浮動覆蓋層(工具提示、下拉選單、popover)繫結至頁面上的任意元素,具備自動溢出重定位功能,完全不需要 JavaScript。
Baseline Newly Available
Supported in Chrome 125+, Firefox 130+, Safari 18.4+. Use progressive enhancement for older browsers.
背景
每位曾經建立工具提示、下拉選單或右鍵選單的開發者都遇過同樣的困境:CSS position: absolute 會相對於最近的定位祖先(positioned ancestor)來計算偏移量,而非相對於 DOM 樹中任意的兄弟或表親元素。錨點元素與浮動覆蓋層往往存在於不同的堆疊上下文(stacking context)、不同的捲動容器,或單純處於不同的巢狀深度。
傳統的解決方案是 JavaScript:
- 以
getBoundingClientRect()讀取錨點元素的位置。 - 計算覆蓋層應該放置的位置。
- 以命令式(imperatively)設定
top和left。 - 接上
ResizeObserver和捲動事件監聽器,以保持同步。 - 在每次 resize 和裝置方向改變時重複以上步驟。
Popper.js 和 Floating UI 等函式庫多年來可靠地解決了這個問題,但它們增加了傳輸量、需要在 UI 正確顯示之前解析並執行 JavaScript,且在第一次繪製(paint)前的定位計算完成之前,可能會出現短暫的錯位閃爍(FOMC,flash of mispositioned content)。
CSS Anchor Positioning 將所有這些工作移入瀏覽器的版面計算引擎(layout engine)。瀏覽器在處理所有其他幾何運算的同一次版面計算中,同時計算錨點位置——在繪製之前,而非之後。不需要 ResizeObserver 迴圈,不需要捲動監聽器,定位本身完全不需要 JavaScript。
情境
你正在程式碼區塊內建立一個「複製到剪貼簿」按鈕。當使用者點擊時,一個小型「已複製!」工具提示應出現在按鈕上方。若按鈕靠近視口頂端,工具提示應自動翻轉到按鈕下方,而不是溢出螢幕外。工具提示使用 Popover API 以確保無障礙性(accessibility)。
使用傳統 CSS,你需要 JavaScript 來測量按鈕位置並以命令式撰寫 top/left 樣式。使用 CSS Anchor Positioning,包含溢出回退(overflow fallback)的整個定位關係都可以用 CSS 宣告式描述。
最佳實踐
- MUST 為任何可能出現在螢幕邊緣附近的錨點定位元素定義
position-try-fallbacks。沒有回退方案,覆蓋層將會被裁切或溢出視口。 - SHOULD 將 CSS Anchor Positioning 與 Popover API 搭配使用,免費獲得無障礙焦點管理(focus management)和鍵盤關閉功能,不需要額外 JavaScript。
- MUST NOT 將 CSS Anchor Positioning 用於文件版面——區塊元素、格線軌道或頁面結構。此功能專為浮動在正常流(normal flow)之上的覆蓋層而設計。
- 在觸發覆蓋層的互動元素(按鈕、連結或輸入框)上使用
anchor-name,而非包裝用的<div>。這使錨點在語意上與使用者互動的元素保持關聯。 - MUST 採用漸進增強(progressive enhancement)。將錨點定位屬性包在
@supports (anchor-name: --x)區塊中,使舊版瀏覽器能夠回退到靜態或 JavaScript 驅動的定位,而非破損的版面。 - 在列表或重複元件中,使用
anchor-scope防止anchor-name值洩漏到其他列表項目,並意外指向錯誤的錨點。
設計思維
為何需要 JavaScript
CSS 中的 position: absolute 會相對於元素的包含區塊(containing block)解析偏移量,即最近的 position 非 static 的祖先元素(或視口的初始包含區塊)。CSS 沒有任何機制可以說「相對於這個特定兄弟元素做偏移」——CSS 在此之前從未有過跨元素的幾何參考機制。
當 position: absolute 不夠用時,開發者有兩個傳統選項:
- 重構 DOM 使覆蓋層成為錨點的子元素。但若錨點位於
overflow: hidden、CSStransform或will-change上下文中,這樣做將失效——這些都會建立新的堆疊和包含區塊上下文。 - JavaScript 測量,透過
getBoundingClientRect(),雖然有效但每次捲動、resize 和方向改變時都需要重新計算。
Popper.js 與 Floating UI 的解決方式
兩個函式庫都遵循相同模式:開啟時讀取錨點的 DOMRect,進行幾何運算,以計算出的 top/left 設定 position: fixed 或 position: absolute。它們使用 ResizeObserver 偵測尺寸變化,並使用被動捲動監聽器(passive scroll listeners)在捲動時重新計算。結果是正確的定位,但代價是 JavaScript 和瀏覽器版面引擎之間的同步迴圈。
錯位閃爍之所以發生,是因為 JavaScript 在瀏覽器已完成繪製之後才執行。元素首先在其預設位置渲染,然後 JavaScript 移動它,然後瀏覽器再次重繪。
原生 CSS 為何更好
CSS Anchor Positioning 在瀏覽器的版面引擎內部運行,在解析所有其他幾何運算的同一次計算中進行。這意味著:
- 無 FOMC:定位元素在第一次繪製前就被正確放置。
- 無 ResizeObserver:瀏覽器已將元素尺寸追蹤作為版面計算的一部分——不需要獨立的 JavaScript 觀察迴圈。
- 自動捲動追蹤:錨點定位元素在捲動時跟隨其錨點移動,不需要任何
scroll事件監聽器。 - 宣告式溢出處理:
position-try-fallbacks在 CSS 中編碼所有替代位置。瀏覽器自動選擇最合適的方案。
權衡之處在於 CSS Anchor Positioning 只適用於 position: absolute 或 position: fixed 的元素——它不適用於正常流中的元素。
範例
一個「複製」按鈕,其工具提示預設出現在按鈕上方,當按鈕靠近視口頂端時自動重定位到下方。
<div class="code-block">
<pre><code>const x = 1;</code></pre>
<button class="copy-btn" id="copy-btn" popovertarget="copy-tooltip">
Copy
</button>
<div id="copy-tooltip" class="tooltip" popover>Copied!</div>
</div>/* Fallback for unsupported browsers */
.tooltip {
position: fixed;
top: 50%;
left: 50%;
transform: translate(-50%, -50%);
}
/* Anchor positioning where supported */
@supports (anchor-name: --x) {
.copy-btn {
anchor-name: --copy-btn;
}
.tooltip {
position: absolute;
position-anchor: --copy-btn;
position-area: top center;
position-try-fallbacks: flip-block;
margin: 8px;
/* reset the fallback fixed positioning */
top: unset;
left: unset;
transform: none;
}
}說明
- 觸發按鈕上的
popovertarget="copy-tooltip"屬性,搭配按鈕本身的id="copy-btn",讓瀏覽器得以解析隱式錨點關係——CSS 中的position-anchor屬性可以直接參考此關係,無需重複 CSS 的anchor-name。 position-area: top center將工具提示置於按鈕上方,水平置中。position-try-fallbacks: flip-block告訴瀏覽器:若偏好位置溢出視口,則在塊軸(block axis)嘗試鏡像位置(即從上方切換為下方,或反之)。若需要更複雜的多步驟回退,請定義具名的@position-try區塊。@supports (anchor-name: --x)區塊使用最佳實踐中建議的正向形式,僅在支援的瀏覽器中套用錨點定位,區塊外的回退固定定位則處理舊版瀏覽器。
深入探討
inset-area 重新命名
早期草稿與 Chrome 125–128 版本使用屬性名稱 inset-area。CSS 工作小組在 Chrome 129 中將其重命名為 position-area(已出貨)。若你在較舊的文件或教學中遇到 inset-area,請將其視為同一個屬性。兩個名稱指的是相同的格線式定位(grid-based positioning)簡寫;position-area 是目前的正式名稱。
同樣地,position-try-options 是 position-try-fallbacks 的早期名稱。只有 position-try-fallbacks 是目前正確的用法。
anchor() 函式
若要精確的邊對邊定位,使用 anchor() 函式取代 position-area:
.tooltip {
position: absolute;
position-anchor: --copy-btn;
/* 工具提示左邊緣 = 錨點右邊緣 */
left: anchor(right);
/* 工具提示上邊緣 = 錨點下邊緣 */
top: anchor(bottom);
}anchor() 接受邊側關鍵字:top、right、bottom、left、start、end、self-start、self-end、center 或百分比。這讓你能精確控制定位元素的哪條邊對齊錨點的哪條邊。
anchor-size() 函式
若要相對於錨點調整覆蓋層大小:
.dropdown {
position: absolute;
position-anchor: --trigger;
/* 完全符合錨點寬度 */
width: anchor-size(width);
/* 或以錨點寬度為上限 */
max-width: anchor-size(width);
}anchor-size() 接受 width、height、block、inline、self-block 或 self-inline。
使用 @position-try 建立具名回退規則
對於涉及不只是不同 position-area 的複雜回退,使用 @position-try 定義具名規則集:
@position-try --flip-below {
position-area: bottom center;
margin-top: 8px;
margin-bottom: 0;
}
@position-try --flip-right {
position-area: right span-top;
margin-left: 8px;
}
.tooltip {
position: absolute;
position-anchor: --copy-btn;
position-area: top center;
margin-bottom: 8px;
/* 依序嘗試具名回退 */
position-try-fallbacks: --flip-below, --flip-right;
}瀏覽器依序嘗試每個回退,並使用第一個使定位元素完全符合其捲動容器的方案。
隱式錨點
若 popover 透過 popovertarget / id 屬性與其觸發器關聯,觸發器自動成為 popover 的隱式錨點。在這種情況下,CSS 中的 position-anchor 可以省略:
/* 當 HTML 錨點關聯已設定時,此寫法有效 */
.tooltip {
position: absolute;
position-area: top center;
position-try-fallbacks: flip-block;
}仍建議明確宣告 position-anchor,特別是當 CSS 單獨閱讀時,以提高可讀性。
與 overflow: hidden 的互動
錨點定位是相對於包含錨點的捲動容器(scroll container)解析,而非 CSS 包含區塊。這意味著覆蓋層可以逸出帶有 overflow: hidden 的父元素,前提是該父元素不是捲動容器。但若覆蓋層離開最近的捲動容器,仍然會被裁切——它不會自動逸出到視口,除非使用 position: fixed。
對於必須逸出所有溢出限制的工具提示,使用 position: fixed 搭配錨點定位。position: fixed 使捲動容器成為視口,而錨點定位仍然正常運作。
anchor-scope
在列表或重複元件中,多個元素可能共享相同的 anchor-name 值。預設情況下,定位元素會找到 DOM 順序中最後一個具有相符名稱的錨點,這幾乎不是列表場景中你想要的行為。
anchor-scope 將可參考特定 anchor-name 的定位元素限制在一個子樹範圍內:
.list-item {
/* 限定範圍,使此項目中的錨點只匹配此項目內的 popover */
anchor-scope: --item-anchor;
}
.list-item .trigger {
anchor-name: --item-anchor;
}
.list-item .menu {
position: absolute;
position-anchor: --item-anchor;
position-area: bottom span-right;
}anchor-scope 接受單一 <dashed-ident> 或關鍵字 all。使用 all 可將子樹中宣告的所有 anchor-name 一次限定範圍,對於定義了許多錨點的複雜元件樹來說,是一個方便的全面防護。
注意 anchor-scope 只影響名稱解析,不影響溢出或包含行為。
常見錯誤
在視口邊緣附近忘記設定 position-try-fallbacks。 未設定回退方案的錨點定位工具提示,在錨點靠近視口上下左右邊緣時將溢出或被裁切。對垂直擺放的覆蓋層,至少宣告 position-try-fallbacks: flip-block;對水平擺放的,使用 flip-inline。
將 anchor-name 套用在包裝用的 <div> 而非互動元素上。 螢幕閱讀器和鍵盤導覽預期互動元素(按鈕、連結、輸入框)與其覆蓋層之間存在無障礙關聯。將 anchor-name 放在非互動的祖先元素上會切斷這層關聯。
將 CSS Anchor Positioning 用於正常流版面。position-area 和 anchor() 等屬性只對 position: absolute 或 position: fixed 的元素有效。將它們套用在正常流中的區塊級元素上不會產生任何效果,也會誤導閱讀 CSS 的人。
誤以為必須用 position: fixed 才能逸出 overflow: hidden。position: fixed 確實有效,但它同時將元素從捲動容器的座標系中移除,可能導致覆蓋層在頁面捲動時無法跟隨錨點。應優先使用 position: absolute,除非明確需要相對視口的定位;先確認 overflow: hidden 的祖先是否為捲動容器——若不是,position: absolute 本身就能逸出它。
省略 @supports 包裝。 沒有功能偵測,錨點定位屬性在舊版瀏覽器中會靜默忽略——但若你忘記重設,@supports 區塊內的屬性可能覆蓋你在外部設定的回退樣式。請始終在 @supports 區塊之外搭配一個回退方案。
瀏覽器支援
| 瀏覽器 | 首次支援版本 | 備註 |
|---|---|---|
| Chrome | 125 | Interop 2025 參與者 |
| Firefox | 130 | |
| Safari | 18.4 | |
| Edge | 125 | 基於 Chromium |
使用 @supports 的漸進增強模式:
@supports (anchor-name: --x) {
/* 錨點定位樣式 */
}或在 JavaScript 中進行功能偵測,以決定是否啟用覆蓋層函式庫:
const supportsAnchorPositioning =
CSS.supports('anchor-name', '--x');內部參考
- FEE-11002 Container Queries — 錨點定位與容器查詢都使用包含(containment)概念:錨點定位透過
anchor-scope將名稱解析限定在子樹中,而容器查詢則將樣式計算限定在容器子樹中。 - FEE-11101 @starting-style —
@starting-style常與錨點定位的 popover 搭配使用,為覆蓋層的進場轉場(例如從錨點方向淡入)製作動畫,不需要 JavaScript。