Bootstrap 提示工具（Tooltip）插件

當您想要描述一個鏈接的時候，提示工具（Tooltip）就顯得非常有用。提示工具（Tooltip）插件是受 Jason Frame 寫的 jQuery.tipsy 的啟發。提示工具（Tooltip）插件做了很多改進，例如不需要依賴圖像，而是改用 CSS 實現動畫傚果，用 data 屬性存儲標題信息。

如果您想要單獨引用該插件的功能，那么您需要引用 tooltip.js。或者，正如 Bootstrap 插件概覽 一章中所提到，您可以引用 bootstrap.js 或壓縮版的 bootstrap.min.js。

用法

提示工具（Tooltip）插件根據需求生成內容和標記，默認情況下是把提示工具（tooltip）放在它們的觸發元素後面。您可以有以下兩種方式添加提示工具（tooltip）：

• 通過 data 屬性：如需添加一個提示工具（tooltip），只需向一個錨標籤添加 data-toggle="tooltip" 即可。錨的 title 即為提示工具（tooltip）的文本。默認情況下，插件把提示工具（tooltip）設置在頂部。

  <a href="#" data-toggle="tooltip" title="Example tooltip">請懸停在我的上面</a>
  

• 通過 JavaScript：通過 JavaScript 觸發提示工具（tooltip）：

  $('#identifier').tooltip(options)
  

提示工具（Tooltip）插件不像之前所討論的下拉菜單及其他插件那樣，它不是純 CSS 插件。如需使用該插件，您必須使用 jquery 激活它（讀取 javascript）。使用下面的腳本來啟用頁面中的所有的提示工具（tooltip）：

$(function () { $("[data-toggle='tooltip']").tooltip(); });

實例

下面的實例演示了通過 data 屬性使用提示工具（Tooltip）插件的用法。

選項

有一些選項是通過 Bootstrap 數據 API（Bootstrap Data API）添加或通過 JavaScript 調用的。下表列出了這些選項：

delay:
{ show: 500, hide: 100 }

方法

下面是一些提示工具（Tooltip）插件中有用的方法：

$().tooltip(options)

$('#element').tooltip('toggle')

$('#element').tooltip('show')

$('#element').tooltip('hide')

$('#element').tooltip('destroy')

實例

下面的實例演示了提示工具（Tooltip）插件方法的用法。

事件

下表列出了提示工具（Tooltip）插件中要用到的事件。這些事件可在函數中當鉤子使用。

$('#myTooltip').on('show.bs.tooltip', function () {
  // 執行一些動作...
})

$('#myTooltip').on('shown.bs.tooltip', function () {
  // 執行一些動作...
})

$('#myTooltip').on('hide.bs.tooltip', function () {
  // 執行一些動作...
})

$('#myTooltip').on('hidden.bs.tooltip', function () {
  // 執行一些動作...
})

實例

下面的實例演示了提示工具（Tooltip）插件事件的用法。