Javascript

Donnez vie aux composants de Bootstrap, désormais avec 13 plugins jQuery personnalisés.

La tête haute! Ces documents concernent la v2.3.2, qui n'est plus officiellement prise en charge. Découvrez la dernière version de Bootstrap !

Individuel ou compilé

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.

Attributs de données

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 :

  1. $ ( '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 :

  1. $ ( 'corps' ). désactivé ( '.alert.data-api' )

API programmatique

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.

  1. $ ( ".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) :

  1. $ ( "#monModal" ). modal () // initialisé avec les valeurs par défaut
  2. $ ( "#monModal" ). modal ({ keyboard : false }) // initialisé sans clavier
  3. $ ( "#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').

Pas de conflit

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 .noConflictle plugin dont vous souhaitez annuler la valeur.

  1. var bootstrapButton = $ . fn . bouton . noConflict () // retourne $.fn.button à la valeur précédemment assignée
  2. $ . fn . bootstrapBtn = bootstrapButton // donne à $().bootstrapBtn la fonctionnalité d'amorçage

Événements

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.

  1. $ ( '#monModal' ). on ( 'montrer' , fonction ( e ) {
  2. si (! données ) renvoie e . preventDefault () // empêche l'affichage du modal
  3. })

À propos des transitions

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à.

Cas d'utilisation

Quelques exemples du plugin de transition :

  • Glissement ou fondu dans les modaux
  • Disparition des onglets
  • Disparition des alertes
  • Vitres carrousel coulissantes

Exemples

Les modaux sont des invites de dialogue simplifiées, mais flexibles, avec les fonctionnalités minimales requises et des valeurs par défaut intelligentes.

Exemple statique

Un modal rendu avec un en-tête, un corps et un ensemble d'actions dans le pied de page.

  1. <div class = "modal hide fade" >
  2. <div class = "en-tête-modal" >
  3. < type de bouton = "bouton" class = "fermer" data-dismiss = "modal" aria-hidden = "true" > × </bouton>
  4. <h3> En-tête modal </h3>
  5. </div>
  6. <div class = "modal-body" >
  7. <p> Un beau corps… </p>
  8. </div>
  9. <div class = "modal-footer" >
  10. <a href = "#" class = "btn" > Fermer </a>
  11. <a href = "#" class = "btn btn-primary" > Enregistrer les modifications </a>
  12. </div>
  13. </div>

Démo en direct

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.

  1. <!-- Bouton pour déclencher modal -->
  2. <a href = "#myModal" role = "button" class = "btn" data-toggle = "modal" > Lancer la démo modale </a>
  3.  
  4. <!--Modalité -->
  5. <div id = "myModal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labelledby = "myModalLabel" aria-hidden = "true" >
  6. <div class = "en-tête-modal" >
  7. <button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × </button>
  8. <h3 id = "myModalLabel" > En -tête modal </h3>
  9. </div>
  10. <div class = "modal-body" >
  11. <p> Un beau corps… </p>
  12. </div>
  13. <div class = "modal-footer" >
  14. <bouton class = "btn" data-dismiss = "modal" aria-hidden = "true" > Fermer </button>
  15. <button class = "btn btn-primary" > Enregistrer les modifications </button>
  16. </div>
  17. </div>

Usage

Via les attributs de données

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.

  1. <button type = "button" data-toggle = "modal" data-target = "#myModal" > Lancer modal </button>

Via Javascript

Appelez un modal avec id myModalavec une seule ligne de JavaScript :

  1. $ ( '#monModal' ). modale ( options )

Choix

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 staticun 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 loadméthode de jQuery et injecté dans le fichier .modal-body. Si vous utilisez l'API de données, vous pouvez également utiliser la hrefbalise pour spécifier la source distante. Un exemple de ceci est montré ci-dessous :

  1. <a data-toggle="modal" href="remote.html" data-target="#modal">click me</a>

Méthodes

.modal(options)

Active votre contenu en tant que modal. Accepte une option facultative object.

  1. $ ( '#monModal' ). modale ({
  2. clavier : faux
  3. })

.modal('basculer')

Bascule manuellement un modal.

  1. $ ( '#monModal' ). modal ( 'basculer' )

.modal('montrer')

Ouvre manuellement un modal.

  1. $ ( '#monModal' ). modal ( 'montrer' )

.modal('masquer')

Masque manuellement un modal.

  1. $ ( '#monModal' ). modal ( 'cacher' )

Événements

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 showmé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 hidemé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).
  1. $ ( '#monModal' ). on ( 'caché' , fonction () {
  2. // faire quelque chose…
  3. })

Exemple dans la barre de navigation

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.

@gros

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.

@mdo

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.

une

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.

deux

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.

three

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.


Usage

Via les attributs de données

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 .navcomposant.

  1. <body data-spy = "scroll" data-target = ".navbar" > ... </body>

Via Javascript

Appelez le scrollspy via JavaScript :

  1. $ ( '#barre de navigation' ). parcheminespion ()
La tête haute! Les liens de la barre de navigation doivent avoir des cibles d'ID résolubles. Par exemple, un <a href="#home">home</a>must correspond à quelque chose dans le dom comme <div id="home"></div>.

Méthodes

.scrollspy('actualiser')

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 :

  1. $ ( '[data-spy="scroll"]' ). chaque ( fonction () {
  2. var $espion = $ ( ceci ). scrollspy ( 'actualiser' )
  3. });

Choix

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énements

Événement La description
Activer Cet événement se déclenche chaque fois qu'un nouvel élément est activé par le scrollspy.

Exemples d'onglets

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.


Usage

Activer les onglets tabulables via JavaScript (chaque onglet doit être activé individuellement) :

  1. $ ( '#myTab a' ). cliquez sur ( fonction ( e ) {
  2. e . preventDefault ();
  3. $ ( ceci ). onglet ( 'afficher' );
  4. })

Vous pouvez activer des onglets individuels de plusieurs manières :

  1. $ ( '#myTab a[href="#profile"]' ). onglet ( 'afficher' ); // Sélectionner l'onglet par nom
  2. $ ( '#myTab a:first' ). onglet ( 'afficher' ); // Sélectionner le premier onglet
  3. $ ( '#myTab a:last' ). onglet ( 'afficher' ); // Sélectionner le dernier onglet
  4. $ ( '#myTab li:eq(2) a' ). onglet ( 'afficher' ); // Sélectionne le troisième onglet (indexé à 0)

Balisage

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 navet à l'onglet appliquera le style de l'onglet Bootstrap.nav-tabsul

  1. <ul class = "nav nav-onglets" >
  2. <li><a href = "#home" data-toggle = "tab" > Accueil </a></li>
  3. <li><a href = "#profile" data-toggle = "tab" > Profil </a></li>
  4. <li><a href = "#messages" data-toggle = "tab" > Messagerie </a></li>
  5. <li><a href = "#settings" data-toggle = "tab" > Paramètres </a></li>
  6. </ul>

Méthodes

$().tab

Active un élément d'onglet et un conteneur de contenu. L'onglet doit avoir un data-targetou un hrefciblant un nœud de conteneur dans le DOM.

  1. <ul class = "nav nav-tabs" id = "myTab" >
  2. <li class = "active" ><a href = "#home" > Accueil </a></li>
  3. <li><a href = "#profile" > Profil </a></li>
  4. <li><a href = "#messages" > Messagerie </a></li>
  5. <li><a href = "#settings" > Paramètres </a></li>
  6. </ul>
  7.  
  8. <div class = "tab-content" >
  9. <div class = "tab-pane active" id = "home" > ... </div>
  10. <div class = "tab-pane" id = "profil" > ... </div>
  11. <div class = "tab-pane" id = "messages" > ... </div>
  12. <div class = "tab-pane" id = "paramètres" > ... </div>
  13. </div>
  14.  
  15. <script>
  16. $ ( fonction () {
  17. $ ( '#myTab a:last' ). onglet ( 'afficher' );
  18. })
  19. </script>

Événements

É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.targetet event.relatedTargetpour 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.targetet event.relatedTargetpour cibler respectivement l'onglet actif et l'onglet actif précédent (si disponible).
  1. $ ( 'a[data-toggle="tab"]' ). on ( 'montré' , fonction ( e ) {
  2. e . cible // onglet activé
  3. e . relatedTarget // onglet précédent
  4. })

Exemples

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.

Quatre directions

Info-bulles dans les groupes d'entrée

Lorsque vous utilisez des info-bulles et des popovers avec les groupes d'entrée Bootstrap, vous devrez définir l' containeroption (documentée ci-dessous) pour éviter les effets secondaires indésirables.


Usage

Déclenchez l'info-bulle via JavaScript :

  1. $ ( '#exemple' ). info -bulle ( options )

Choix

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 textmé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 :delay: { show: 500, hide: 100 }

récipient chaîne | faux faux

Ajoute l'info-bulle à un élément spécifiquecontainer: 'body'

La tête haute! Les options des info-bulles individuelles peuvent également être spécifiées via l'utilisation d'attributs de données.

Balisage

  1. <a href = "#" data-toggle = "tooltip" title = "first tooltip" > passez la souris sur moi </a>

Méthodes

$().info-bulle(options)

Attache un gestionnaire d'info-bulles à une collection d'éléments.

.tooltip('montrer')

Révèle l'info-bulle d'un élément.

  1. $ ( '#élément' ). info -bulle ( 'afficher' )

.tooltip('masquer')

Masque l'info-bulle d'un élément.

  1. $ ( '#élément' ). info -bulle ( 'masquer' )

.tooltip('basculer')

Bascule l'info-bulle d'un élément.

  1. $ ( '#élément' ). info -bulle ( 'basculer' )

.tooltip('détruire')

Masque et détruit l'info-bulle d'un élément.

  1. $ ( '#élément' ). info -bulle ( 'détruire' )

Exemples

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.

Popover statique

Quatre options sont disponibles : aligné en haut, à droite, en bas et à gauche.

Haut à enfiler

Sed posuere consectetur est à lobortis. Énée eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover à droite

Sed posuere consectetur est à lobortis. Énée eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Bas à enfiler

Sed posuere consectetur est à lobortis. Énée eu leo ​​quam. Pellentesque ornare sem lacinia quam venenatis vestibulum.

Popover à gauche

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 dataattribut.

Démo en direct

Quatre directions


Usage

Activez les popovers via JavaScript :

  1. $ ( '#exemple' ). popover ( options )

Choix

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 textmé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 :delay: { show: 500, hide: 100 }

récipient chaîne | faux faux

Ajoute le popover à un élément spécifiquecontainer: 'body'

La tête haute!Les options pour les popovers individuels peuvent également être spécifiées via l'utilisation d'attributs de données.

Balisage

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.

Méthodes

$().popover(options)

Initialise les popovers pour une collection d'éléments.

.popover('montrer')

Révèle un popover d'éléments.

  1. $ ( '#élément' ). popover ( 'montrer' )

.popover('masquer')

Masque un popover d'éléments.

  1. $ ( '#élément' ). popover ( 'cacher' )

.popover('basculer')

Bascule un popover d'éléments.

  1. $ ( '#élément' ). popover ( 'basculer' )

.popover('détruire')

Masque et détruit le popover d'un élément.

  1. $ ( '#élément' ). popover ( 'détruire' )

Exemples d'alertes

Ajoutez la fonctionnalité de rejet à tous les messages d'alerte avec ce plugin.

Sacré guacamole ! Tu ferais mieux de vérifier toi-même, tu n'as pas l'air trop bien.

Oh claquement ! Vous avez une erreur !

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.

Effectuez cette action Ou fais ça


Usage

Activer le rejet d'une alerte via JavaScript :

  1. $ ( ".alerte" ). alerte ()

Balisage

Ajoutez simplement data-dismiss="alert"à votre bouton de fermeture pour donner automatiquement une fonctionnalité de fermeture d'alerte.

  1. <a class = "close" data-dismiss = "alert" href = "#" > × </a>

Méthodes

$().alerte()

Enveloppe toutes les alertes avec une fonctionnalité proche. Pour que vos alertes s'animent lorsqu'elles sont fermées, assurez-vous que la .fadeet la .inclasse leur sont déjà appliquées.

.alerte('fermer')

Ferme une alerte.

  1. $ ( ".alerte" ). alerte ( 'fermer' )

Événements

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 closemé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).
  1. $ ( '#mon-alerte' ). lier ( 'fermé' , fonction () {
  2. // faire quelque chose…
  3. })

Exemples d'utilisations

Faites-en plus avec les boutons. Contrôlez les états des boutons ou créez des groupes de boutons pour plus de composants comme les barres d'outils.

Avec état

Ajouter data-loading-text="Loading..."pour utiliser un état de chargement sur un bouton.

  1. <button type = "button" class = "btn btn-primary" data-loading-text = "Chargement..." > État de chargement </button>

Bascule unique

Ajouter data-toggle="button"pour activer le basculement sur un seul bouton.

  1. <button type = "button" class = "btn btn-primary" data-toggle = "button" > Bascule unique </button>

Case à cocher

Ajouter data-toggle="buttons-checkbox"pour basculer le style de case à cocher sur btn-group.

  1. <div class = "btn-group" data-toggle = "boutons-case à cocher" >
  2. <button type = "button" class = "btn btn-primary" > Gauche </button>
  3. <button type = "button" class = "btn btn-primary" > Milieu </button>
  4. <button type = "button" class = "btn btn-primary" > Droite </button>
  5. </div>

Radio

Ajouter data-toggle="buttons-radio"pour basculer le style radio sur btn-group.

  1. <div class = "btn-group" data-toggle = "boutons-radio" >
  2. <button type = "button" class = "btn btn-primary" > Gauche </button>
  3. <button type = "button" class = "btn btn-primary" > Milieu </button>
  4. <button type = "button" class = "btn btn-primary" > Droite </button>
  5. </div>

Usage

Activer les boutons via JavaScript :

  1. $ ( '.nav-tabs' ). bouton ()

Balisage

Les attributs de données font partie intégrante du plugin de bouton. Consultez l'exemple de code ci-dessous pour les différents types de balisage.

Choix

Aucun

Méthodes

$().bouton('basculer')

Bascule l'état de poussée. Donne au bouton l'apparence qu'il a été activé.

La tête haute! Vous pouvez activer le basculement automatique d'un bouton à l'aide de l' data-toggleattribut.
  1. < type de bouton = "bouton" class = "btn" data-toggle = "bouton" > </bouton>

$().bouton('chargement')

Définit l'état du bouton sur chargement - désactive le bouton et remplace le texte par le texte de chargement. Le texte de chargement doit être défini sur l'élément de bouton à l'aide de l'attribut data data-loading-text.

  1. <button type = "button" class = "btn" data-loading-text = "loading stuff..." > ... </button>
La tête haute! Firefox conserve l'état désactivé à travers les chargements de page . Une solution de contournement consiste à utiliser autocomplete="off".

$().bouton('réinitialiser')

Réinitialise l'état du bouton - remplace le texte par le texte d'origine.

$().bouton(chaîne)

Réinitialise l'état du bouton - remplace le texte par n'importe quel état de texte défini par les données.

  1. < type de bouton = "bouton" class = "btn" data-complete-text = "terminé !" > ... </bouton>
  2. <script>
  3. $ ( '.btn' ). bouton ( 'complet' )
  4. </script>

À propos de

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.

Exemple d'accordéon

En utilisant le plugin collapse, nous avons construit un simple widget de style accordéon :

Anim pariatur cliché reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, brunch dolor skateboard non cupidatat. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua met un oiseau dessus calamar café d'origine unique nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, bière artisanale labore wes anderson cred nesciunt sapiente ea proident. Annonce vegan excepteur boucher vice lomo. Leggings occaecat bière artisanale de la ferme à la table, synthé esthétique denim brut dont vous n'avez probablement pas entendu parler accusamus labore VHS durable.
Anim pariatur cliché reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, brunch dolor skateboard non cupidatat. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua met un oiseau dessus calamar café d'origine unique nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, bière artisanale labore wes anderson cred nesciunt sapiente ea proident. Annonce vegan excepteur boucher vice lomo. Leggings occaecat bière artisanale de la ferme à la table, synthé esthétique denim brut dont vous n'avez probablement pas entendu parler accusamus labore VHS durable.
Anim pariatur cliché reprehenderit, enim eiusmod high life accusamus terry richardson ad squid. 3 wolf moon officia aute, brunch dolor skateboard non cupidatat. Food truck quinoa nesciunt laborum eiusmod. Brunch 3 wolf moon tempor, sunt aliqua met un oiseau dessus calamar café d'origine unique nulla assumenda shoreditch et. Nihil anim keffiyeh helvetica, bière artisanale labore wes anderson cred nesciunt sapiente ea proident. Annonce vegan excepteur boucher vice lomo. Leggings occaecat bière artisanale de la ferme à la table, synthé esthétique denim brut dont vous n'avez probablement pas entendu parler accusamus labore VHS durable.
  1. <div classe = "accordéon" id = "accordéon2" >
  2. <div class = "groupe-accordéon" >
  3. <div class = "accordion-heading" >
  4. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseOne" >
  5. Élément de groupe pliable #1
  6. </a>
  7. </div>
  8. <div id = "collapseOne" class = "effondrement du corps accordéon dans" >
  9. <div class = "accordion-inner" >
  10. Anim pariatur cliché...
  11. </div>
  12. </div>
  13. </div>
  14. <div class = "groupe-accordéon" >
  15. <div class = "accordion-heading" >
  16. <a class = "accordion-toggle" data-toggle = "collapse" data-parent = "#accordion2" href = "#collapseTwo" >
  17. Élément de groupe pliable #2
  18. </a>
  19. </div>
  20. <div id = "collapseTwo" class = "accordion-body collapse" >
  21. <div class = "accordion-inner" >
  22. Anim pariatur cliché...
  23. </div>
  24. </div>
  25. </div>
  26. </div>
  27. ...

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.

  1. < type de bouton = "bouton" class = "btn btn-danger" data-toggle = "collapse" data-target = "#demo" >
  2. pliable simple
  3. </bouton>
  4.  
  5. <div id = "demo" class = "collapse in" > </div>

Usage

Via les attributs de données

Ajoutez simplement data-toggle="collapse"un data-targetélément à pour attribuer automatiquement le contrôle d'un élément pliable. L' data-targetattribut 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.

Via Javascript

Activer manuellement avec :

  1. $ ( ".collapse" ). s'effondrer ()

Choix

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

Méthodes

.collapse(options)

Active votre contenu en tant qu'élément pliable. Accepte une option facultative object.

  1. $ ( '#myCollapsible' ). s'effondrer ({
  2. bascule : faux
  3. })

