Skip to content

CSS Anchor Positioning 實戰:宣告式定位的新範式

前端開發中,浮動元素的定位一直是個讓人頭疼的問題。Tooltip、Popover、Dropdown 這些元件的核心需求很簡單——「貼著某個元素顯示」,但實作起來卻需要處理邊界檢測、翻轉、偏移、捲動跟隨等一整套邏輯。Floating UI、Popper.js 等函式庫的存在本身就說明了這個問題的複雜度。CSS Anchor Positioning API 的出現,讓這一切回歸到 CSS 的宣告式範式。

核心概念與瀏覽器支援 ​

Anchor Positioning 的核心思想是:一個元素可以宣告「我要錨定到另一個元素」,然後透過 CSS 屬性描述相對於錨點的位置關係。瀏覽器負責處理邊界檢測和翻轉。

截至 2026 年 7 月,Anchor Positioning 的瀏覽器支援情況:

瀏覽器版本支援狀態
Chrome125+完整支援
Edge125+完整支援
Safari26+完整支援
Firefox138+完整支援
Safari iOS26+完整支援

Chrome 125 在 2024 年 5 月率先支援,到 2026 年主流瀏覽器已全部跟上。這意味著在生產環境中使用 Anchor Positioning 已經是可行方案,但仍需提供 fallback。

anchor-name 與 position-anchor ​

兩個核心屬性構成 Anchor Positioning 的基礎:

css
/* 錨點元素:宣告自己的錨點名稱 */
.anchor-button {
  anchor-name: --tooltip-anchor;
}

/* 浮動元素:宣告自己錨定到誰 */
.tooltip {
  position: fixed;
  position-anchor: --tooltip-anchor;
  /* 相對於錨點定位 */
  top: anchor(bottom);
  left: anchor(center);
  /* 水平居中對齊錨點 */
  translate: -50% 0;
}

anchor-name 在錨點元素上定義一個自訂識別碼(必須以 -- 開頭)。position-anchor 在浮動元素上參考這個識別碼,建立錨定關係。

anchor() 函式是定位的核心,它接受一個方向參數:

  • anchor(top) — 錨點元素的上邊緣
  • anchor(bottom) — 錨點元素的下邊緣
  • anchor(left) — 錨點元素的左邊緣
  • anchor(right) — 錨點元素的右邊緣
  • anchor(center) — 錨點元素的水平中心
  • anchor(center, 50%) — 垂直中心(第二個參數指定百分比)

完整 Tooltip 實作 ​

結合 popover API 實作一個純 CSS 的 Tooltip:

html
<style>
  .tooltip-trigger {
    anchor-name: --trigger-anchor;
    background: #3b82f6;
    color: white;
    border: none;
    padding: 8px 16px;
    border-radius: 6px;
    cursor: pointer;
  }

  .tooltip {
    popover: auto;
    position: fixed;
    position-anchor: --trigger-anchor;
    /* 定位到錨點上方 */
    bottom: anchor(top);
    left: anchor(center);
    transform: translateX(-50%);
    /* 間距 */
    margin-bottom: 8px;

    background: #1f2937;
    color: white;
    padding: 6px 12px;
    border-radius: 4px;
    font-size: 14px;
    white-space: nowrap;

    /* 入場動畫 */
    transition: opacity 0.2s, transform 0.2s;
    transform-origin: bottom center;
  }

  .tooltip:popover-open {
    opacity: 1;
  }

  .tooltip::backdrop {
    background: transparent;
  }
</style>

<button class="tooltip-trigger" popovertarget="my-tooltip">
  懸停查看提示
</button>

<div class="tooltip" id="my-tooltip" role="tooltip">
  這是一個純 CSS Tooltip
</div>

不需要一行 JavaScript。popover API 處理顯示/隱藏,position-anchor 處理定位。

position-try Fallback 策略 ​

Tooltip 在視窗邊緣會被截斷。position-try 讓瀏覽器自動嘗試其他位置:

css
.tooltip {
  position: fixed;
  position-anchor: --trigger-anchor;

  /* 預設位置:上方 */
  bottom: anchor(top);
  left: anchor(center);
  transform: translateX(-50%);
  margin-bottom: 8px;

  /* Fallback:如果上方空間不夠,按順序嘗試其他位置 */
  position-try: flip-block flip-inline;
}

/* 也可以顯式定義 fallback 列表 */
.tooltip-explicit {
  position: fixed;
  position-anchor: --trigger-anchor;
  bottom: anchor(top);
  left: anchor(center);

  /* 顯式列出所有備選位置 */
  position-try-options: --top, --bottom, --left, --right;
}

@position-try --top {
  bottom: anchor(top);
  left: anchor(center);
  transform: translateX(-50%);
  margin-bottom: 8px;
}

@position-try --bottom {
  top: anchor(bottom);
  left: anchor(center);
  transform: translateX(-50%);
  margin-top: 8px;
}

