Popover JS Bootstrap
JS Popover (popover.js)
Le plugin Popover est similaire aux infobulles ; c'est une boîte pop-up qui apparaît lorsque l'utilisateur clique sur un élément. La différence est que le popover peut contenir beaucoup plus de contenu.
Dépendance du plug-in : les popovers nécessitent que le plug-in d'info-bulle (tooltip.js) soit inclus dans votre version de Bootstrap.
Pour un tutoriel sur les popovers, lisez notre tutoriel sur les popovers Bootstrap .
Via data-* Attributs
Le data-toggle="popover"popover s'active.
L' titleattribut spécifie le texte d'en-tête du popover.
L' data-contentattribut spécifie le texte qui doit être affiché dans le corps du popover.
Exemple
<a href="#" data-toggle="popover" title="Popover Header" data-content="Some
content inside the popover">Toggle popover</a>
Via Javascript
Les popovers ne sont pas des plugins uniquement CSS, et doivent donc être initialisés avec jQuery : sélectionnez l'élément spécifié et appelez la
popover()méthode.
Exemple
// Select all
elements with data-toggle="popover" in the document
$('[data-toggle="popover"]').popover();
// Select a specified
element
$('#myPopover').popover();
Options de survol
Les options peuvent être transmises via des attributs de données ou JavaScript. Pour les attributs de données, ajoutez le nom de l'option à data-, comme dans data-placement="".
| Name | Type | Default | Description | Try it |
|---|---|---|---|---|
| animation | boolean | true |
Specifies whether to add a CSS fade transition effect when opening and closing the popover
|
|
| container | string, or the boolean false | false | Appends the popover to a specific element. Example: container: 'body' |
|
| content | string | "" | Specifies the text inside the popover's body | |
| delay | number, or object | 0 | Specifies the number of milliseconds it will take to open and close the popover. To specify a delay for opening and another one for closing, use the object structure: delay: {show: 500, hide: 100} - which will take 500 ms to open the popover, but only 100 ms to close it |
|
| html | boolean | false | Specifies whether to accept HTML tags in the popover:
When set to false (default), jQuery's text() method will be used. Use this if you are worried about XSS attacks |
|
| placement | string | "right" | Specifies the popover position. Possible values:
|
|
| selector | string, or the boolean false | false | Adds the popover to a specified selector | |
| template | string | Base HTML to use when creating the popover. The popover's title will be injected into the .popover-title. The popover's content will be injected into the .popover-content. .arrow will become the popover's arrow. The outermost wrapper element should have the .popover class. |
||
| title | string | "" | Specifies the header text of the popover | |
| trigger | string | "click" | Specifies how the popover is triggered. Possible values:
|
|
| viewport | string, or object | {selector: "body", padding: 0} | Keeps the popover within the bounds of this element. Example: viewport: '#viewport' or {selector: '#viewport', padding: 0} |
Méthodes contextuelles
Le tableau suivant répertorie toutes les méthodes de popover disponibles.
| Method | Description | Try it |
|---|---|---|
| .popover(options) | Activates the popover with an option. See options above for valid values | |
| .popover("show") | Shows the popover | |
| .popover("hide") | Hides the popover | |
| .popover("toggle") | Toggles the popover | |
| .popover("destroy") | Hides and destroys the popover |
Événements contextuels
Le tableau suivant répertorie tous les événements contextuels disponibles.
| Event | Description | Try it |
|---|---|---|
| show.bs.popover | Occurs when the popover is about to be shown | |
| shown.bs.popover | Occurs when the popover is fully shown (after CSS transitions have completed) | |
| hide.bs.popover | Occurs when the popover is about to be hidden | |
| hidden.bs.popover | Occurs when the popover is fully hidden (after CSS transitions have completed) |
Plus d'exemples
Conception de pop-over personnalisée
Utilisez CSS pour personnaliser l'apparence du popover :
Exemple
/* Popover */
.popover {
border: 2px dotted red;
}
/* Popover Header */
.popover-title {
background-color: #73AD21;
color: #FFFFFF;
font-size: 28px;
text-align:center;
}
/* Popover Body */
.popover-content {
background-color: coral;
color: #FFFFFF;
padding: 25px;
}
/* Popover Arrow */
.arrow {
border-right-color: red !important;
}