Bootstrap Plugin d'infobulle

Lorsque vous souhaitez décrire un lien, le plugin d'infobulle est très utile. Le plugin d'infobulle est inspiré parJason FrameécritjQuery.tipsyinspiré par. Le plugin d'infobulle a apporté de nombreuses améliorations, comme ne pas avoir besoin de s'appuyer sur des images, utiliser plutôt CSS pour implémenter des effets d'animation, et utiliser des attributs de données pour stocker les informations de titre.

Si vous souhaitez référencer séparément les fonctionnalités du plugin, vous devez alors référencertooltip.js. Sinon, comme le mentionne le chapitrePrésentation des plugins Bootstrap, vous pouvez référencerbootstrap.jsou la version compressée debootstrap.min.js。

Utilisation

Le plugin d'infobulle génère le contenu et le balisage à la demande, et par défaut place l'infobulle derrière son élément déclencheur. Vous pouvez ajouter des infobulles des deux manières suivantes :

  • Via les attributs de données: Pour ajouter une infobulle, ajoutez simplement à une balise d'ancragedata-toggle="tooltip"et c'est fait. Le titre de l'ancre est le texte de l'infobulle. Par défaut, le plugin place l'infobulle en haut.
    <a href="../index.html" data-toggle="tooltip" title="Example tooltip">请悬停在我的上面</a>
    
  • Via JavaScript: Déclenchez l'infobulle via JavaScript :
    $('#identifier').tooltip(options)
    
Le plugin d'infobulle n'est pas comme le menu déroulant et les autres plugins abordés précédemment ; ce n'est pas un plugin CSS pur. Pour utiliser ce plugin, vous devez l'activer avec jQuery (lire JavaScript). Utilisez le script suivant pour activer toutes les infobulles de la page :
$(function () { $("[data-toggle='tooltip']").tooltip(); });

Exemples

L'exemple suivant illustre l'utilisation du plugin d'infobulle via les attributs de données.

Exemples

<h4>Plugin d'infobulle - Ancre</h4>Ceci est un<a href="#" class="tooltip-test" data-toggle="tooltip" title="Infobulle par défaut">Infobulle par défaut</a>. Ceci est un<a href="#" class="tooltip-test" data-toggle="tooltip" data-placement="left" title="Info-bulle à gauche">Info-bulle à gauche</a>. Ceci est une<a href="#" data-toggle="tooltip" data-placement="top" title="Info-bulle en haut">Info-bulle en haut</a>. Ceci est une<a href="#" data-toggle="tooltip" data-placement="bottom" title="Info-bulle en bas">Info-bulle en bas</a>. Ceci est une<a href="#" data-toggle="tooltip" data-placement="right" title="Info-bulle à droite">Info-bulle à droite</a> <br> <h4>Plugin d'info-bulle - Bouton</h4> <button type="button" class="btn btn-default" data-toggle="tooltip" title="Info-bulle par défaut">Info-bulle par défaut</button> <button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="left" title="Info-bulle à gauche">Info-bulle à gauche</button> <button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="top" title="Info-bulle en haut">Info-bulle en haut</button> <button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="bottom" title="Info-bulle en bas">Info-bulle en bas</button> <button type="button" class="btn btn-default" data-toggle="tooltip" data-placement="right" title="Info-bulle à droite">Info-bulle à droite</button>
<script> $(function () { $("[data-toggle='tooltip']").tooltip(); }); </script>

Essayez-le vous-même »

Le résultat est le suivant :

提示工具(Tooltip)插件

Options

Certaines options sont ajoutées via l'API Data de Bootstrap ou invoquées via JavaScript. Le tableau suivant répertorie ces options :

