萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 插件 Tooltipster:輕量級、高顏值工具提示完整接入指南

為什麼選 Tooltipster?

  • 支援 HTML 內容(不只是純文本)
  • 極輕量(壓縮後約 7KB)
  • 100% CSS 樣式化,主題切換零 JS 改動
  • 內建 3 套主題,兼容 IE7+、Firefox、Chrome、Opera、Safari
  • API 靈活:位置、動畫、觸發方式全可配

三步接入

1. 引入資源

<head>
  <link rel="stylesheet" href="css/tooltipster.css">
  <script src="https://code.jquery.com/jquery-1.7.0.min.js"></script>
  <script src="js/jquery.tooltipster.min.js"></script>
</head>

2. 標記目標元素

給任意元素加 class="tooltip"(或自定義選擇器),並用 title 屬性存放提示內容:

<!-- 圖片 -->
<img src="my-image.png" class="tooltip" title="這是圖片的提示內容!" />

<!-- 已有 class 的鏈接 -->
<a href="https://calebjacob.com" class="ketchup tooltip" title="鏈接提示!">Link</a>

<!-- 區塊元素 -->
<div class="tooltip" title="DIV 的提示!">
  懸停我試試!
</div>

3. 啟用插件

<script>
$(document).ready(function() {
  $('.tooltip').tooltipster();
});
</script>

進階配置示例

$('.tooltip').tooltipster({
  animation: 'fade',        // fade / grow / swing / slide / fall
  delay: 200,               // 延遲顯示/隱藏(ms)
  theme: 'tooltipster-shadow', // 內建主題: default, light, shadow, punk, noir
  side: 'top',              // 顯示位置: top/bottom/left/right
  contentAsHTML: true,      // 允許 HTML 內容
  interactive: true,        // 懸停提示框本身不消失
  functionBefore: function(origin, continue) {
    // 動態加載內容(AJAX)等
    continue('加載中...');
  }
});

常見坑點與解決

  • title 被瀏覽器原生提示覆蓋:Tooltipster 會自動暫存並清空 title,無需手動處理。
  • 動態新增元素:用事件委託 $(document).on('mouseenter', '.tooltip', ...) 或調用 .tooltipster('destroy') 後重新初始化。
  • IE7/8 邊框圓角:使用 tooltipster.css 中的 PIE.htc 或接受降級顯示。

總結

Tooltipster 以「輕、美、活」三大特點,成為工具提示類插件的首選。無論簡單提示還是複雜交互卡片,皆能輕鬆駕馭。

copyright © 萬盛學電腦網 all rights reserved