.collapse('basculer')

Bascule un élément réductible sur affiché ou masqué.

.collapse('montrer')

Affiche un élément réductible.

.collapse ('masquer')

Masque un élément pliable.

Événements

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 showmé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 hidemé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).
  1. $ ( '#myCollapsible' ). on ( 'caché' , fonction () {
  2. // faire quelque chose…
  3. })

Exemple

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.

  1. < 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.


Usage

Via les attributs de données

Ajoutez des attributs de données pour enregistrer un élément avec la fonctionnalité de frappe comme indiqué dans l'exemple ci-dessus.

Via Javascript

Appelez la saisie manuelle avec :

  1. $ ( '.typeahead' ). taper à l'avance ()

Choix

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 queryvaleur dans le champ de saisie et le processrappel. 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' processargument 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, itempar rapport auquel tester la requête. Accéder à la requête en cours avec this.query. Renvoie un booléen truesi 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 itemset 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 itemet 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 itemet a la portée de l'instance typée. Devrait retourner html.

Méthodes

.typeahead (options)

Initialise une entrée avec une saisie anticipée.

Exemple

La sous-navigation sur la gauche est une démo en direct du plugin d'affixe.


Usage

Via les attributs de données

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.

  1. <div data-spy = "affixe" data-offset-top = "200" > ... </div>
La tête haute! Vous devez gérer la position d'un élément épinglé et le comportement de son parent immédiat. La position est contrôlée par affix, affix-topet 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.

Via Javascript

Appelez le plug-in d'affixe via JavaScript :

  1. $ ( '#barre de navigation' ). apposer ()

Choix

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).