Cluetip 專為**關鍵詞/術語提示**設計:滑鼠懸停/點擊顯示豐富內容 (HTML、圖片、AJAX 載入頁面片段)。適合技術文檔、產品介紹、百科詞條等場景。
官網:GitHub (含詳細文檔與 Demo)
<link rel="stylesheet" href="jquery.cluetip.css" />
<script src="jquery.min.js"></script>
<script src="jquery.cluetip.js"></script>
<!-- 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>
$(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 // 顯示時隱藏原元素
});
});
| 選項 | 預設 | 說明 |
|---|---|---|
| width | 270 | 提示框寬度 (px/%) |
| height | auto | 高度,超出出現滾動條 |
| cluetipClass | 'default' | 自定義主題類別 (CSS 鉤子) |
| cursor | 'pointer' | 滑鼠游標 |
| hoverIntent | false | true=使用 hoverIntent 插件延遲觸發 (防誤觸) |
| sticky | false | true=點擊關閉,不自動隱藏 |
| closePosition | 'top' | 'title' (標題欄) / 'bottom' / 'top' |
| closeText | 'Close' | 關閉按鈕文字/HTML |
| dropShadow | true | 投影效果 (IE9+) |
| positionBy | 'fixed' | 'mouse' (跟隨滑鼠) / 'fixed' (相對元素) |
| topOffset / leftOffset | 15 | 相對定位偏移量 |
| ajaxSettings | {} | $.ajax 額外參數 (dataType, cache, headers...) |
| onShow / onHide | fn | 顯示/隱藏回調 |
<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', ... });
新專案強烈建議 **Tippy.js** (或框架專用組件如 `vue-tippy`、`react-tippy`)。Cluetip 僅用於維護依賴 jQuery 的老專案。