Bootstrap Tooltip-Plugin

Wenn Sie einen Link beschreiben möchten, ist das Tooltip-Plugin sehr nützlich. Das Tooltip-Plugin ist inspiriert vonJason Framegeschrieben vonjQuery.tipsy. Das Tooltip-Plugin hat viele Verbesserungen vorgenommen, wie zum Beispiel den Verzicht auf Bilder, stattdessen die Verwendung von CSS zur Implementierung von Animationseffekten und die Nutzung von Datenattributen zum Speichern von Titelinformationen.

Wenn Sie die Funktionalität des Plugins separat referenzieren möchten, müssen Sietooltip.jseinbinden. Alternativ können Sie, wie im KapitelBootstrap Plugins-Übersichterwähnt, folgendes einbindenbootstrap.jsoder die komprimierte Version vonbootstrap.min.js。

Nutzung

Das Tooltip-Plugin generiert Inhalt und Markup bei Bedarf und platziert den Tooltip standardmäßig hinter dem auslösenden Element. Sie können Tooltips auf die folgenden zwei Arten hinzufügen:

  • Über Datenattribute: Um einen Tooltip hinzuzufügen, fügen Sie einfach einem Anker-Tagdata-toggle="tooltip"hinzu. Der Titel des Ankers ist der Text des Tooltips. Standardmäßig platziert das Plugin den Tooltip oben.
    <a href="../index.html" data-toggle="tooltip" title="Example tooltip">请悬停在我的上面</a>
    
  • Über JavaScript: Den Tooltip über JavaScript auslösen:
    $('#identifier').tooltip(options)
    
Das Tooltip-Plugin unterscheidet sich von Dropdown-Menüs und anderen zuvor besprochenen Plugins; es ist kein reines CSS-Plugin. Um dieses Plugin zu verwenden, müssen Sie es mit jQuery aktivieren (siehe JavaScript). Verwenden Sie das folgende Skript, um alle Tooltips auf der Seite zu aktivieren:
$(function () { $("[data-toggle='tooltip']").tooltip(); });

Beispiele

Das folgende Beispiel veranschaulicht die Verwendung des Tooltip-Plugins über Datenattribute.

Beispiele

<h4>Tooltip-Plugin - Anker</h4>Dies ist ein<a href="#" class="tooltip-test" data-toggle="tooltip" title="Standard-Tooltip">Standard-Tooltip</a>. Dies ist ein<a href="#" class="tooltip-test" data-toggle="tooltip" data-placement="left" title="Tooltip links">Tooltip links</a>. Dies ist ein<a href="#" data-toggle="tooltip" data-placement="top" title="Tooltip oben">Tooltip oben</a>. Dies ist ein<a href="#" data-toggle="tooltip" data-placement="bottom" title="Tooltip unten">Tooltip unten</a>. Dies ist ein<a href="#" data-toggle="tooltip" data-placement="right" title="Tooltip rechts">Tooltip rechts</a> <br> <h4>Tooltip-Plugin - Schaltfläche</h4> <button type="button" class="btn btn-default" data-toggle="tooltip" title="Standard-Tooltip">Standard-Tooltip</button> <button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="left" title="Tooltip links">Tooltip links</button> <button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="top" title="Tooltip oben">Tooltip oben</button> <button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="bottom" title="Tooltip unten">Tooltip unten</button> <button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="right" title="Tooltip rechts">Tooltip rechts</button>
<script> $(function () { $("[data-toggle='tooltip']").tooltip(); }); </script>

Selbst ausprobieren »

Das Ergebnis ist wie folgt:

提示工具(Tooltip)插件

Optionen

Einige Optionen werden über die Bootstrap Data-API hinzugefügt oder über JavaScript aufgerufen. Die folgende Tabelle listet diese Optionen auf:

OptionsnameTyp/StandardwertDatenattributnameBeschreibung
animationboolesch
Standard: true
data-animationDer Tooltip verwendet CSS-Farbverlaufs-Filtereffekte.
htmlboolesch
Standard: false
data-htmlFügt HTML in den Tooltip ein. Wenn auf false gesetzt, wird die Text-Methode von jQuery verwendet, um Inhalte in das DOM einzufügen. Wenn Sie sich Sorgen über XSS-Angriffe machen, verwenden Sie text.
placementstring|function
Standardwert: top
data-placementGibt an, wie der Tooltip positioniert werden soll (d. h. top|bottom|left|right|auto).
Wenn alsautoangegeben, wird der Tooltip dynamisch angepasst. Wenn die Platzierung beispielsweise "auto left" ist, wird der Tooltip so weit wie möglich links angezeigt und nur dann rechts, wenn die Situation es nicht anders zulässt.
selectorstring
Standardwert: false
data-selectorWenn ein Selektor angegeben wird, werden Tooltip-Objekte an die angegebenen Ziele delegiert.
titlestring | function
Standardwert: ''
data-titleFalls keintitle-Attribut angegeben ist, ist die Option title der Standard-Titelwert.
triggerstring
Standardwert: 'hover focus'
data-triggerDefiniert, wie der Tooltip ausgelöst wird: click| hover | focus | manual. Sie können mehrere Auslöser übergeben, jeweils getrennt durch ein Leerzeichen.
delaynumber | object
Standardwert: 0
data-delayDie Anzahl der Millisekunden als Verzögerung beim Ein- und Ausblenden des Tooltips – gilt nicht für den manuellen Auslösertyp (trigger). Wenn eine Zahl angegeben wird, gilt die Verzögerung sowohl für das Ein- als auch für das Ausblenden. Wenn ein Objekt angegeben wird, hat dies folgende Struktur:
delay:
{ show: 500, hide: 100 }
containerstring | false
Standardwert: false
data-containerFügt das Tooltip an ein angegebenes Element an.
Beispiel: container: 'body'

