DIV CSS 佈局教程網

jQuery 插件 Tooltipster:快速做出漂亮的工具提示
編輯:JavaScript綜合知識     

Tooltipster 是一個輕量級的 jQuery 工具提示插件,能快速幫你產生外觀精美的提示框,且樣式 100% 由 CSS 掌控。

步驟一:引入 jQuery 與 Tooltipster

下載 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>

步驟二:設定 HTML

為了讓 Tooltipster 運作,需要為想要有提示的元素加上 .tooltip class(或任何你選定的 class),並透過 title 屬性指定提示內容。

為圖片加上提示

<img src="my-image.png" class="tooltip"
     title="這是我的圖片提示訊息!" alt="圖片說明" />

為已具備 class 的連結加上提示

<a href="https://calebjacob.com" class="ketchup tooltip"
   title="這是我的連結提示訊息!">Link</a>

為 div 加上提示

<div class="tooltip" title="這是我的 div 提示訊息!">
  滑過這個區塊就會出現提示!
</div>

步驟三:啟用 Tooltipster

最後在 </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 是個實用設定——預設情況下游標一移出觸發元素,提示就會消失,若提示內容中有連結就點不到。開啟後可讓游標移進提示框裡操作。

特性整理

  • 支援在提示內容中使用 HTML 標籤。
  • 體積輕量。
  • API 靈活、效率高。
  • 樣式定義簡單,100% 由 CSS 控制。
  • 內建多種主題。
  • 支援 Firefox、Chrome、IE7/8/9、Opera、Safari。

幾個實務上的注意事項

title 屬性會被清空

Tooltipster 為了避免瀏覽器原生的黃色提示框與自製提示重疊,會在初始化時把 title 的內容移走。這意味著:

  • 若 JavaScript 失效,提示內容也一起消失。
  • 螢幕閱讀器可能讀不到原本的 title 資訊。

較好的做法是用 data-* 屬性承載內容,並透過 contentAsHTML 或 functionBefore 回呼指定來源:

<button class="tooltip" data-tip="這是提示內容" aria-label="更多資訊">?</button>

$('.tooltip').tooltipster({
  content: $(this).data('tip')
});

不要讓提示承載關鍵資訊

工具提示的本質是「補充說明」,其中的內容不該是唯一能取得該資訊的途徑。原因是:

  • 觸控裝置上沒有 hover,提示根本不會出現。
  • 鍵盤使用者需要元素可 focus 並搭配 trigger: 'click' 或 focus 事件才能觸發。
  • 螢幕閱讀器對 title 的支援各家不一。

必要資訊請直接寫在頁面上,或用 aria-describedby 明確關聯:

<button aria-describedby="tip1">送出</button>
<span id="tip1" role="tooltip">送出後將無法修改</span>

IE7/8 的支援已無意義

插件宣称支援 IE7/8/9,但這些瀏覽器早已不在微軟支援週期中,全球使用率趨近於零。新專案不必為此增加測試負擔。

現代替代方案

這個需求如今有更輕的選擇:

  • CSS-only tooltip:用 ::after 搭配 :hover/:focus-visible 就能做出基本提示,零 JavaScript。
  • 原生 popover API:新標準,天生支援 top layer 顯示、輕量化 dismiss 與鍵盤操作。
  • Tippy.js:以 Popper.js 為基礎做定位,能正確處理邊界碰撞與捲動,API 與 Tooltipster 相似但更現代。
  • Floating UI:Popper.js 的後繼者,若你只需要「把浮層放在正確位置」,直接用這套定位引擎最合適。
<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>
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved