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
Essayez-le »
Le résultat est affiché ci-dessous :
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'option | Type/Valeur par défaut | Nom de l'attribut de données | Description |
|---|---|---|---|
| animation | booléen Valeur par défaut : true | data-animation | Applique une transition de fondu CSS au popover. |
| html | booléen Valeur par défaut : false | data-html | Insé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. |
| placement | string|function Valeur par défaut : top | data-placement | Spé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. |
| selector | string Valeur par défaut : false | data-selector | Si un sélecteur est fourni, les objets popover seront délégués aux cibles spécifiées. |
| title | string | function Valeur par défaut : '' | data-title | Si l'attributtitlen'est pas spécifié, alors l'option title est la valeur de titre par défaut. |
| trigger | string Valeur par défaut : 'hover focus' | data-trigger | Définit comment le popover est déclenché : click| hover | focus | manualVous pouvez passer plusieurs déclencheurs, séparés par des espaces. |
| delay | number | object Valeur par défaut : 0 | data-delay | Nombre 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 } |
| container | string | false Valeur par défaut : false | data-container | Ajouter un popover à l'élément spécifié. Exemple : container: 'body' |
Méthodes
Voici quelques méthodes utiles dans le plugin Popover :
| Méthode | Description | Exemple |
|---|---|---|
| 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
Essayez-le »
Le résultat est le suivant :
É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énement | Description | Exemple |
|---|---|---|
| show.bs.popover | Cet é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.popover | Cet é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.popover | Cet é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.popover | Cet é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
Essayez-le »
Le résultat est le suivant :