Tooltipster 是一個輕量級的 jQuery 工具提示插件,能快速幫你產生外觀精美的提示框,且樣式 100% 由 CSS 掌控。
下載 Tooltipster 後,把 tooltipster.css 移到 CSS 目錄、jquery.tooltipster.min.js 移到 JavaScript 目錄,接著在 <head> 中載入:
<head>
<link rel="stylesheet" type="text/css" href="css/tooltipster.css" />
<script type="text/javascript" src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
<script type="text/javascript" src="js/jquery.tooltipster.min.js"></script>
</head>
為了讓 Tooltipster 運作,需要為想要有提示的元素加上 .tooltip class(或任何你選定的 class),並透過 title 屬性指定提示內容。
<img src="my-image.png" class="tooltip"
title="這是我的圖片提示訊息!" alt="圖片說明" />
<a href="https://calebjacob.com" class="ketchup tooltip"
title="這是我的連結提示訊息!">Link</a>
<div class="tooltip" title="這是我的 div 提示訊息!">
滑過這個區塊就會出現提示!
</div>
最後在 </head> 之前加上啟用腳本:
<script>
$(document).ready(function() {
$('.tooltip').tooltipster();
});
</script>
$('.tooltip').tooltipster({
theme: 'tooltipster-light', // 主題
animation: 'fade', // fade / grow / swing / slide / fall
delay: 200, // 顯示前的延遲毫秒數
speed: 300, // 動畫速度
trigger: 'hover', // hover / click / custom
position: 'top', // top / bottom / left / right / auto
interactive: false, // 是否允許游標移入提示框中互動
maxWidth: 300
});
interactive: true 是個實用設定——預設情況下游標一移出觸發元素,提示就會消失,若提示內容中有連結就點不到。開啟後可讓游標移進提示框裡操作。
Tooltipster 為了避免瀏覽器原生的黃色提示框與自製提示重疊,會在初始化時把 title 的內容移走。這意味著:
較好的做法是用 data-* 屬性承載內容,並透過 contentAsHTML 或 functionBefore 回呼指定來源:
<button class="tooltip" data-tip="這是提示內容" aria-label="更多資訊">?</button>
$('.tooltip').tooltipster({
content: $(this).data('tip')
});
工具提示的本質是「補充說明」,其中的內容不該是唯一能取得該資訊的途徑。原因是:
trigger: 'click' 或 focus 事件才能觸發。必要資訊請直接寫在頁面上,或用 aria-describedby 明確關聯:
<button aria-describedby="tip1">送出</button>
<span id="tip1" role="tooltip">送出後將無法修改</span>
插件宣称支援 IE7/8/9,但這些瀏覽器早已不在微軟支援週期中,全球使用率趨近於零。新專案不必為此增加測試負擔。
這個需求如今有更輕的選擇:
::after 搭配 :hover/:focus-visible 就能做出基本提示,零 JavaScript。popover API:新標準,天生支援 top layer 顯示、輕量化 dismiss 與鍵盤操作。<style>
[data-tip] { position: relative; }
[data-tip]::after {
content: attr(data-tip);
position: absolute;
bottom: 100%;
left: 50%;
transform: translateX(-50%);
/* 其他樣式... */
opacity: 0;
pointer-events: none;
transition: opacity .2s;
}
[data-tip]:hover::after,
[data-tip]:focus-visible::after { opacity: 1; }
</style>