Composants

Des dizaines de composants réutilisables sont intégrés à Bootstrap pour fournir une navigation, des alertes, des popovers et bien plus encore.

Groupes de boutons

Utilisez des groupes de boutons pour joindre plusieurs boutons en un seul composant composite. Construisez-les avec une série d' éléments <a>ou <button>.

Les meilleures pratiques

Nous recommandons les directives suivantes pour l'utilisation des groupes de boutons et des barres d'outils :

  • Utilisez toujours le même élément dans un seul groupe de boutons, <a>ou <button>.
  • Ne mélangez pas des boutons de couleurs différentes dans le même groupe de boutons.
  • Utilisez des icônes en plus ou à la place du texte, mais assurez-vous d'inclure le texte alternatif et le titre, le cas échéant.

Les groupes de boutons associés avec des listes déroulantes (voir ci-dessous) doivent être appelés séparément et toujours inclure un curseur déroulant pour indiquer le comportement souhaité.

Exemple par défaut

Voici à quoi ressemble le code HTML pour un groupe de boutons standard construit avec des boutons de balise d'ancrage :

  1. <div class = "btn-group" >
  2. <a class = "btn" href = "#" > 1 </a>
  3. <a class = "btn" href = "#" > 2 </a>
  4. <a class = "btn" href = "#" > 3 </a>
  5. </div>

Exemple de barre d'outils

Combinez des ensembles de <div class="btn-group">dans un <div class="btn-toolbar">pour des composants plus complexes.

1 2 3 4
5 6 sept
8
  1. <div class = "btn-toolbar" >
  2. <div class = "btn-group" >
  3. ...
  4. </div>
  5. </div>

Case à cocher et saveurs radio

Les groupes de boutons peuvent également fonctionner comme des radios, où un seul bouton peut être actif, ou des cases à cocher, où n'importe quel nombre de boutons peut être actif. Consultez la documentation Javascript pour cela.

Obtenir le javascript »


La tête haute

Le CSS pour les groupes de boutons se trouve dans un fichier séparé, button-groups.less.

Listes déroulantes des boutons

Utilisez n'importe quel bouton pour déclencher un menu déroulant en le plaçant dans un .btn-groupet en fournissant le balisage de menu approprié.


La tête haute! Les listes déroulantes de boutons nécessitent le plug-in de liste déroulante Bootstrap pour fonctionner.

Exemple de balisage

Semblable à un groupe de boutons, notre balisage utilise un balisage de bouton régulier, mais avec quelques ajouts pour affiner le style et prendre en charge le plugin jQuery déroulant de Bootstrap.

  1. <div class = "btn-group" >
  2. <a class = "btn dropdown-toggle" data-toggle = "dropdown" href = "#" >
  3. Action
  4. <span class = "caret" ></span>
  5. </a>
  6. <ul class = "dropdown-menu" >
  7. <!-- liens du menu déroulant -->
  8. </ul>
  9. </div>

Listes déroulantes des boutons de fractionnement

En nous appuyant sur les styles et le balisage des groupes de boutons, nous pouvons facilement créer un bouton partagé. Les boutons partagés comportent une action standard à gauche et une bascule déroulante à droite avec des liens contextuels.

Exemple de balisage

Nous développons les listes déroulantes de boutons normales pour fournir une deuxième action de bouton qui fonctionne comme un déclencheur de liste déroulante distinct.

  1. <div class = "btn-group" >
  2. <a class = "btn" href = "#" > Action </a>
  3. <a class = "btn dropdown-toggle" data-toggle = "dropdown" href = "#" >
  4. <span class = "caret" ></span>
  5. </a>
  6. <ul class = "dropdown-menu" >
  7. <!-- liens du menu déroulant -->
  8. </ul>
  9. </div>

Pagination multi-pages

Quand utiliser

Pagination ultra simpliste et minimaliste inspirée de Rdio, idéale pour les applications et les résultats de recherche. Le grand bloc est difficile à manquer, facilement évolutif et offre de grandes zones de clic.

Liens de page avec état

Les liens sont personnalisables et fonctionnent dans un certain nombre de circonstances avec la bonne classe. .disabledpour les liens non cliquables et .activepour la page courante.

Alignement flexible

Ajoutez l'une des deux classes facultatives pour modifier l'alignement des liens de pagination : .pagination-centeredet .pagination-right.

Exemples

Le composant de pagination par défaut est flexible et fonctionne dans un certain nombre de variantes.

Balisage

Enveloppé dans un <div>, la pagination est juste un <ul>.

  1. <div class = "pagination" >
  2. <ul>
  3. <li><a href = "#" > Précédent </a></li>
  4. <li classe = "active" >
  5. <a href = "#" > 1 </a>
  6. </li>
  7. <li><a href = "#" > 2 </a></li>
  8. <li><a href = "#" > 3 </a></li>
  9. <li><a href = "#" > 4 ​​</a></li>
  10. <li><a href = "#" > Suivant </a></li>
  11. </ul>
  12. </div>

