萬盛學電腦網

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

jQuery Tooltip 插件 Cluetip 使用指南:關鍵詞智能提示與內容載入

插件定位

Cluetip 專為**關鍵詞/術語提示**設計:滑鼠懸停/點擊顯示豐富內容 (HTML、圖片、AJAX 載入頁面片段)。適合技術文檔、產品介紹、百科詞條等場景。

官網:GitHub (含詳細文檔與 Demo)

核心功能

  • **多種觸發**:`hover` (預設)、`click`、`focus`。
  • **內容來源**:`title` 屬性 (支援分隔符分標題/內容)、`rel`/`href` 指向 URL (AJAX 載入)、`id` 關聯頁面隱藏元素。
  • **智能定位**:自動翻轉避開視窗邊緣,支援 `positionBy: 'mouse'` 跟隨滑鼠。
  • **黏性模式** (`sticky: true`):點擊關閉按鈕才消失,適合表單/複雜內容。
  • **豐富回調**:`onShow`、`onHide`、`onActivate`、`ajaxProcess`。

快速上手

1. 引入資源

<link rel="stylesheet" href="jquery.cluetip.css" />
<script src="jquery.min.js"></script>
<script src="jquery.cluetip.js"></script>

2. HTML 標記

<!-- 1. title 直接提示 (標題|內容) -->
<a href="#" class="javascript" title="JavaScript|動態腳本語言">JavaScript</a>

<!-- 2. AJAX 載入外部頁面片段 -->
<a href="ajax3.html" class="html">HTML5</a> <!-- 載入 ajax3.html 內容 -->

<!-- 3. 關聯頁面隱藏區塊 -->
<a href="#hiddenContent" class="local">本地內容</a>
<div id="hiddenContent" style="display:none"><h3>詳細說明</h3><p>...</p></div>

3. JS 初始化

$(function() {
    // 方案 1: title 分隔符
    $('a.javascript').cluetip({
        splitTitle: '|',        // 標題|內容 分隔符
        showTitle: false,       // 不顯示標題欄
        width: '200px'
    });

    // 方案 2: AJAX 載入 + 黏性 + 自定關閉按鈕
    $('a.html').cluetip({
        splitTitle: '|',
        sticky: true,                    // 點擊關閉按鈕才關閉
        closeText: '<img src="cross.png" alt="關閉" />', // 自定關閉圖示
        closePosition: 'title',          // 關閉鈕放標題欄
        dropShadow: false,               // 關閉陰影
        positionBy: 'mouse',             // 跟隨滑鼠
        // truncate: 60                 // 截斷長度
    });

    // 方案 3: 本地隱藏元素
    $('a.local').cluetip({
        local: true,          // 從 href="#id" 獲取內容
        hideLocal: true       // 顯示時隱藏原元素
    });
});

常用選項速查表

選項預設說明
width270提示框寬度 (px/%)
heightauto高度,超出出現滾動條
cluetipClass'default'自定義主題類別 (CSS 鉤子)
cursor'pointer'滑鼠游標
hoverIntentfalsetrue=使用 hoverIntent 插件延遲觸發 (防誤觸)
stickyfalsetrue=點擊關閉,不自動隱藏
closePosition'top''title' (標題欄) / 'bottom' / 'top'
closeText'Close'關閉按鈕文字/HTML
dropShadowtrue投影效果 (IE9+)
positionBy'fixed''mouse' (跟隨滑鼠) / 'fixed' (相對元素)
topOffset / leftOffset15相對定位偏移量
ajaxSettings{}$.ajax 額外參數 (dataType, cache, headers...)
onShow / onHidefn顯示/隱藏回調

自定義主題樣式

<style>
.my-cluetip { border: 2px solid #4ba9e6; background: #f3faff; border-radius: 4px; box-shadow: 0 4px 12px rgba(0,0,0,0.15); }
.my-cluetip .cluetip-title { background: #4ba9e6; color: #fff; padding: 8px 12px; font-weight: bold; border-radius: 2px 2px 0 0; }
.my-cluetip .cluetip-inner { padding: 12px; }
.my-cluetip .cluetip-close { color: #fff; font-size: 1.2em; line-height: 1; }
</style>

$('a.term').cluetip({ cluetipClass: 'my-cluetip', ... });

現代替代方案

| 插件 | 依賴 | 體積 | 特色 | 維護 | |------|------|------|------|------| | **Cluetip** | jQuery | 8KB | AJAX載入、黏性、跟隨滑鼠 | 低 (2016年後少更新) | | **Tippy.js** | Popper.js | 12KB | **現代首選**:動畫豐富、無障礙、虛擬定位、React/Vue 綁定 | 高 | | **Tooltipster** | jQuery | 15KB | 多實例、主題、觸控、AJAX | 中 | | **原生 CSS `title` + `::tooltip` (提案)** | 無 | 0 | 未來標準,目前僅 Firefox 部分支援 | 標準化中 |

新專案強烈建議 **Tippy.js** (或框架專用組件如 `vue-tippy`、`react-tippy`)。Cluetip 僅用於維護依賴 jQuery 的老專案。

copyright © 萬盛學電腦網 all rights reserved