@position-try --left {
  right: anchor(left);
  top: anchor(center);
  transform: translateY(-50%);
  margin-right: 8px;
}

@position-try --right {
  left: anchor(right);
  top: anchor(center);
  transform: translateY(-50%);
  margin-left: 8px;
}

position-try: flip-block 的行為:當預設位置空間不夠時,瀏覽器自動翻轉——上方變下方,下方變上方。flip-inline 則左右翻轉。組合使用 flip-block flip-inline 可以覆蓋四個方向。

@position-try 規則則提供了完全自訂的能力。瀏覽器按 position-try-options 列出的順序逐個嘗試,直到找到能完整顯示的位置。

position-try-fallbacks 優先級控制 ​

css
.dropdown {
  position: fixed;
  position-anchor: --dropdown-trigger;
  top: anchor(bottom);
  left: anchor(left);
  margin-top: 4px;

  /* 策略 1:先嘗試翻轉,再嘗試移動 */
  position-try: flip-block;

  /* 策略 2:允許溢出但不改變尺寸 */
  position-try: flip-block allow-overflow;

  /* 策略 3:翻轉後如果還放不下,改變對齊方式 */
  position-try: flip-block shift-inline;
}

allow-overflow 允許浮動元素溢出視窗而非翻轉,適用於內容不可裁剪的場景。shift-inline 在翻轉後仍放不下時,沿水平方向滑動而非保持居中對齊。

css
.dropdown-menu {
  popover: auto;
  position: fixed;
  position-anchor: --menu-trigger;
  top: anchor(bottom);
  left: anchor(left);
  margin-top: 4px;

  background: white;
  border: 1px solid #e5e7eb;
  border-radius: 8px;
  box-shadow: 0 4px 6px -1px rgb(0 0 0 / 0.1);
  min-width: 200px;
  padding: 4px;

  position-try: flip-block;

  /* 入場動畫 */
  transition: opacity 0.15s ease, transform 0.15s ease;
  transform-origin: top;
}

.dropdown-menu:popover-open {
  opacity: 1;
  transform: scaleY(1);
}

.dropdown-menu:not(:popover-open) {
  opacity: 0;
  transform: scaleY(0.9);
}

.dropdown-item {
  padding: 8px 12px;
  border-radius: 4px;
  cursor: pointer;
  display: flex;
  align-items: center;
  gap: 8px;
}

.dropdown-item:hover {
  background: #f3f4f6;
}
html
<button class="menu-trigger" popovertarget="menu" style="anchor-name: --menu-trigger">
  選單
  <svg width="12" height="12"><!-- arrow icon --></svg>
</button>

<div class="dropdown-menu" id="menu" role="menu">
  <div class="dropdown-item" role="menuitem">編輯</div>
  <div class="dropdown-item" role="menuitem">複製</div>
  <div class="dropdown-item" role="menuitem">刪除</div>
</div>

與 JavaScript 定位方案的對比 ​

以 Floating UI 為例,實作同等功能需要的程式碼量:

typescript
// Floating UI 實作
import { computePosition, flip, shift, offset, autoUpdate } from '@floating-ui/dom'

const trigger = document.querySelector('.trigger')
const tooltip = document.querySelector('.tooltip')

function update() {
  computePosition(trigger, tooltip, {
    placement: 'top',
    middleware: [offset(8), flip(), shift({ padding: 8 })],
  }).then(({ x, y }) => {
    Object.assign(tooltip.style, {
      left: `${x}px`,
      top: `${y}px`,
    })
  })
}

autoUpdate(trigger, tooltip, update)

// 還需要手動處理顯示/隱藏
trigger.addEventListener('mouseenter', () => {
  tooltip.style.display = 'block'
  update()
})
trigger.addEventListener('mouseleave', () => {
  tooltip.style.display = 'none'
})
維度CSS Anchor PositioningFloating UI / Popper.js
程式碼量~20 行 CSS~30 行 JS + 依賴套件
執行時效能瀏覽器原生,零開銷ResizeObserver + scroll 監聽
套件體積0 KB3-15 KB(gzip)
SSR 友好是(純 CSS)否(需要客戶端 hydration)
靈活性有限的 fallback 策略完全可程式化的 middleware
瀏覽器相容2026 主流全覆蓋全相容(IE11+)
動態內容自動跟隨需要手動呼叫 update

Anchor Positioning 在簡單場景下幾乎可以完全替代 JS 方案。但在需要複雜邏輯(如 sticky 定位、虛擬化列表內的 tooltip、跨 iframe 定位)時,Floating UI 仍然更合適。

無障礙(a11y)考量 ​

Popover API 的 popover 屬性自帶部分無障礙特性:

  • popover="auto" 會自動處理焦點陷阱(focus trap)
  • 按 Escape 自動關閉
  • 點擊外部自動關閉
  • aria-expanded 需要手動管理
html
<button
  class="tooltip-trigger"
  popovertarget="my-tooltip"
  aria-describedby="my-tooltip"
  style="anchor-name: --trigger-anchor"
