萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> Div CSS 教學

純 CSS 實現跨瀏覽器 Tooltip 提示框:帶邊框三角形、無障礙、響應式

設計需求

  • 語義化 HTML:<button> + <div role="tooltip">。
  • 純 CSS:無 JS 依賴,懸停/聚焦顯示。
  • 帶邊框三角指標:視覺連貫性。
  • 無障礙:ARIA 屬性、鍵盤觸發、減動偏好。
  • 響應式:視窗邊界自動翻轉 (需 CSS Anchor Positioning 或 JS 輔助)。

核心 HTML

<button class="tooltip-trigger" aria-describedby="tip-1">懸停我</button>
<div id="tip-1" role="tooltip" class="tooltip">
  這是提示內容,支援多行文字與簡單 HTML。
</div>

核心 CSS:帶邊框三角形原理

**雙層三角形疊加法**:外層邊框色、內層背景色,垂直錯開 1px (邊框寬度)。

.tooltip {
  position: absolute;
  max-width: 300px;
  padding: 0.5rem 0.75rem;
  background: #d7e7fc;          /* 背景色 */
  border: 1px solid #a5c4ec;    /* 邊框色 */
  border-radius: 4px;
  font-size: 0.875rem;
  line-height: 1.5;
  color: #1a1a1a;
  z-index: 100;
  opacity: 0;
  visibility: hidden;
  transform: translateY(4px);
  transition: opacity .15s, visibility .15s, transform .15s;
  pointer-events: none; /* 避免鼠標進入 tooltip 觸發閃爍 */
}

/* 觸發顯示 */
.tooltip-trigger:hover + .tooltip,
.tooltip-trigger:focus + .tooltip,
.tooltip:hover { /* 允許鼠標移入 tooltip 內容 */
  opacity: 1;
  visibility: visible;
  transform: translateY(0);
}

/* 三角形:外層邊框色 */
.tooltip::before {
  content: '';
  position: absolute;
  bottom: 100%; left: 50%;
  margin-left: -8px;
  border: 8px solid transparent;
  border-bottom-color: #a5c4ec; /* 邊框色 */
}

/* 三角形:內層背景色,向上偏移 1px 覆蓋外層底邊 */
.tooltip::after {
  content: '';
  position: absolute;
  bottom: calc(100% - 1px); left: 50%;
  margin-left: -7px; /* border-width - 1px */
  border: 7px solid transparent;
  border-bottom-color: #d7e7fc; /* 背景色 */
}

四方向定位 (CSS 邏輯屬性)

.tooltip[data-placement="top"]::before,
.tooltip[data-placement="top"]::after { bottom: 100%; left: 50%; transform: translateX(-50%); }
.tooltip[data-placement="bottom"]::before,
.tooltip[data-placement="bottom"]::after { top: 100%; left: 50%; transform: translateX(-50%); }
.tooltip[data-placement="left"]::before,
.tooltip[data-placement="left"]::after { right: 100%; top: 50%; transform: translateY(-50%); }
.tooltip[data-placement="right"]::before,
.tooltip[data-placement="right"]::after { left: 100%; top: 50%; transform: translateY(-50%); }

/* 對應邊框顏色旋轉 */
.tooltip[data-placement="top"]::before    { border-bottom-color: #a5c4ec; }
.tooltip[data-placement="bottom"]::before { border-top-color: #a5c4ec; }
.tooltip[data-placement="left"]::before   { border-right-color: #a5c4ec; }
.tooltip[data-placement="right"]::before  { border-left-color: #a5c4ec; }
/* ::after 同理調整 border-*color 為背景色 */

無障礙完善

.tooltip-trigger:focus { outline: 2px solid #3498db; outline-offset: 2px; }

/* 減動偏好 */
@media (prefers-reduced-motion: reduce) {
  .tooltip { transition: none; transform: none; }
  .tooltip-trigger:hover + .tooltip,
  .tooltip-trigger:focus + .tooltip { opacity: 1; visibility: visible; }
}

/* 高對比模式 */
@media (forced-colors: active) {
  .tooltip { border: 1px solid CanvasText; background: Canvas; }
  .tooltip::before { border-bottom-color: CanvasText; }
  .tooltip::after { border-bottom-color: Canvas; }
}

進階:CSS Anchor Positioning (實驗性,Chrome 109+)

未來標準方案,無需 JS 計算座標,自動翻轉避開視窗邊界:

.tooltip-trigger { anchor-name: --tooltip-anchor; }
.tooltip {
  position: absolute;
  position-anchor: --tooltip-anchor;
  position-try-options: 
    flip-block,           /* 垂直翻轉 */
    flip-inline,          /* 水平翻轉 */
    flip-block flip-inline; /* 兩軸翻轉 */
  /* 箭頭自動指向錨點 */
  position-try-order: normal;
}

總結

純 CSS Tooltip 核心在於:**相對/絕對定位配合**、**雙偽元素疊加三角形**、**狀態偽類觸發**、**無障礙屬性**。現代專案建議封裝為 Web Component (<app-tooltip>),內部處理定位邏輯、ARIA、焦點管理,外部僅需 <app-tooltip text="提示">懸停元素</app-tooltip>。

copyright © 萬盛學電腦網 all rights reserved