Nom de l'optionType/Valeur par défautNom de l'attribut dataDescription
animationbooléen
Par défaut : true
data-animationL'infobulle utilise des effets de filtre de dégradé CSS.
htmlbooléen
Par défaut : false
data-htmlInsérer du HTML dans l'infobulle. Si false, la méthode text de jQuery sera utilisée pour insérer du contenu dans le DOM. Si vous craignez des attaques XSS, utilisez text.
placementstring|function
Valeur par défaut : top
data-placementSpécifie comment positionner l'infobulle (c'est-à-dire top|bottom|left|right|auto).
Lorsque spécifié commeauto, l'infobulle sera ajustée dynamiquement. Par exemple, si placement est "auto left", l'infobulle s'affichera le plus à gauche possible, et ce n'est que lorsque la situation ne le permet pas qu'elle s'affichera à droite.
selectorstring
Valeur par défaut : false
data-selectorSi un sélecteur est fourni, les objets infobulle seront délégués aux cibles spécifiées.
titlestring | function
Valeur par défaut : ''
data-titleSi l'attributtitlen'est pas spécifié, alors l'option title est la valeur de titre par défaut.
triggerstring
Valeur par défaut : 'hover focus'
data-triggerDéfinit comment l'infobulle est déclenchée : click| hover | focus | manual. Vous pouvez passer plusieurs déclencheurs, chacun séparé par un espace.
delaynumber | object
Valeur par défaut : 0
data-delayLe nombre de millisecondes pour retarder l'affichage et le masquage de l'infobulle - non applicable au type de déclenchement manuel. Si un nombre est fourni, le délai s'appliquera à la fois à l'affichage et au masquage. Si un objet est fourni, la structure est la suivante :
delay:
{ show: 500, hide: 100 }
containerstring | false
Valeur par défaut : false
data-containerAjoute l'infobulle à un élément spécifié.
Exemple : container: 'body'

Méthodes

Voici quelques méthodes utiles dans le plugin Tooltip :

MéthodeDescriptionExemple
Options : .tooltip(options)Attache un gestionnaire d'infobulle à la collection d'éléments.
$().tooltip(options)
Basculer : .tooltip('toggle')Bascule l'affichage/le masquage de l'infobulle d'un élément.
$('#element').tooltip('toggle')
Afficher : .tooltip('show')Affiche l'infobulle d'un élément.
$('#element').tooltip('show')
Masquer : .tooltip('hide')Masque l'infobulle d'un élément.
$('#element').tooltip('hide')
Détruire : .tooltip('destroy')Masque et détruit l'infobulle d'un élément.
$('#element').tooltip('destroy')

Exemples

L'exemple suivant illustre l'utilisation des méthodes du plugin Tooltip.

Exemples

<div style="padding: 100px 100px 10px;">Ceci est un<a href="#" class="tooltip-show" data-toggle="tooltip" title="show">Méthode show de Tooltip</a>. Ceci est un<a href="#" class="tooltip-hide" data-toggle="tooltip" data-placement="left" title="hide">Méthode hide de Tooltip</a>. Ceci est un<a href="#" class="tooltip-destroy" data-toggle="tooltip" data-placement="top" title="destroy">Méthode destroy de Tooltip</a>. Ceci est un<a href="#" class="tooltip-toggle" data-toggle="tooltip" data-placement="bottom" title="toggle">Méthode toggle de Tooltip</a>. <br><br><br><br><br><br> <p class="tooltip-options" >Ceci est un<a href="#" data-toggle="tooltip" title="<h2>'am Header2 </h2>">Options de méthode Tooltip</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>

Essayez-le »

Le résultat est le suivant :

提示工具(Tooltip)插件方法

Événements

Le tableau suivant répertorie les événements utilisés dans le plugin Tooltip. Ces événements peuvent être utilisés comme hooks dans les fonctions.

ÉvénementDescriptionExemple
show.bs.tooltipCet événement est déclenché immédiatement lorsque la méthode d'instance show est appelée.
$('#myTooltip').on('show.bs.tooltip', function () {
  // 执行一些动作...
})
shown.bs.tooltipCet événement est déclenché lorsque l'infobulle est visible pour l'utilisateur (il attendra la fin de la transition CSS).
$('#myTooltip').on('shown.bs.tooltip', function () {
  // 执行一些动作...
})
hide.bs.tooltipCet événement est déclenché immédiatement lorsque la méthode d'instance hide est appelée.
$('#myTooltip').on('hide.bs.tooltip', function () {
  // 执行一些动作...
})
hidden.bs.tooltipCet événement est déclenché lorsque l'infobulle est masquée pour l'utilisateur (il attendra la fin de la transition CSS).
$('#myTooltip').on('hidden.bs.tooltip', function () {
  // 执行一些动作...
})

Exemples

L'exemple suivant illustre l'utilisation des événements du plugin Infobulle.

Exemples

<h4>Plugin Infobulle - Ancre</h4>Ceci est un<a href="#" class="tooltip-show" data-toggle="tooltip" title="Infobulle par défaut">Infobulle par défaut</a>. <script>
$(function () { $('.tooltip-show').tooltip('show');}); $(function () { $('.tooltip-show').on('show.bs.tooltip', function () { alert("Message d'alerte lors de l'affichage"); }) });
</script>

Essayez-le »

Le résultat est le suivant :

提示工具(Tooltip)插件事件
Autres extensions