工具提示

文檔和示例使用 CSS3 添加自定義 Bootstrap 工具提示，使用 CSS3 進行動畫和數據屬性用於本地標題存儲。

概述

使用工具提示插件時要知道的事情：

• 工具提示依賴 3rd 方庫Popper進行定位。您必須在 bootstrap.js 之前包含popper.min.js或使用包含 Popper 的bootstrap.bundle.min.js/以使工具提示起作用！bootstrap.bundle.js
• 如果您從源代碼構建我們的 JavaScript，它需要util.js.
• 出於性能原因，工具提示是可選的，因此您必須自己初始化它們。
• 從不顯示具有零長度標題的工具提示。
• 指定container: 'body'以避免在更複雜的組件（如我們的輸入組、按鈕組等）中出現渲染問題。
• 在隱藏元素上觸發工具提示將不起作用。
• .disabled或元素的工具提示disabled必須在包裝元素上觸發。
• 當從跨越多行的超鏈接觸發時，工具提示將居中。white-space: nowrap;在你的 s 上使用<a>以避免這種行為。
• 在從 DOM 中刪除相應元素之前，必須隱藏工具提示。
• 由於 shadow DOM 中的元素，可以觸發工具提示。

明白了嗎？太好了，讓我們通過一些示例來看看它們是如何工作的。

示例：隨處啟用工具提示

初始化頁面上所有工具提示的一種方法是通過它們的data-toggle屬性來選擇它們：

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

例子

將鼠標懸停在下面的鏈接上以查看工具提示：

將鼠標懸停在下面的按鈕上可查看四個工具提示方向：頂部、右側、底部和左側。

<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-placement="top" title="Tooltip on top">
  Tooltip on top
</button>
<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-placement="right" title="Tooltip on right">
  Tooltip on right
</button>
<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-placement="bottom" title="Tooltip on bottom">
  Tooltip on bottom
</button>
<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-placement="left" title="Tooltip on left">
  Tooltip on left
</button>

並添加了自定義 HTML：

<button type="button" class="btn btn-secondary" data-toggle="tooltip" data-html="true" title="<em>Tooltip</em> <u>with</u> <b>HTML</b>">
  Tooltip with HTML
</button>

用法

工具提示插件按需生成內容和標記，默認情況下將工具提示放置在其觸發元素之後。

通過 JavaScript 觸發工具提示：

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

$('#example').tooltip({ boundary: 'window' })

標記

工具提示所需的標記只是一個data屬性，並且title在您希望擁有工具提示的 HTML 元素上。生成的工具提示標記相當簡單，儘管它確實需要一個位置（默認情況下，top由插件設置）。

<!-- HTML to write -->
<a href="#" data-toggle="tooltip" title="Some tooltip text!">Hover over me</a>

<!-- Generated markup by the plugin -->
<div class="tooltip bs-tooltip-top" role="tooltip">
  <div class="arrow"></div>
  <div class="tooltip-inner">
    Some tooltip text!
  </div>
</div>

禁用元素

具有該disabled屬性的元素不是交互式的，這意味著用戶無法聚焦、懸停或單擊它們來觸發工具提示（或彈出框）。作為一種解決方法，您需要從包裝器<div>或觸發工具提示<span>，理想情況下使用 使鍵盤可聚焦tabindex="0"，並覆蓋pointer-events禁用元素上的 。

<span class="d-inline-block" tabindex="0" data-toggle="tooltip" title="Disabled tooltip">
  <button class="btn btn-primary" style="pointer-events: none;" type="button" disabled>Disabled button</button>
</span>

選項

選項可以通過數據屬性或 JavaScript 傳遞。對於數據屬性，將選項名稱附加到 中data-，如data-animation="".

方法

$().tooltip(options)

將工具提示處理程序附加到元素集合。

.tooltip('show')

顯示元素的工具提示。在工具提示實際顯示之前（即在事件發生之前）返回給調用者。shown.bs.tooltip這被認為是工具提示的“手動”觸發。從不顯示具有零長度標題的工具提示。

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

.tooltip('hide')

隱藏元素的工具提示。在工具提示實際上被隱藏之前（即在事件發生之前）返回給調用者。hidden.bs.tooltip這被認為是工具提示的“手動”觸發。

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

.tooltip('toggle')

切換元素的工具提示。在工具提示實際顯示或隱藏之前（即在or事件發生之前）返回給調用者。這被認為是工具提示的“手動”觸發。shown.bs.tooltiphidden.bs.tooltip

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

.tooltip('dispose')

隱藏和破壞元素的工具提示。使用委託（使用選項創建）的selector工具提示不能在後代觸發器元素上單獨銷毀。

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

.tooltip('enable')

使元素的工具提示能夠顯示。默認情況下啟用工具提示。

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

.tooltip('disable')

移除顯示元素工具提示的能力。工具提示只有在重新啟用後才能顯示。

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

.tooltip('toggleEnabled')

切換顯示或隱藏元素工具提示的能力。

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

.tooltip('update')

更新元素工具提示的位置。

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

活動

$('#myTooltip').on('hidden.bs.tooltip', function () {
  // do something...
})