Téléavertisseur Pour des liens rapides précédents et suivants

À propos du téléavertisseur

Le composant pager est un ensemble de liens pour des implémentations de pagination simples avec un balisage léger et des styles encore plus légers. C'est idéal pour les sites simples comme les blogs ou les magazines.

Exemple par défaut

Par défaut, le pager centre les liens.

  1. <ul class = "pager" >
  2. <li>
  3. <a href = "#" > Précédent </a>
  4. </li>
  5. <li>
  6. <a href = "#" > Suivant </a>
  7. </li>
  8. </ul>

Liens alignés

Alternativement, vous pouvez aligner chaque lien sur les côtés :

  1. <ul class = "pager" >
  2. <li classe = "précédent" >
  3. <a href = "#" > Plus ancien </a>
  4. </li>
  5. <li classe = "suivant" >
  6. <a href = "#" > Plus récent → </a>
  7. </li>
  8. </ul>
Étiquettes Balisage
Défaut <span class="label">Default</span>
Succès <span class="label label-success">Success</span>
Avertissement <span class="label label-warning">Warning</span>
Important <span class="label label-important">Important</span>
Info <span class="label label-info">Info</span>

Unité de héros

Bootstrap fournit un composant léger et flexible appelé unité de héros pour présenter le contenu de votre site. Cela fonctionne bien sur les sites marketing et à forte teneur en contenu.

Balisage

Enveloppez votre contenu dans un divcomme suit :

  1. <div class = "hero-unit" >
  2. <h1> Titre </h1>
  3. <p> Slogan </p>
  4. <p>
  5. <a class = "btn btn-primary btn-large" >
  6. Apprendre encore plus
  7. </a>
  8. </p>
  9. </div>

Bonjour le monde!

Il s'agit d'une simple unité de héros, un simple composant de style jumbotron pour attirer une attention particulière sur le contenu ou les informations présentés.

Apprendre encore plus

En-tête de page

Un shell simple pour h1espacer et segmenter de manière appropriée les sections de contenu sur une page. Il peut utiliser l' élément h1default , ainsi que la plupart des autres composants (avec des styles supplémentaires).small

  1. <div class = "page-haeder" >
  2. <h1> Exemple d'en-tête de page </h1>
  3. </div>

Vignettes par défaut

Par défaut, les vignettes de Bootstrap sont conçues pour présenter des images liées avec un minimum de balisage requis.

Hautement personnalisable

Avec un peu de balisage supplémentaire, il est possible d'ajouter n'importe quel type de contenu HTML comme des titres, des paragraphes ou des boutons dans les vignettes.

  • Libellé de vignette

    Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida et eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

    Action Action

  • Libellé de vignette

    Cras justo odio, dapibus ac facilisis in, egestas eget quam. Donec id elit non mi porta gravida et eget metus. Nullam id dolor id nibh ultricies vehicula ut id elit.

    Action Action

Pourquoi utiliser des vignettes

