<button> + <div role="tooltip">。<button class="tooltip-trigger" aria-describedby="tip-1">懸停我</button>
<div id="tip-1" role="tooltip" class="tooltip">
這是提示內容,支援多行文字與簡單 HTML。
</div>
**雙層三角形疊加法**:外層邊框色、內層背景色,垂直錯開 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; /* 背景色 */
}
.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; }
}
未來標準方案,無需 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>。