最新的Web開發教程
 

Bootstrap JS工具提示


JS工具提示(tooltip.js)

該工具提示插件是小的彈出框,當用戶在一個元素上移動鼠標指針出現。

對於有關工具提示教程,請閱讀我們的Bootstrap Tooltip教程


通過data-*屬性

data-toggle="tooltip"激活提示。

title屬性指定應提示裡面顯示的文本。

<a href="#" data-toggle="tooltip" title="Hooray!">Hover over me</a>
試一試»

通過JavaScript

提示不僅是CSS-插件,因此必須用jQuery初始化:選擇指定的元素,並調用tooltip()方法。

// Select all elements with data-toggle="tooltips" in the document
$('[data-toggle="tooltip"]').tooltip();

// Select a specified element
$('#myTooltip').tooltip();
試一試»

提示選項

選項可以通過數據屬性或JavaScript進行傳遞。 對於數據屬性,選項名稱追加到data-data-placement=""

名稱 類型 默認 描述 嘗試一下
animationbooleantrue

指定是否添加CSS淡入淡出過渡效果顯示和隱藏工具提示時,

  • true -添加一個漸變效果
  • false -不要添加漸變效果
嘗試一下
容器 字符串或布爾值false 追加工具提示特定元素。
例如:容器: 'body'
嘗試一下
delaynumber, or object0 指定毫秒它會顯示和隱藏工具提示的數量。

來指定用於顯示的延遲和另一個用於隱藏,使用對象結構:

delay: {show: 500, hide: 100} -這將需要500毫秒,以顯示tooltip ,但只有100毫秒來隱藏它
嘗試一下
htmlboolean false 指定是否接受HTML標籤的提示:
  • true -接受HTML標籤
  • false -不接受HTML標籤
注:HTML必須在標題屬性中插入(或使用標題選項)。

當設置為false(默認), jQuery's text()將被使用的方法。 如果你擔心XSS攻擊使用此
嘗試一下
placementstring"top" 指定提示的位置。 可能的值:

  • "top" -頂部工具提示
  • "bottom" -在底部工具提示
  • "left" -工具提示左
  • "right" -在右邊工具提示
  • "auto" -讓瀏覽器決定工具提示的位置。 例如,如果值是"auto left" ,工具提示將顯示在左側可能時,否則在右邊。 如果該值是"auto bottom" ,工具提示將顯示在可能的情況下,否則在頂
嘗試一下
selectorstring, or the boolean falsefalse 添加工具提示到指定的選擇 嘗試一下
templatestring  基本HTML創建工具提示時使用。

工具提示的標題將被插入到具有所述類元素.tooltip-inner並與類元素.tooltip-arrow將成為工具提示的箭頭。

最外層的包裝元素應該有.tooltip類。
titlestring"" 指定應工具提示內顯示的文本 嘗試一下
triggerstring"hover focus" 指定提示是如何觸發。 可能的值:

  • "click" -一個點擊觸發的工具提示
  • "hover" -觸發懸停提示
  • "focus" -觸發工具提示,當它獲得焦點(按Tab鍵或單擊.eg)
  • "manual" -手動觸發提示
提示:要傳遞多個值,它們用空格分隔
嘗試一下
viewportstring, or object{selector: "body", padding: 0} 保持此元素的邊界內的提示。

例如: viewport: '#viewport'{selector: '#viewport', padding: 0}

提示方法

下表列出了所有可用的工具提示方法。

方法 描述 嘗試一下
.tooltip( options ) 激活與選項的提示。 見上面的有效值選項 嘗試一下
.tooltip("show") 顯示工具提示 嘗試一下
.tooltip("hide") 隱藏工具提示 嘗試一下
.tooltip("toggle") 切換工具提示 嘗試一下
.tooltip("destroy") 隱藏並銷毀工具提示 嘗試一下

提示活動

下表列出了所有可用的工具提示的事件。

事件 描述 嘗試一下
show.bs.tooltip 當工具提示將要示出發生 嘗試一下
shown.bs.tooltip 發生時,盡顯提示(後CSS過渡已經完成) 嘗試一下
hide.bs.tooltip 當提示即將發生隱患 嘗試一下
hidden.bs.tooltip 當提示完全隱藏時(後CSS過渡已經完成) 嘗試一下

例子

例子

定制設計工具提示

使用CSS自定義工具提示的外觀:

/* Tooltip */
.test + .tooltip > .tooltip-inner {
    background-color: #73AD21;
    color: #FFFFFF;
    border: 1px solid green;
    padding: 15px;
    font-size: 20px;
}

/* Tooltip on top */
.test + .tooltip.top > .tooltip-arrow {
    border-top: 5px solid green;
}

/* Tooltip on bottom */
.test + .tooltip.bottom > .tooltip-arrow {
    border-bottom: 5px solid blue;
}

/* Tooltip on left */
.test + .tooltip.left > .tooltip-arrow {
    border-left: 5px solid red;
}

/* Tooltip on right */
.test + .tooltip.right > .tooltip-arrow {
    border-right: 5px solid black;
}
試一試»