Bootstrap Plugin Popover

Le plugin Popover est similaire au Tooltip ; il fournit une vue élargie. Pour activer un popover, l'utilisateur n'a qu'à survoler l'élément avec la souris pour que le popover soit manquant ?

Si vous souhaitez inclure la fonctionnalité de ce plugin séparément, vous devez référencerpopover.js, qui dépend dele plugin Tooltip. Ou, commel'aperçu des plugins Bootstrapchapitre le mentionne, vous pouvez référencerbootstrap.jsou la version minifiée debootstrap.min.js。

Utilisation

Le plugin Popover génère du contenu et du balisage à la demande. Par défaut, le popover est placé après son élément déclencheur. Vous pouvez ajouter un popover des deux manières suivantes :

  • Via les attributs data: Pour ajouter un popover, ajoutez simplementdata-toggle="popover"à une balise ancre/bouton. Le titre de l'ancre est le texte du popover. Par défaut, le plugin place le popover en haut.
    <a href="../index.html" data-toggle="popover" title="Example popover">
        请悬停在我的上面
    </a>
    
  • Via JavaScript :Activez les popovers via JavaScript :
    $('#identifier').popover(options)
    

Le plugin Popover n'est pas un plugin CSS pur, contrairement aux menus déroulants et aux autres plugins abordés précédemment. Pour utiliser ce plugin, vous devez l'activer avec jQuery (lire JavaScript). Utilisez le script suivant pour activer tous les popovers de la page :

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

Exemple

L'exemple suivant montre l'utilisation du plugin Popover via l'attribut data.

Exemple

<div class="container" style="padding: 100px 50px 10px;" > <button type="button" class="btn btn-default" title="Titre du popover" data-container="body" data-toggle="popover" data-placement="left" data-content="Du contenu dans le popover de gauche">Popover à gauche</button> <button type="button" class="btn btn-primary" title="Titre du popover" data-container="body" data-toggle="popover" data-placement="top" data-content="Du contenu dans le Popover du haut">Popover en haut</button> <button type="button" class="btn btn-success" title="Titre du Popover" data-container="body" data-toggle="popover" data-placement="bottom" data-content="Du contenu dans le Popover inférieur">Popover en bas</button> <button type="button" class="btn btn-warning" title="Titre du popover" data-container="body" data-toggle="popover" data-placement="right" data-content="Du contenu dans le Popover de droite">Popover à droite</button> </div> <script>
$(function (){ $("[data-toggle='popover']").popover(); });
</script> </div>

Essayez-le »

Le résultat est affiché ci-dessous :

弹出框(Popover)插件

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 de donnéesDescription
animationbooléen
Valeur par défaut : true
data-animationApplique une transition de fondu CSS au popover.
htmlbooléen
Valeur par défaut : false
data-htmlInsérez du HTML dans le popover. Si false, la méthode text de jQuery sera utilisée pour insérer du contenu dans le DOM. Si vous êtes préoccupé par les attaques XSS, utilisez text.
placementstring|function
Valeur par défaut : top
data-placementSpécifie comment positionner le popover (c'est-à-dire top|bottom|left|right|auto).
Lorsqu'il est défini surauto, le popover sera ajusté dynamiquement. Par exemple, si le placement est "auto left", le popover s'affichera le plus à gauche possible, et ne s'affichera à droite que si les circonstances ne le permettent pas.
selectorstring
Valeur par défaut : false
data-selectorSi un sélecteur est fourni, les objets popover 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 le popover est déclenché : click| hover | focus | manualVous pouvez passer plusieurs déclencheurs, séparés par des espaces.
delaynumber | object
Valeur par défaut : 0
data-delayNombre de millisecondes pour retarder l'affichage et le masquage du popover - non applicable au type de déclencheur manuel. Si un nombre est fourni, le délai sera appliqué à 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-containerAjouter un popover à l'élément spécifié.
Exemple : container: 'body'

Méthodes

Voici quelques méthodes utiles dans le plugin Popover :

MéthodeDescriptionExemple
Options : .popover(options)Attacher un gestionnaire de popover à une collection d'éléments.
$().popover(options)
Basculer : .popover('toggle')Afficher/masquer le popover d'un élément.
$('#element').popover('toggle')
Afficher : .popover('show')Afficher le popover d'un élément.
$('#element').popover('show')
Masquer : .popover('hide')Masquer le popover d'un élément.
$('#element').popover('hide')
Détruire : .popover('destroy')Masquer et détruire le popover d'un élément.
$('#element').popover('destroy')

Exemple

L'exemple suivant illustre les méthodes du plugin Popover :

Exemple

<div class="container" style="padding: 100px 50px 10px;" > <button type="button" class="btn btn-default popover-show" title="Titre du popover" data-container="body" data-toggle="popover" data-placement="left" data-content="Du contenu dans le popover à gauche — méthode show">Popover à gauche</button> <button type="button" class="btn btn-primary popover-hide" title="Titre du popover" data-container="body" data-toggle="popover" data-placement="top" data-content="Du contenu dans le popover en haut — méthode hide">Popover en haut</button> <button type="button" class="btn btn-success popover-destroy" title="Titre du popover" data-container="body" data-toggle="popover" data-placement="bottom" data-content="Du contenu dans le popover en bas — méthode destroy">Popover en bas</button> <button type="button" class="btn btn-warning popover-toggle" title="Titre du popover" data-container="body" data-toggle="popover" data-placement="right" data-content="Du contenu dans le popover à droite — méthode toggle">Popover à droite</button><br><br><br><br><br><br> <p class="popover-options"> <a href="#" type="button" class="btn btn-warning" title="<h2>Titre</h2>" data-container="body" data-toggle="popover" data-content="<h4>Du contenu dans le popover — méthode options</h4>"> Popover </a> </p> <script>
$(fonction () { $('.popover-show').popover('show');}); $(fonction () { $('.popover-hide').popover('hide');}); $(fonction () { $('.popover-destroy').popover('destroy');}); $(fonction () { $('.popover-toggle').popover('toggle');}); $(fonction () { $(".popover-options a").popover({html : true });});
</script> </div>

Essayez-le »

Le résultat est le suivant :

弹出框(Popover)插件方法

Événements

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

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

Exemple

L'exemple suivant illustre les événements du plugin Popover :

Exemple

<div clas="container" style="padding: 100px 50px 10px;" > <button type="button" class="btn btn-primary popover-show" title="Titre du popover" data-container="body" data-toggle="popover" data-content="Du contenu dans le Popover à gauche — méthode show">Popover à gauche</button> </div> <script>
$(fonction () { $('.popover-show').popover('show');}); $(fonction () { $('.popover-show').on('shown.bs.popover', function () { alert("Message d'alerte lorsqu'il est affiché"); }) });
</script> </div>

Essayez-le »

Le résultat est le suivant :

弹出框(Popover)插件事件
Autres extensions