Methoden

Hier sind einige nützliche Methoden im Tooltip-Plugin:

MethodeBeschreibungBeispiel
Optionen: .tooltip(options)Hängt einen Tooltip-Handler an die Element-Collection an.
$().tooltip(options)
Umschalten: .tooltip('toggle')Schaltet das Ein-/Ausblenden des Tooltips eines Elements um.
$('#element').tooltip('toggle')
Anzeigen: .tooltip('show')Zeigt das Tooltip eines Elements an.
$('#element').tooltip('show')
Ausblenden: .tooltip('hide')Blendet das Tooltip eines Elements aus.
$('#element').tooltip('hide')
Zerstören: .tooltip('destroy')Blendet das Tooltip eines Elements aus und zerstört es.
$('#element').tooltip('destroy')

Beispiele

Das folgende Beispiel demonstriert die Verwendung der Tooltip-Plugin-Methoden.

Beispiele

<div style="padding: 100px 100px 10px;">Das ist ein<a href="#" class="tooltip-show" data-toggle="tooltip" title="show">Tooltip-Methode show</a>. Das ist ein<a href="#" class="tooltip-hide" data-toggle="tooltip" data-placement="left" title="hide">Tooltip-Methode hide</a>. Das ist ein<a href="#" class="tooltip-destroy" data-toggle="tooltip" data-placement="top" title="destroy">Tooltip-Methode destroy</a>. Das ist ein<a href="#" class="tooltip-toggle" data-toggle="tooltip" data-placement="bottom" title="toggle">Tooltip-Methode toggle</a>. <br><br><br><br><br><br> <p class="tooltip-options" >Das ist ein<a href="#" data-toggle="tooltip" title="<h2>'am Header2 </h2>">Tooltip-Methodenoptionen</a>. </p> <script>
$(function () { $('.tooltip-show').tooltip('show');}); $(function () { $('.tooltip-hide').tooltip('hide');}); $(function () { $('.tooltip-destroy').tooltip('destroy');}); $(function () { $('.tooltip-toggle').tooltip('toggle');}); $(function () { $(".tooltip-options a").tooltip({html : true }); });
</script> </div>

Ausprobieren »

Das Ergebnis ist wie folgt:

提示工具(Tooltip)插件方法

Ereignisse

Die folgende Tabelle listet die im Tooltip-Plugin verwendeten Ereignisse auf. Diese Ereignisse können als Hooks in Funktionen verwendet werden.

EreignisBeschreibungBeispiel
show.bs.tooltipDieses Ereignis wird ausgelöst, sobald die Instanzmethode show aufgerufen wird.
$('#myTooltip').on('show.bs.tooltip', function () {
  // 执行一些动作...
})
shown.bs.tooltipDieses Ereignis wird ausgelöst, wenn das Tooltip für den Benutzer sichtbar ist (es wartet, bis der CSS-Übergang abgeschlossen ist).
$('#myTooltip').on('shown.bs.tooltip', function () {
  // 执行一些动作...
})
hide.bs.tooltipDieses Ereignis wird ausgelöst, sobald die Instanzmethode hide aufgerufen wird.
$('#myTooltip').on('hide.bs.tooltip', function () {
  // 执行一些动作...
})
hidden.bs.tooltipDieses Ereignis wird ausgelöst, wenn das Tooltip vor dem Benutzer ausgeblendet wurde (es wartet, bis der CSS-Übergang abgeschlossen ist).
$('#myTooltip').on('hidden.bs.tooltip', function () {
  // 执行一些动作...
})

Beispiele

Das folgende Beispiel demonstriert die Verwendung der Tooltip-Plugin-Ereignisse.

Beispiele

<h4>Tooltip-Plugin - Anker</h4>Das ist ein<a href="#" class="tooltip-show" data-toggle="tooltip" title="default Tooltip">default Tooltip</a>. <script>
$(function () { $('.tooltip-show').tooltip('show');}); $(function () { $('.tooltip-show').on('show.bs.tooltip', function () { alert("Alert message on show"); }) });
</script>

Ausprobieren »

Das Ergebnis ist wie folgt:

提示工具(Tooltip)插件事件
Weitere Erweiterungen