Les vignettes (auparavant .media-gridjusqu'à la v1.4) sont idéales pour les grilles de photos ou de vidéos, les résultats de recherche d'images, les produits de vente au détail, les portefeuilles et bien plus encore. Il peut s'agir de liens ou de contenu statique.

Balisage simple et flexible

Le balisage des miniatures est simple : un ulavec n'importe quel nombre d' liéléments est tout ce qui est requis. Il est également super flexible, permettant à tout type de contenu avec juste un peu plus de balisage pour envelopper votre contenu.

Utilise des tailles de colonne de grille

Enfin, le composant vignettes utilise des classes de système de grille existantes, telles que .span2ou, .span3pour contrôler les dimensions des vignettes.

Le balisage

Comme mentionné précédemment, le balisage requis pour les vignettes est léger et simple. Voici un aperçu de la configuration par défaut des images liées :

  1. <ul class = "thumbnails" >
  2. <li classe = "span3" >
  3. <a href = "#" class = "thumbnail" >
  4. <img src = "https://placehold.it/260x180" alt = "" >
  5. </a>
  6. </li>
  7. ...
  8. </ul>

Pour le contenu HTML personnalisé dans les miniatures, le balisage change légèrement. Pour autoriser le contenu au niveau du bloc n'importe où, nous remplaçons le <a>par un <div>semblable :

  1. <ul class = "thumbnails" >
  2. <li classe = "span3" >
  3. <div class = "thumbnail" >
  4. <img src = "https://placehold.it/260x180" alt = "" >
  5. <h5> Libellé de la vignette </h5>
  6. <p> Légende de la vignette juste ici... </p>
  7. </div>
  8. </li>
  9. ...
  10. </ul>

Plus d'exemples

Explorez toutes vos options avec les différentes classes de grille à votre disposition. Vous pouvez également mélanger et assortir différentes tailles.

Valeurs par défaut légères

Classe de base réécrite

Avec Bootstrap 2, nous avons simplifié la classe de base : .alertau lieu de .alert-message. Nous avons également réduit le balisage minimum requis : no <p>est requis par défaut, juste le <div>.

Message d'alerte unique

Pour un composant plus durable avec moins de code, nous avons supprimé l'apparence de différenciation pour les alertes de blocage, les messages qui viennent avec plus de rembourrage et généralement plus de texte. La classe a également changé en .alert-block.


Va très bien avec javascript

Bootstrap est livré avec un excellent plugin jQuery qui prend en charge les messages d'alerte, ce qui permet de les rejeter rapidement et facilement.

Obtenir le plug-in »

Exemples d'alertes

Enveloppez votre message et une icône de fermeture facultative dans une div avec une classe simple.

× Avertissement! Tu ferais mieux de vérifier toi-même, tu n'as pas l'air trop bien.
  1. < classe div = "alerte" >
  2. <a class = "close" data-dismiss = "alert" > × </a>
  3. <strong> Attention ! </strong> Tu ferais mieux de vérifier toi-même, tu n'as pas l'air trop bien.
  4. </div>

Étendez facilement le message d'alerte standard avec deux classes facultatives : .alert-blockpour plus de contrôles de remplissage et de texte et .alert-headingpour un en-tête correspondant.

×

Avertissement!

Tu ferais mieux de vérifier toi-même, tu n'as pas l'air trop bien. Nulla vitae elit libero, a pharetra augue. Praesent commodo cursus magna, vel scelerisque nisl consectetur et.

  1. <div class = "alert alert-block" >
  2. <a class = "close" data-dismiss = "alert" > × </a>
  3. <h4 class = "alert-heading" > Attention ! </h4>
  4. Tu ferais mieux de vérifier toi-même, tu n'es pas...
  5. </div>

Alternatives contextuelles Ajouter des classes facultatives pour modifier la connotation d'une alerte

Erreur ou danger

× Oh claquement ! Modifiez quelques éléments et essayez de soumettre à nouveau.
  1. <div class = "alerte alerte-erreur" >
  2. ...
  3. </div>

Succès

× Bien fait! Vous avez lu avec succès cet important message d'alerte.
  1. <div class = "alert alert-success" >
  2. ...
  3. </div>

Informations

× La tête haute! Cette alerte requiert votre attention, mais elle n'est pas très importante.
  1. <div class = "alerte alerte-info" >
  2. ...
  3. </div>

Exemples et balisage

De base

Barre de progression par défaut avec un dégradé vertical.

  1. < classe div = "progrès" >
  2. < classe div = "barre"
  3. style = " largeur : 60 %; " ></div>
  4. </div>

Rayé

Utilise un dégradé pour créer un effet rayé.

  1. <div class = "progrès progrès-info
  2. progress-rayé" >
  3. < classe div = "barre"
  4. style = " largeur : 20 %; " ></div>
  5. </div>

Animé

Prend l'exemple rayé et l'anime.

  1. <div class = "progrès progrès-danger
  2. progress-striped active" >
  3. < classe div = "barre"
  4. style = " largeur : 40 %; " ></div>
  5. </div>

Options et prise en charge du navigateur

Couleurs supplémentaires

Les barres de progression utilisent certains des mêmes noms de classe que les boutons et les alertes pour un style similaire.

  • .progress-info
  • .progress-success
  • .progress-danger

Alternativement, vous pouvez personnaliser les fichiers LESS et rouler vos propres couleurs et tailles.

Comportement

Les barres de progression utilisent des transitions CSS3, donc si vous ajustez dynamiquement la largeur via javascript, elles se redimensionneront en douceur.

Si vous utilisez la .activeclasse, vos .progress-stripedbarres de progression animeront les rayures de gauche à droite.

Prise en charge du navigateur

Les barres de progression utilisent des dégradés, des transitions et des animations CSS3 pour obtenir tous leurs effets. Ces fonctionnalités ne sont pas prises en charge dans IE7-8 ou les versions antérieures de Firefox.

Opera ne prend pas en charge les animations pour le moment.

puits

Utilisez le puits comme simple effet sur un élément pour lui donner un effet d'encart.

Regarde, je suis dans un puits !
  1. < classe div = "bien" >
  2. ...
  3. </div>

Fermer l'icône

Utilisez l'icône de fermeture générique pour ignorer le contenu comme les modaux et les alertes.

×

  1. <a class = "fermer" > × </a>