>
  操作按鈕
</button>

<div
  class="tooltip"
  id="my-tooltip"
  role="tooltip"
  popover="auto"
>
  點擊此按鈕執行操作
</div>

role="tooltip" 配合 aria-describedby 確保螢幕閱讀器能正確關聯提示資訊。對於 Dropdown 類元件,需要手動實作鍵盤導航:

javascript
// 最小化的鍵盤導航補充
const menu = document.querySelector('#menu')
const trigger = document.querySelector('[popovertarget="menu"]')

trigger.addEventListener('click', () => {
  if (menu.matches(':popover-open')) {
    const firstItem = menu.querySelector('[role="menuitem"]')
    firstItem?.focus()
  }
})

menu.addEventListener('keydown', (e) => {
  const items = [...menu.querySelectorAll('[role="menuitem"]')]
  const currentIndex = items.indexOf(document.activeElement)

  if (e.key === 'ArrowDown') {
    e.preventDefault()
    items[(currentIndex + 1) % items.length]?.focus()
  } else if (e.key === 'ArrowUp') {
    e.preventDefault()
    items[(currentIndex - 1 + items.length) % items.length]?.focus()
  } else if (e.key === 'Escape') {
    trigger.focus()
  }
})

瀏覽器相容性處理 ​

使用 @supports 檢測並提供 fallback:

css
/* Fallback: 不支援 Anchor Positioning 時使用絕對定位 */
.tooltip {
  position: absolute;
  top: 100%;
  left: 50%;
  transform: translateX(-50%);
  margin-top: 8px;
}

@supports (anchor-name: --x) {
  .tooltip {
    position: fixed;
    position-anchor: --trigger-anchor;
    bottom: anchor(top);
    left: anchor(center);
    transform: translateX(-50%);
    margin-top: 0;
    margin-bottom: 8px;
  }
}

對於需要完整 fallback 的專案,可以使用 @floating-ui/dom 作為 polyfill:

javascript
// 檢測是否支援 Anchor Positioning
const supportsAnchor = CSS.supports('anchor-name: --x')

if (!supportsAnchor) {
  // 降級到 Floating UI
  const { autoUpdate, computePosition, offset, flip, shift } = await import(
    '@floating-ui/dom'
  )
  // 初始化所有 .tooltip 元素
}

漸進增強策略:現代瀏覽器獲得原生體驗,舊瀏覽器使用 JS fallback,兩種方案透過 @supports 切換。

優缺點分析 ​

優點:

  • 零 JavaScript 執行時開銷,定位計算由瀏覽器原生完成
  • 與 Popover API 深度整合,顯示/隱藏/定位一體化
  • 宣告式語法比命令式 JS 更易維護
  • 自動處理捲動、resize 等邊界場景
  • SSR 友好,不依賴客戶端 JS

缺點:

  • Fallback 策略不如 Floating UI 靈活,複雜場景受限
  • 動態錨點(如列表項的 tooltip)需要動態設定 anchor-name,仍需少量 JS
  • 動畫控制受限於 CSS transition,無法實作基於物理的彈性動畫
  • 跨容器定位(如 modal 內的 tooltip)存在 stacking context 問題
  • 除錯工具不完善,Chrome DevTools 對 anchor 關係的視覺化仍需改進

未來展望 ​

CSS Anchor Positioning Level 2 正在討論以下擴展:

  • anchor-scroll — 支援錨點在捲動容器內的定位
  • anchor-pos — 更精細的位置控制,支援百分比和計算
  • 與 View Transitions API 的整合 — 定位變化時的平滑過渡
  • anchor-match — 基於錨點狀態的條件樣式

這些擴展將進一步縮小與 JS 方案的能力差距。

個人觀點 ​

Anchor Positioning 是 CSS 回歸宣告式本質的又一個里程碑。從 Flexbox 到 Grid 到 Container Queries 再到 Anchor Positioning,CSS 正在逐步收回被 JavaScript 占據的領域。對於絕大多數 Tooltip 和 Dropdown 場景,純 CSS 方案已經足夠,而且效能更好、程式碼更少。

但我不建議在生產環境中完全拋棄 Floating UI。原因有兩點:一是相容性過渡期需要 polyfill,二是複雜場景(如富文本編輯器內的浮動選單)仍然需要 JS 的精確控制。務實的做法是:簡單場景用 CSS,複雜場景用 JS,透過 @supports 讓兩者共存。

小結 ​

CSS Anchor Positioning 透過 anchor-name、position-anchor 和 anchor() 函式實現了宣告式定位,position-try 處理邊界翻轉。配合 Popover API,可以在純 CSS 中實作完整的 Tooltip、Dropdown 元件。與 Floating UI 相比,它零執行時開銷、SSR 友好,但靈活性有限。在 2026 年的瀏覽器環境下,Anchor Positioning 已具備生產可用性,建議採用漸進增強策略:原生優先,JS fallback 兜底。

MIT Licensed