Donnez vie aux composants de Bootstrap, désormais avec 13 plugins jQuery personnalisés.
Les plugins peuvent être inclus individuellement (bien que certains aient des dépendances requises), ou tous à la fois. bootstrap.js et bootstrap.min.js contiennent tous les plugins dans un seul fichier.
Vous pouvez utiliser tous les plugins Bootstrap uniquement via l'API de balisage sans écrire une seule ligne de JavaScript. Il s'agit de l'API de première classe de Bootstrap et devrait être votre première considération lors de l'utilisation d'un plugin.
Cela dit, dans certaines situations, il peut être souhaitable de désactiver cette fonctionnalité. Par conséquent, nous offrons également la possibilité de désactiver l'API d'attribut de données en déliant tous les événements sur l'espace de noms du corps avec `'data-api'`. Cela ressemble à ceci :
- $ ( 'corps' ). désactivé ( '.data-api' )
Alternativement, pour cibler un plugin spécifique, incluez simplement le nom du plugin en tant qu'espace de noms avec l'espace de noms data-api comme ceci :
- $ ( 'corps' ). désactivé ( '.alert.data-api' )
Nous pensons également que vous devriez pouvoir utiliser tous les plugins Bootstrap uniquement via l'API JavaScript. Toutes les API publiques sont des méthodes uniques et chaînées et renvoient la collection sur laquelle elles ont agi.
- $ ( ".btn.danger" ). bouton ( "basculer" ). addClass ( "gras" )
Toutes les méthodes doivent accepter un objet d'options optionnel, une chaîne qui cible une méthode particulière, ou rien (qui lance un plugin avec un comportement par défaut) :
- $ ( "#monModal" ). modal () // initialisé avec les valeurs par défaut
- $ ( "#monModal" ). modal ({ keyboard : false }) // initialisé sans clavier
- $ ( "#monModal" ). modal ( 'show' ) // initialise et invoque show immédiatement
Chaque plugin expose également son constructeur brut sur une propriété `Constructor` : $.fn.popover.Constructor
. Si vous souhaitez obtenir une instance de plugin particulière, récupérez-la directement à partir d'un élément : $('[rel=popover]').data('popover')
.
Parfois, il est nécessaire d'utiliser des plugins Bootstrap avec d'autres frameworks d'interface utilisateur. Dans ces circonstances, des collisions d'espaces de noms peuvent parfois se produire. Si cela se produit, vous pouvez appeler .noConflict
le plugin dont vous souhaitez annuler la valeur.
- var bootstrapButton = $ . fn . bouton . noConflict () // retourne $.fn.button à la valeur précédemment assignée
- $ . fn . bootstrapBtn = bootstrapButton // donne à $().bootstrapBtn la fonctionnalité d'amorçage
Bootstrap fournit des événements personnalisés pour les actions uniques de la plupart des plugins. Généralement, ceux-ci se présentent sous une forme infinitive et participe passé - où l'infinitif (ex. show
) est déclenché au début d'un événement, et sa forme de participe passé (ex. shown
) est déclenchée à la fin d'une action.
Tous les événements infinitifs fournissent la fonctionnalité preventDefault. Cela permet d'arrêter l'exécution d'une action avant qu'elle ne démarre.
- $ ( '#monModal' ). on ( 'montrer' , fonction ( e ) {
- si (! données ) renvoie e . preventDefault () // empêche l'affichage du modal
- })
Pour des effets de transition simples, incluez bootstrap-transition.js une fois avec les autres fichiers JS. Si vous utilisez le fichier bootstrap.js compilé (ou minifié) , il n'est pas nécessaire de l'inclure, il est déjà là.
Quelques exemples du plugin de transition :
Les modaux sont des invites de dialogue simplifiées, mais flexibles, avec les fonctionnalités minimales requises et des valeurs par défaut intelligentes.
Un modal rendu avec un en-tête, un corps et un ensemble d'actions dans le pied de page.
Un beau corps…
- <div class = "modal hide fade" >
- <div class = "en-tête-modal" >
- < type de bouton = "bouton" class = "fermer" data-dismiss = "modal" aria-hidden = "true" > × </bouton>
- <h3> En-tête modal </h3>
- </div>
- <div class = "modal-body" >
- <p> Un beau corps… </p>
- </div>
- <div class = "modal-footer" >
- <a href = "#" class = "btn" > Fermer </a>
- <a href = "#" class = "btn btn-primary" > Enregistrer les modifications </a>
- </div>
- </div>
Basculez un modal via JavaScript en cliquant sur le bouton ci-dessous. Il glissera vers le bas et s'estompera à partir du haut de la page.
- <!-- Bouton pour déclencher modal -->
- <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Lancer la démo modale </a>
- <!--Modalité -->
- <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labelledby = "myModalLabel" aria-hidden = "true" >
- <div class = "en-tête-modal" >
- <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
- <h3 id = "myModalLabel" > En -tête modal </h3>
- </div>
- <div class = "modal-body" >
- <p> Un beau corps… </p>
- </div>
- <div class = "modal-footer" >
- <bouton class = "btn" data-dismiss = "modal" aria-hidden = "true" > Fermer </button>
- <button class = "btn btn-primary" > Enregistrer les modifications </button>
- </div>
- </div>
Activez un modal sans écrire de JavaScript. Définissez data-toggle="modal"
un élément de contrôleur, comme un bouton, avec un data-target="#foo"
ou href="#foo"
pour cibler un modal spécifique à basculer.
- <button type = "button" data-toggle = "modal" data-target = "#myModal" > Lancer modal </button>
Appelez un modal avec id myModal
avec une seule ligne de JavaScript :
- $ ( '#monModal' ). modale ( options )
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-backdrop=""
.
Nom | taper | défaut | la description |
---|---|---|---|
toile de fond | booléen | vrai | Inclut un élément modal-backdrop. Vous pouvez également spécifier static un fond qui ne ferme pas le modal au clic. |
clavier | booléen | vrai | Ferme le modal lorsque la touche d'échappement est enfoncée |
Afficher | booléen | vrai | Affiche le modal lorsqu'il est initialisé. |
télécommande | chemin | faux | Si une URL distante est fournie, le contenu sera chargé via la
|
Active votre contenu en tant que modal. Accepte une option facultative object
.
- $ ( '#monModal' ). modale ({
- clavier : faux
- })
Bascule manuellement un modal.
- $ ( '#monModal' ). modal ( 'basculer' )
Ouvre manuellement un modal.
- $ ( '#monModal' ). modal ( 'montrer' )
Masque manuellement un modal.
- $ ( '#monModal' ). modal ( 'cacher' )
La classe modale de Bootstrap expose quelques événements pour se connecter à la fonctionnalité modale.
Événement | La description |
---|---|
Afficher | Cet événement se déclenche immédiatement lorsque la show méthode d'instance est appelée. |
montré | Cet événement est déclenché lorsque le modal a été rendu visible à l'utilisateur (il attendra que les transitions CSS soient terminées). |
cacher | Cet événement est déclenché immédiatement lorsque la hide méthode d'instance a été appelée. |
caché | Cet événement est déclenché lorsque le modal a fini d'être caché à l'utilisateur (il attendra que les transitions CSS soient terminées). |
- $ ( '#monModal' ). on ( 'caché' , fonction () {
- // faire quelque chose…
- })
Ajoutez des menus déroulants à presque tout avec ce plugin simple, y compris la barre de navigation, les onglets et les pilules.
Ajouter data-toggle="dropdown"
à un lien ou à un bouton pour basculer vers une liste déroulante.
- < classe div = "liste déroulante" >
- <a class = "dropdown-toggle" data-toggle = "dropdown" href = "#" > Déclencheur déroulant </a>
- <ul class = "dropdown-menu" role = "menu" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Pour conserver les URL intactes, utilisez l' data-target
attribut au lieu de href="#"
.
- < classe div = "liste déroulante" >
- <a class = "dropdown-toggle" id = "dLabel" role = "button" data-toggle = "dropdown" data-target = "#" href = "/page.html" >
- Menu déroulant
- <b classe = "caret" ></b>
- </a>
- <ul class = "dropdown-menu" role = "menu" aria-labelledby = "dLabel" >
- ...
- </ul>
- </div>
Appelez les listes déroulantes via JavaScript :
- $ ( '.dropdown-toggle' ). liste déroulante ()
Aucun
Une API programmatique pour basculer les menus pour une barre de navigation donnée ou une navigation par onglets.
Le plugin ScrollSpy permet de mettre à jour automatiquement les cibles de navigation en fonction de la position de défilement. Faites défiler la zone sous la barre de navigation et regardez la classe active changer. Les sous-éléments de la liste déroulante seront également mis en surbrillance.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork an enim lo-fi avant qu'ils ne soient épuisés. Tumblr des droits de vélo de la ferme à la table, peu importe. Cardigan Anim keffieh carles. Le photomaton de Velit seitan mcsweeney 3 wolf moon irure. Cosby pull lomo jean shorts, williamsburg hoodie minim dont vous n'avez probablement pas entendu parler et cardigan trust fund culpa biodiesel wes anderson esthétique. Nihil accusamus tatoué, credo ironie biodiesel keffieh artisan ullamco consequat.
Planche à roulettes à moustache Veniam marfa, barbe à fourche adipisicing fugiat velit. Freegan beard aliqua cupidatat vero de mcsweeney. Cupidatat quatre loko nisi, ea helvetica nulla carles. Camion de nourriture de pull cosby tatoué, vinyle non freegan de mcsweeney's quis. Lo-fi wes anderson +1 vestimentaire. Carles exercitation non esthétique qui s'embourgeoise. Brooklyn adipisicing bière artisanale vice keytar deserunt.
Occaecat commodo aliqua delectus. Planche à roulettes Fap Craft Beer Deserunt ea. Droits de bicyclette Lomo adipisicing banh mi, velit ea sunt café d'origine unique locavore de niveau supérieur dans magna veniam. High life id vinyl, echo park consequat quis aliquip banh mi pitchfork. Vero VHS est adipisicing. Consectetur nisi DIY minim messenger bag. Cred ex in, sac banane durable delectus consectetur iphone.
In incididunt echo park, officia deserunt mcsweeney's proident master cleanse thundercats sapiente veniam. Excepteur VHS elit, proident shoreditch +1 biodiesel laborum craft beer. Single-origin coffee wayfarers irure four loko, cupidatat terry richardson master cleanse. Assumenda you probably haven't heard of them art party fanny pack, tattooed nulla cardigan tempor ad. Proident wolf nesciunt sartorial keffiyeh eu banh mi sustainable. Elit wolf voluptate, lo-fi ea portland before they sold out four loko. Locavore enim nostrud mlkshk brooklyn nesciunt.
Ad leggings keytar, brunch id art party dolor labore. Pitchfork yr enim lo-fi before they sold out qui. Tumblr farm-to-table bicycle rights whatever. Anim keffiyeh carles cardigan. Velit seitan mcsweeney's photo booth 3 wolf moon irure. Cosby sweater lomo jean shorts, williamsburg hoodie minim qui you probably haven't heard of them et cardigan trust fund culpa biodiesel wes anderson aesthetic. Nihil tattooed accusamus, cred irony biodiesel keffiyeh artisan ullamco consequat.
Keytar twee blog, sac messager culpa marfa quel que soit le food truck délectus. Sapiente synth id assumenda. Locavore sed helvetica cliché ironie, Thundercats vous n'avez probablement pas entendu parler d'eux consequat hoodie sans gluten lo-fi fap aliquip. Labore elit placeat avant qu'ils ne soient épuisés, terry richardson proident brunch nesciunt quis cosby pull pariatur keffiyeh ut helvetica artisan. Cardigan bière artisanale seitan prêt à l'emploi velit. VHS chambray laboris tempor veniam. Anim mollit minim commodo ullamco Thundercats.
Pour ajouter facilement un comportement scrollspy à votre navigation dans la barre supérieure, ajoutez simplement data-spy="scroll"
l'élément que vous souhaitez espionner (le plus souvent, il s'agit du corps) et data-target=".navbar"
sélectionnez la navigation à utiliser. Vous voudrez utiliser scrollspy avec un .nav
composant.
- <body data-spy = "scroll" data-target = ".navbar" > ... </body>
Appelez le scrollspy via JavaScript :
- $ ( '#barre de navigation' ). parcheminespion ()
<a href="#home">home</a>
must correspond à quelque chose dans le dom comme
<div id="home"></div>
.
Lorsque vous utilisez scrollspy en conjonction avec l'ajout ou la suppression d'éléments du DOM, vous devrez appeler la méthode refresh comme ceci :
- $ ( '[data-spy="scroll"]' ). chaque ( fonction () {
- var $espion = $ ( ceci ). scrollspy ( 'actualiser' )
- });
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-offset=""
.
Nom | taper | défaut | la description |
---|---|---|---|
décalage | Numéro | dix | Pixels à décaler du haut lors du calcul de la position du défilement. |
Événement | La description |
---|---|
Activer | Cet événement se déclenche chaque fois qu'un nouvel élément est activé par le scrollspy. |
Ajoutez une fonctionnalité d'onglet rapide et dynamique pour passer d'un volet à l'autre du contenu local, même via des menus déroulants.
Denim brut, vous n'avez probablement pas entendu parler d'eux shorts en jean Austin. Nesciunt tofu sumptown aliqua, nettoyage de maître de synthé rétro. Moustache cliché tempor, williamsburg carles vegan helvetica. Reprehenderit boucher rétro keffieh dreamcatcher synthé. Cosby pull eu banh mi, qui irure terry richardson ex squid. Aliquip placeat salvia cillum iphone. Seitan aliquip quis cardigan american apparel, boucher voluptate nisi qui.
Food truck fixie locavore, accusamus mcsweeney's marfa nulla single-origin coffee squid. Exercitation +1 labore velit, blog sartorial PBR leggings next level wes anderson artisan four loko farm-to-table craft beer twee. Qui photo booth letterpress, commodo enim craft beer mlkshk aliquip jean shorts ullamco ad vinyl cillum PBR. Homo nostrud organic, assumenda labore aesthetic magna delectus mollit. Keytar helvetica VHS salvia yr, vero magna velit sapiente labore stumptown. Vegan fanny pack odio cillum wes anderson 8-bit, sustainable jean shorts beard ut DIY ethical culpa terry richardson biodiesel. Art party scenester stumptown, tumblr butcher vero sint qui sapiente accusamus tattooed echo park.
Etsy mixtape wayfarers, ethical wes anderson tofu before they sold out mcsweeney's organic lomo retro fanny pack lo-fi farm-to-table readymade. Messenger bag gentrify pitchfork tattooed craft beer, iphone skateboard locavore carles etsy salvia banksy hoodie helvetica. DIY synth PBR banksy irony. Leggings gentrify squid 8-bit cred pitchfork. Williamsburg banh mi whatever gluten-free, carles pitchfork biodiesel fixie etsy retro mlkshk vice blog. Scenester cred you probably haven't heard of them, vinyl craft beer blog stumptown. Pitchfork sustainable tofu synth chambray yr.
Trust fund seitan letterpress, keytar raw denim keffiyeh etsy art party avant qu'ils ne soient épuisés master clean sans gluten squid scenester freegan cosby pull. Fanny pack portland seitan DIY, art party locavore wolf cliché high life echo park Austin. Cred vinyl keffieh DIY salvia PBR, banh mi avant qu'ils ne vendent le pull cosby viral locavore VHS de la ferme à la table. Lomo loup viral, moustache readymade thundercats keffieh bière artisanale marfa éthique. Wolf salvia freegan, vestimentaire keffieh echo park végétalien.
Activer les onglets tabulables via JavaScript (chaque onglet doit être activé individuellement) :
- $ ( '#myTab a' ). cliquez sur ( fonction ( e ) {
- e . preventDefault ();
- $ ( ceci ). onglet ( 'afficher' );
- })
Vous pouvez activer des onglets individuels de plusieurs manières :
- $ ( '#myTab a[href="#profile"]' ). onglet ( 'afficher' ); // Sélectionner l'onglet par nom
- $ ( '#myTab a:first' ). onglet ( 'afficher' ); // Sélectionner le premier onglet
- $ ( '#myTab a:last' ). onglet ( 'afficher' ); // Sélectionner le dernier onglet
- $ ( '#myTab li:eq(2) a' ). onglet ( 'afficher' ); // Sélectionne le troisième onglet (indexé à 0)
Vous pouvez activer une navigation par onglets ou pilules sans écrire de JavaScript en spécifiant simplement data-toggle="tab"
ou data-toggle="pill"
sur un élément. L'ajout des classes nav
et à l'onglet appliquera le style de l'onglet Bootstrap.nav-tabs
ul
- <ul class = "nav nav-onglets" >
- <li><a href = "#home" data-toggle = "tab" > Accueil </a></li>
- <li><a href = "#profile" data-toggle = "tab" > Profil </a></li>
- <li><a href = "#messages" data-toggle = "tab" > Messagerie </a></li>
- <li><a href = "#settings" data-toggle = "tab" > Paramètres </a></li>
- </ul>
Active un élément d'onglet et un conteneur de contenu. L'onglet doit avoir un data-target
ou un href
ciblant un nœud de conteneur dans le DOM.
- <ul class = "nav nav-tabs" id = "myTab" >
- <li class = "active" ><a href = "#home" > Accueil </a></li>
- <li><a href = "#profile" > Profil </a></li>
- <li><a href = "#messages" > Messagerie </a></li>
- <li><a href = "#settings" > Paramètres </a></li>
- </ul>
- <div class = "tab-content" >
- <div class = "tab-pane active" id = "home" > ... </div>
- <div class = "tab-pane" id = "profil" > ... </div>
- <div class = "tab-pane" id = "messages" > ... </div>
- <div class = "tab-pane" id = "paramètres" > ... </div>
- </div>
- <script>
- $ ( fonction () {
- $ ( '#myTab a:last' ). onglet ( 'afficher' );
- })
- </script>
Événement | La description |
---|---|
Afficher | Cet événement se déclenche lors de l'affichage de l'onglet, mais avant l'affichage du nouvel onglet. Utilisez event.target et event.relatedTarget pour cibler respectivement l'onglet actif et l'onglet actif précédent (si disponible). |
montré | Cet événement se déclenche lors de l'affichage d'un onglet après l'affichage d'un onglet. Utilisez event.target et event.relatedTarget pour cibler respectivement l'onglet actif et l'onglet actif précédent (si disponible). |
- $ ( 'a[data-toggle="tab"]' ). on ( 'montré' , fonction ( e ) {
- e . cible // onglet activé
- e . relatedTarget // onglet précédent
- })
Inspiré de l'excellent plugin jQuery.tipsy écrit par Jason Frame ; Les info-bulles sont une version mise à jour, qui ne repose pas sur des images, utilise CSS3 pour les animations et les attributs de données pour le stockage local des titres.
Pour des raisons de performances, l'info-bulle et les API de données contextuelles sont opt-in, ce qui signifie que vous devez les initialiser vous -même .
Passez la souris sur les liens ci-dessous pour afficher les info-bulles :
Pantalons serrés de niveau supérieur keffieh dont vous n'avez probablement pas entendu parler. Photomaton beard raw denim letterpress vegan messenger bag sumptown. Du seitan de la ferme à la table, les vêtements américains fixie quinoa 8 bits durables de mcsweeney ont un chambray en vinyle terry richardson. Beard Stumptown, cardigans banh mi lomo thundercats. Tofu biodiesel williamsburg marfa, quatre loko mcsweeney's clean chambray végétalien. Un artisan vraiment ironique quel que soit le keytar , Scenester farm-to-table banksy Austin twitter handle freegan cred denim brut café d'origine unique viral.
Lorsque vous utilisez des info-bulles et des popovers avec les groupes d'entrée Bootstrap, vous devrez définir l' container
option (documentée ci-dessous) pour éviter les effets secondaires indésirables.
Déclenchez l'info-bulle via JavaScript :
- $ ( '#exemple' ). info -bulle ( options )
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-animation=""
.
Nom | taper | défaut | la description |
---|---|---|---|
animation | booléen | vrai | appliquer une transition de fondu css à l'info-bulle |
html | booléen | faux | Insérez html dans l'info-bulle. Si false, la text méthode de jquery sera utilisée pour insérer du contenu dans le dom. Utilisez du texte si vous craignez les attaques XSS. |
placement | chaîne | fonction | 'Haut' | comment positionner l'infobulle - top | bas | gauche | droit |
sélecteur | chaîne de caractères | faux | Si un sélecteur est fourni, les objets d'info-bulle seront délégués aux cibles spécifiées. |
Titre | chaîne | fonction | '' | valeur de titre par défaut si la balise `title` n'est pas présente |
gâchette | chaîne de caractères | 'survoler la mise au point' | comment l'info-bulle est déclenchée - cliquez | planer | concentrer | manuel. Notez que vous passez plusieurs déclencheurs, séparés par des espaces, types de déclencheurs. |
retard | nombre | objet | 0 | retarder l'affichage et le masquage de l'info-bulle (ms) - ne s'applique pas au type de déclenchement manuel Si un nombre est fourni, un délai est appliqué à la fois pour masquer/afficher La structure de l'objet est : |
récipient | chaîne | faux | faux | Ajoute l'info-bulle à un élément spécifique |
- <a href = "#" data-toggle = "tooltip" title = "first tooltip" > passez la souris sur moi </a>
Attache un gestionnaire d'info-bulles à une collection d'éléments.
Révèle l'info-bulle d'un élément.
- $ ( '#élément' ). info -bulle ( 'afficher' )
Masque l'info-bulle d'un élément.
- $ ( '#élément' ). info -bulle ( 'masquer' )
Bascule l'info-bulle d'un élément.
- $ ( '#élément' ). info -bulle ( 'basculer' )
Masque et détruit l'info-bulle d'un élément.
- $ ( '#élément' ). info -bulle ( 'détruire' )
Ajoutez de petites superpositions de contenu, comme celles de l'iPad, à n'importe quel élément pour héberger des informations secondaires. Survolez le bouton pour déclencher le popover. L'info - bulle doit être incluse.
Quatre options sont disponibles : aligné en haut, à droite, en bas et à gauche.
Sed posuere consectetur est à lobortis. Énée eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est à lobortis. Énée eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est à lobortis. Énée eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Sed posuere consectetur est à lobortis. Énée eu leo quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.
Aucun balisage affiché car les popovers ne sont générés à partir de JavaScript et du contenu d'un data
attribut.
Activez les popovers via JavaScript :
- $ ( '#exemple' ). popover ( options )
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-animation=""
.
Nom | taper | défaut | la description |
---|---|---|---|
animation | booléen | vrai | appliquer une transition de fondu css à l'info-bulle |
html | booléen | faux | Insérez html dans le popover. Si false, la text méthode de jquery sera utilisée pour insérer du contenu dans le dom. Utilisez du texte si vous craignez les attaques XSS. |
placement | chaîne | fonction | 'droit' | comment positionner le popover - top | bas | gauche | droit |
sélecteur | chaîne de caractères | faux | si un sélecteur est fourni, les objets d'info-bulle seront délégués aux cibles spécifiées |
gâchette | chaîne de caractères | 'Cliquez sur' | comment le popover est déclenché - cliquez | planer | concentrer | manuel |
Titre | chaîne | fonction | '' | valeur de titre par défaut si l'attribut `title` n'est pas présent |
contenu | chaîne | fonction | '' | valeur de contenu par défaut si l'attribut `data-content` n'est pas présent |
retard | nombre | objet | 0 | délai d'affichage et de masquage du popover (ms) - ne s'applique pas au type de déclenchement manuel Si un nombre est fourni, un délai est appliqué à la fois pour masquer/afficher La structure de l'objet est : |
récipient | chaîne | faux | faux | Ajoute le popover à un élément spécifique |
Pour des raisons de performances, les API de données Tooltip et Popover sont opt-in. Si vous souhaitez les utiliser, spécifiez simplement une option de sélection.
Initialise les popovers pour une collection d'éléments.
Révèle un popover d'éléments.
- $ ( '#élément' ). popover ( 'montrer' )
Masque un popover d'éléments.
- $ ( '#élément' ). popover ( 'cacher' )
Bascule un popover d'éléments.
- $ ( '#élément' ). popover ( 'basculer' )
Masque et détruit le popover d'un élément.
- $ ( '#élément' ). popover ( 'détruire' )
Ajoutez la fonctionnalité de rejet à tous les messages d'alerte avec ce plugin.
Changez ceci et cela et réessayez. Duis mollis, est non commodo luctus, nisi erat porttitor ligula, eget lacinia odio sem nec elit. Cras mattis consectetur purus sit amet fermentum.
Activer le rejet d'une alerte via JavaScript :
- $ ( ".alerte" ). alerte ()
Ajoutez simplement data-dismiss="alert"
à votre bouton de fermeture pour donner automatiquement une fonctionnalité de fermeture d'alerte.
- <a class = "close" data-dismiss = "alert" href = "#" > × </a>
Enveloppe toutes les alertes avec une fonctionnalité proche. Pour que vos alertes s'animent lorsqu'elles sont fermées, assurez-vous que la .fade
et la .in
classe leur sont déjà appliquées.
Ferme une alerte.
- $ ( ".alerte" ). alerte ( 'fermer' )
La classe d'alerte de Bootstrap expose quelques événements pour se connecter à la fonctionnalité d'alerte.
Événement | La description |
---|---|
proche | Cet événement se déclenche immédiatement lorsque la close méthode d'instance est appelée. |
fermé | Cet événement est déclenché lorsque l'alerte a été fermée (attendra que les transitions CSS soient terminées). |
- $ ( '#mon-alerte' ). lier ( 'fermé' , fonction () {
- // faire quelque chose…
- })
Obtenez des styles de base et une prise en charge flexible des composants pliables tels que les accordéons et la navigation.
* Nécessite l'inclusion du plugin Transitions.
En utilisant le plugin collapse, nous avons construit un simple widget de style accordéon :
- <div classe = "accordéon" id = "accordéon2" >
- <div class = "groupe-accordéon" >
- <div class = "accordion-heading" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
- Élément de groupe pliable #1
- </a>
- </div>
- <div id = "collapseOne" class = "effondrement du corps accordéon dans" >
- <div class = "accordion-inner" >
- Anim pariatur cliché...
- </div>
- </div>
- </div>
- <div class = "groupe-accordéon" >
- <div class = "accordion-heading" >
- <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
- Élément de groupe pliable #2
- </a>
- </div>
- <div id = "collapseTwo" class = "accordion-body collapse" >
- <div class = "accordion-inner" >
- Anim pariatur cliché...
- </div>
- </div>
- </div>
- </div>
- ...
Vous pouvez également utiliser le plugin sans le balisage accordéon. Faites en sorte qu'un bouton bascule entre l'expansion et la réduction d'un autre élément.
- < type de bouton = "bouton" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
- pliable simple
- </bouton>
- <div id = "demo" class = "collapse in" > … </div>
Ajoutez simplement data-toggle="collapse"
un data-target
élément à pour attribuer automatiquement le contrôle d'un élément pliable. L' data-target
attribut accepte un sélecteur CSS auquel appliquer le repli. Assurez-vous d'ajouter la classe collapse
à l'élément réductible. Si vous souhaitez qu'il soit ouvert par défaut, ajoutez la classe supplémentaire in
.
Pour ajouter une gestion de groupe en accordéon à un contrôle réductible, ajoutez l'attribut data data-parent="#selector"
. Reportez-vous à la démo pour voir cela en action.
Activer manuellement avec :
- $ ( ".collapse" ). s'effondrer ()
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-parent=""
.
Nom | taper | défaut | la description |
---|---|---|---|
parent | sélecteur | faux | Si sélecteur alors tous les éléments réductibles sous le parent spécifié seront fermés lorsque cet élément réductible est affiché. (similaire au comportement d'accordéon traditionnel) |
basculer | booléen | vrai | Bascule l'élément réductible à l'appel |
Active votre contenu en tant qu'élément pliable. Accepte une option facultative object
.
- $ ( '#myCollapsible' ). s'effondrer ({
- bascule : faux
- })
Bascule un élément réductible sur affiché ou masqué.
Affiche un élément réductible.
Masque un élément pliable.
La classe d'effondrement de Bootstrap expose quelques événements pour se connecter à la fonctionnalité d'effondrement.
Événement | La description |
---|---|
Afficher | Cet événement se déclenche immédiatement lorsque la show méthode d'instance est appelée. |
montré | Cet événement est déclenché lorsqu'un élément de repli a été rendu visible à l'utilisateur (il attendra que les transitions CSS soient terminées). |
cacher | Cet événement est déclenché immédiatement lorsque la hide méthode a été appelée. |
caché | Cet événement est déclenché lorsqu'un élément de repli a été masqué à l'utilisateur (il attendra que les transitions CSS soient terminées). |
- $ ( '#myCollapsible' ). on ( 'caché' , fonction () {
- // faire quelque chose…
- })
Le diaporama ci-dessous montre un plugin générique et un composant pour parcourir des éléments comme un carrousel.
- <div id = "myCarousel" class = "diapositive du carrousel" >
- <ol class = "indicateurs-carrousel" >
- <li data-target = "#myCarousel" data-slide-to = "0" class = "active" ></li>
- <li data-target = "#myCarousel" data-slide-to = "1" ></li>
- <li data-target = "#myCarousel" data-slide-to = "2" ></li>
- </ol>
- <!-- Éléments du carrousel -->
- <div class = "carousel-inner" >
- <div class = "élément actif" > … </div>
- <div class = "item" > … </div>
- <div class = "item" > … </div>
- </div>
- <!-- Navigation carrousel -->
- <a class = "carousel-control left" href = "#myCarousel" data-slide = "prev" > ‹ </a>
- <a class = "carousel-control right" href = "#myCarousel" data-slide = "next" > › </a>
- </div>
Utilisez les attributs de données pour contrôler facilement la position du carrousel. data-slide
accepte les mots clés prev
ou next
, ce qui modifie la position de la diapositive par rapport à sa position actuelle. Vous pouvez également utiliser data-slide-to
pour transmettre un index de diapositive brut au carrousel data-slide-to="2"
, qui fait passer la position de la diapositive à un index particulier commençant par 0
.
Appelez le carrousel manuellement avec :
- $ ( '.carrousel' ). carrousel ()
Les options peuvent être passées via des attributs de données ou JavaScriptz. Pour les attributs de données, ajoutez le nom de l'option à data-
, comme dans data-interval=""
.
Nom | taper | défaut | la description |
---|---|---|---|
intervalle | Numéro | 5000 | La durée de délai entre le cycle automatique d'un élément. Si false, le carrousel ne cyclera pas automatiquement. |
pause | chaîne de caractères | "flotter" | Met en pause le cycle du carrousel sur mouseenter et reprend le cycle du carrousel sur mouseleave. |
Initialise le carrousel avec des options facultatives object
et commence à parcourir les éléments.
- $ ( '.carrousel' ). carrousel ({
- intervalle : 2000
- })
Fait défiler les éléments du carrousel de gauche à droite.
Empêche le carrousel de parcourir les éléments.
Fait passer le carrousel à une image particulière (base 0, similaire à un tableau).
Passe à l'élément précédent.
Passe à l'élément suivant.
La classe de carrousel de Bootstrap expose deux événements pour se connecter à la fonctionnalité de carrousel.
Événement | La description |
---|---|
faire glisser | Cet événement se déclenche immédiatement lorsque la slide méthode d'instance est invoquée. |
glissé | Cet événement est déclenché lorsque le carrousel a terminé sa transition de diapositive. |
Un plug-in de base facilement extensible pour créer rapidement des saisies de texte élégantes avec n'importe quelle entrée de texte de formulaire.
- < type d'entrée = "texte" data-provide = "typeahead" >
Vous voudrez configurer autocomplete="off"
pour empêcher les menus du navigateur par défaut d'apparaître sur la liste déroulante de type Bootstrap.
Ajoutez des attributs de données pour enregistrer un élément avec la fonctionnalité de frappe comme indiqué dans l'exemple ci-dessus.
Appelez la saisie manuelle avec :
- $ ( '.typeahead' ). taper à l'avance ()
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-source=""
.
Nom | taper | défaut | la description |
---|---|---|---|
la source | tableau, fonction | [ ] | La source de données à interroger. Peut être un tableau de chaînes ou une fonction. La fonction reçoit deux arguments, la query valeur dans le champ de saisie et le process rappel. La fonction peut être utilisée de manière synchrone en retournant la source de données directement ou de manière asynchrone via l' process argument unique du rappel. |
éléments | Numéro | 8 | Le nombre maximum d'éléments à afficher dans la liste déroulante. |
Longueur minimale | Numéro | 1 | La longueur minimale de caractères nécessaire avant de déclencher des suggestions de saisie semi-automatique |
matcher | fonction | insensible à la casse | Méthode utilisée pour déterminer si une requête correspond à un élément. Accepte un seul argument, item par rapport auquel tester la requête. Accéder à la requête en cours avec this.query . Renvoie un booléen true si la requête est une correspondance. |
trieur | fonction | correspondance exacte, sensible à la casse, insensible à la casse |
Méthode utilisée pour trier les résultats de la saisie semi-automatique. Accepte un seul argument items et a la portée de l'instance typée. Référencez la requête en cours avec this.query . |
mise à jour | fonction | renvoie l'élément sélectionné | La méthode utilisée pour renvoyer l'élément sélectionné. Accepte un seul argument, le item et a la portée de l'instance typée. |
surligneur | fonction | met en surbrillance toutes les correspondances par défaut | Méthode utilisée pour mettre en évidence les résultats de la saisie semi-automatique. Accepte un seul argument item et a la portée de l'instance typée. Devrait retourner html. |
Initialise une entrée avec une saisie anticipée.
La sous-navigation sur la gauche est une démo en direct du plugin d'affixe.
Pour ajouter facilement un comportement d'affixe à n'importe quel élément, ajoutez simplement data-spy="affix"
à l'élément que vous souhaitez espionner. Utilisez ensuite les décalages pour définir quand activer et désactiver l'épinglage d'un élément.
- <div data-spy = "affixe" data-offset-top = "200" > ... </div>
affix
,
affix-top
et
affix-bottom
. N'oubliez pas de rechercher un parent potentiellement réduit lorsque l'affixe entre en jeu, car il supprime le contenu du flux normal de la page.
Appelez le plug-in d'affixe via JavaScript :
- $ ( '#barre de navigation' ). apposer ()
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-offset-top="200"
.
Nom | taper | défaut | la description |
---|---|---|---|
décalage | nombre | fonction | objet | dix | Pixels à décaler de l'écran lors du calcul de la position du défilement. Si un seul numéro est fourni, le décalage sera appliqué dans les directions supérieure et gauche. Pour écouter une seule direction ou plusieurs décalages uniques, fournissez simplement un objet offset: { x: 10 } . Utilisez une fonction lorsque vous devez fournir dynamiquement un décalage (utile pour certaines conceptions réactives). |