Éléments Bootstrap

Posté le 12 août 2023  (Dernière modification le 2 février 2025) • 12 min de lecture • 2 381 mots
Partager via

Utilisez des shortcodes pour ajouter facilement des éléments Bootstrap courants.

Éléments Bootstrap
Photo par Nathan Dumlao  sur Unsplash 

Hinode propose plusieurs shortcodes qui enveloppent des composants Bootstrap courants. Consultez la documentation officielle  pour plus de détails.

Abbr  

À titre d’exemple, le shortcode suivant affiche le texte complet d’une abréviation lorsque survolé.

CI/CD
markdown
{{< abbr "CI/CD" >}}

Accordéon  

À titre d’exemple, le shortcode suivant affiche un accordéon avec trois éléments, dont le premier élément est déplié.

Il s’agit du contenu du corps du premier élément de l’accordéon. Il prend en charge le contenu HTML, s’il est activé dans le moteur de rendu goldmark. L’élément est affiché en ajoutant la valeur show à l’argument class.
Il s’agit du contenu du corps du deuxième élément de l’accordéon.
Il s’agit du contenu du corps du troisième élément de l’accordéon.
markdown
{{< accordion >}}
  {{< accordion-item header="Élément d'accordéon #1" show="true" >}}
    Il s'agit du contenu du corps du premier élément de l'accordéon. Il prend en charge le contenu HTML, s'il est activé dans le moteur de rendu goldmark. L'élément est affiché en ajoutant la valeur `show` à l'argument `class`.
  {{< /accordion-item >}}
  {{< accordion-item header="Élément d'accordéon #2" >}}
    Il s'agit du contenu du corps du deuxième élément de l'accordéon.
  {{< /accordion-item >}}
  {{< accordion-item header="Élément d'accordéon #3" >}}
    Il s'agit du contenu du corps du troisième élément de l'accordéon.
  {{< /accordion-item >}}
{{< /accordion >}}

Alerte  

À titre d’exemple, le shortcode suivant affiche une alerte simple.

markdown
{{< alert color="danger" dismissible="true" >}}
    Une simple alerte de danger — vérifiez-la !
{{< /alert >}}

Badge  

Utilisez le shortcode “badge” pour afficher un badge avec un en-tête.

En-tête 1 Nouveau

En-tête 2 Nouveau

En-tête 3 Nouveau

En-tête 4 Nouveau

En-tête 5 Nouveau

En-tête 6 Nouveau

markdown
En-tête 1 {{< badge title="Nouveau" >}}
{.h1}

En-tête 2 {{< badge title="Nouveau" >}}
{.h2}

En-tête 3 {{< badge title="Nouveau" >}}
{.h3}

En-tête 4 {{< badge title="Nouveau" >}}
{.h4}

En-tête 5 {{< badge title="Nouveau" >}}
{.h5}

En-tête 6 {{< badge title="Nouveau" >}}
{.h6}

Fil d’Ariane  

À titre d’exemple, le shortcode suivant affiche un fil d’Ariane pour la page du blog.

markdown
{{< breadcrumb path="blog" >}}

Bouton  

À titre d’exemple, le shortcode suivant affiche une infobulle pour un bouton sombre avec un badge.

markdown
{{< button color="secondary" tooltip="Cliquez sur la boîte de réception pour voir vos messages non lus." href="#!" badge="99+" >}}
    Boîte de réception
{{< /button >}}

Groupe de boutons  

À titre d’exemple, le shortcode suivant affiche un groupe de trois boutons.

markdown
{{< button-group aria-label="Basic example" >}}
  {{< button color="primary" href="#!" >}}Gauche{{< /button >}}
  {{< button color="primary" href="#!" >}}Millieu{{< /button >}}
  {{< button color="primary" href="#!" >}}Droite{{< /button >}}
{{< /button-group >}}

Carte  

À titre d’exemple, le shortcode suivant affiche une carte empilée qui renvoie à la page à propos. Elle inclut un en-tête personnalisé.

markdown
{{< card path="about" padding="3" class="col-6 mx-auto" color="body-tertiary"
  header="publication" footer="none" button=true />}}

Groupe de cartes  

À titre d’exemple, le shortcode suivant affiche un groupe de cartes avec trois éléments.

 

Framework Bootstrap

Créez des sites rapides et réactifs avec Bootstrap 5. Personnalisez facilement votre site avec les fichiers source Sass.
 

Recherche en texte intégral

Recherchez votre site avec FlexSearch, une bibliothèque de recherche en texte intégral avec zéro dépendances.
 

Outils de développement

Utilisez Node Package Manager pour automatiser le processus de construction et suivre les dépendances.
markdown
{{< card-group padding="3" gutter="3" button=true buttonType="link" cols=2 scroll=true >}}
    {{< card title="Framework Bootstrap" icon="fab bootstrap" >}}
        Créez des sites rapides et réactifs avec Bootstrap 5. Personnalisez facilement votre site
        avec les fichiers source Sass.
    {{< /card >}}
    {{< card title="Recherche en texte intégral" icon="fas magnifying-glass" >}}
        Recherchez votre site avec FlexSearch, une bibliothèque de recherche en texte intégral
        avec zéro dépendances.
    {{< /card >}}
    {{< card title="Outils de développement" icon="fas code" >}}
        Utilisez Node Package Manager pour automatiser le processus de construction et suivre
        les dépendances.
    {{< /card >}}
{{< /card-group >}}

Carrousel  

À titre d’exemple, le shortcode suivant affiche un carrousel centré avec trois slides, un rapport hauteur/largeur de 16:9 et une largeur relative de 67 % sur les grands écrans.

markdown
{{< carousel ratio="16x9" class="col-sm-12 col-lg-8 mx-auto" >}}
  {{< img src="img/coffee.jpg" caption="slide 1" >}}
  {{< img src="img/phone.jpg" caption="slide 2" >}}
  {{< img src="img/dunes.jpg" caption="slide 3" >}}
{{< /carousel >}}

Réduire  

À titre d’exemple, le shortcode suivant affiche un bouton qui, lorsqu’il est cliqué, déclenche l’apparition ou la disparition d’un panneau.

 
Un contenu de remplacement destiné au composant de repliement. Ce panneau est initialement masqué, mais il sera révélé lorsque l’utilisateur active le déclencheur correspondant.
markdown
{{< button collapse="collapse-1" >}}
    Déclencher le panneau
{{< /button >}}

{{< collapse id="collapse-1" class="p-3 border rounded bg-primary-subtle" >}}
    Un contenu de remplacement destiné au composant de repliement. Ce panneau est initialement masqué, mais il
    sera révélé lorsque l'utilisateur active le déclencheur correspondant.
{{< /collapse >}}

Invite de commandes  

Utilisez le shortcode command pour générer un bloc avec un invite de commandes bash par défaut.

export MY_VAR=123
markdown
{{< command >}}
export MY_VAR=123
{{< /command >}}

Spécifiez user et host pour ajouter le contexte de l’utilisateur à l’invite. De plus, utilisez (out) pour spécifier une ligne de sortie et utilisez \ pour indiquer une continuation de ligne.

export MY_VAR=123
echo "hello"
hello
echo one \
two \
three
one two three
echo "goodbye"
goodbye
markdown
{{< command user="user" host="localhost" >}}
export MY_VAR=123
echo "hello"
(out)hello
echo one \
two \
three
(out)one two three
echo "goodbye"
(out)goodbye
{{< /command >}}

Documentation  

Utilisez le shortcode docs pour afficher le contenu d’un fichier js, scss ou toml :

[style]
    primary = "#d43900"
    secondary = "#6c757d"
    success = "#198754"
    info = "#0dcaf0"
    warning = "#ffc107"
    danger = "#dc3545"
    light = "#f8f9fa"
    dark = "#212529"
    themeOpacity = "10"
    darkModeShade = "20%"
    darkModeTint = "40%"
    themeFont = "Inter"
    # themeFontPath = "https://fonts.googleapis.com/css2?family=Inter:wght@200;300;600&display=swap" # external path
    themeFontPath = "/fonts" # local path
    themeFontPreload = "/fonts/inter-v12-latin-regular.woff2"
    purge = true

Exemple  

Utilisez le shortcode example pour afficher un exemple de code et pour afficher un aperçu de la même entrée.

export MY_VAR=123
markdown
{{< command >}}
export MY_VAR=123
{{< /command >}}

Fichier  

Utilisez le shortcode file pour afficher et mettre en évidence le contenu complet d’un fichier d’entrée donné.

# toml-docs-start lang-main
[en]
languageName = "English"
contentDir = "content/en"
weight = 1
# toml-docs-end lang-main
# toml-docs-start lang-param
[en.params.head]
tagline = "A Hugo Theme"
[en.params.social]
title = "Follow me"
caption = "I work on everything coding and tweet developer memes"
[en.params.footer]
# license = "Licensed under Creative Commons (<a href='https://creativecommons.org/licenses/by-nc-sa/4.0/' class='link-secondary' target='_blank' rel='noopener noreferrer nofollow'>CC BY-NC-SA 4.0</a>)."
# toml-docs-end lang-param
[en.params.sections.blog]
reference = "More Posts"
[en.params.sections.projects]
reference = "More Projects"

[nl]
languageName = "Nederlands"
contentDir = "content/nl"
weight = 2
[nl.params.opengraph]
locale = "nl_NL"
[nl.params.head]
tagline = "Een Hugo Thema"
[nl.params.social]
title = "Volg mij"
caption = "Ik doe aan programmeren en tweet memes"
[nl.params.footer]
# license = "Gelicenseerd onder Creative Commons (<a href='https://creativecommons.org/licenses/by-nc-sa/4.0/' class='link-secondary' target='_blank' rel='noopener noreferrer nofollow'>CC BY-NC-SA 4.0</a>)."
[nl.params.sections.blog]
reference = "Meer artikelen"
[nl.params.sections.projects]
title = "Projecten"
reference = "Meer projecten"

[fr]
languageName = "Français"
contentDir = "content/fr"
weight = 2
[fr.params.opengraph]
locale = "fr_FR"
[fr.params.head]
tagline = "Un thème Hugo"
[fr.params.social]
title = "Suivez-moi"
caption = "Je code et je tweet des mèmes de développeurs."
[fr.params.footer]
# license = "Gelicenseerd onder Creative Commons (<a href='https://creativecommons.org/licenses/by-nc-sa/4.0/' class='link-secondary' target='_blank' rel='noopener noreferrer nofollow'>CC BY-NC-SA 4.0</a>)."
[fr.params.sections.blog]
reference = "Plus d'articles"
[fr.params.sections.projects]
title = "Projets"
reference = "Plus de projets"
markdown
{{< file path="./config/_default/languages.toml" id="file-collapse-1" >}}

Icon  

À titre d’exemple, les shortcodes suivants affichent une coche carrée, un logo de marque et une coche circulaire.

     
markdown
{{< fa square-check >}}
{{< fab linkedin >}}
{{< fas circle-check >}}

Image  

À titre d’exemple, le shortcode suivant affiche une image avec des coins arrondis et un ratio d’aspect de 21:9.

Légende de l'image
Légende de l'image
markdown
{{< image src="img/flowers.jpg" ratio="21x9" caption="Légende de l'image" class="rounded" >}}

À titre d’exemple, le shortcode suivant affiche une image vectorielle classique.

image
markdown
{{< image src="/img/logo_icon.svg" class="col-sm-6 col-lg-4" wrapper="text-center" >}}

À titre d’exemple, le shortcode suivant affiche une image vectorielle avec une référence de symbole.

markdown
{{< image src="/img/logo_var.svg#logo" class="col-sm-6 col-lg-4" wrapper="text-center" >}}

Lien  

À titre d’exemple, les shortcodes suivants rendent des liens dans différents formats.

markdown
- {{< link hinode >}}Lien nommé avec les paramètres par défaut{{< /link >}}
- {{< link name=hinode cue=false tab=false >}}Lien nommé s'ouvrant dans l'onglet actuel sans icône{{< /link >}}
- {{< link name=hinode cue=true tab=true >}}Lien nommé s'ouvrant dans un nouvel onglet avec icône{{< /link >}}
- {{< link hinode />}}
- {{< link href="https://developer.mozilla.org" >}}Lien externe{{< /link >}}
- {{< link "./projects/another-project" >}}Lien interne avec titre{{< /link >}}
- {{< link url="projects/another-project" />}}
- {{< link url="/projects/another-project" />}}
- {{< link url="../projects/another-project" case=false />}}
- {{< link "about" />}}
- {{< link "/en/about/" />}}
- {{< link url="/en/about/" force=true >}}About (Anglais){{< /link >}}
- {{< link "#image" />}}
- {{< link "components/#map" />}}

Mark  

Utilisez le shortcode mark pour mettre en évidence le texte. Le contenu interne est utilisé en tant qu’entrée.

Utilisez le shortcode mark pour mettre en évidence un texte spécifique.
markdown
Utilisez le shortcode `mark` pour {{< mark >}}mettre en évidence{{< /mark >}} un texte spécifique.

À titre d’exemple, le shortcode suivant affiche un groupe d’onglets avec des onglets alignés verticalement.

markdown
  {{< nav type="pills" vertical="true" >}}
    {{< nav-item header="Élément de navigation #1" show="true" >}}
      Voici le contenu de navigation du premier élément. Il prend en charge le contenu HTML, s'il est
      activé dans le moteur de rendu Goldmark. L'élément est affiché en ajoutant la valeur `show` à l'argument `class`.
    {{< /nav-item >}}
    {{< nav-item header="Élément de navigation #2" >}}
      Voici le contenu de navigation du deuxième élément.
    {{< /nav-item >}}
    {{< nav-item header="Élément de navigation #3" >}}
      Voici le contenu de navigation du troisième élément.
    {{< /nav-item >}}
  {{< /nav >}}

Barre de navigation  

À titre d’exemple, le shortcode suivant affiche un en-tête de navigation clair.

markdown
{{< navbar id="navbar-sample" path="blog" color="primary" size="md" search="false" menus="sample" title="Marque" mode="false" >}}

Publication  

À titre d’exemple, le shortcode suivant affiche un bouton de publication par défaut.

markdown
{{< release version="v0.14.1" >}}

Indicateur de chargement  

À titre d’exemple, le raccourci suivant affiche un indicateur de chargement centré.

Chargement...
markdown
{{< spinner color="info" class="text-center" >}}
Chargement...
{{< /spinner >}}

Sub  

À titre d’exemple, le shortcode suivant affiche du texte en indice.

H2O est un liquide.
markdown
H{{< sub 2 >}}O est un liquide.

Sup  

À titre d’exemple, le shortcode suivant affiche du texte en exposant.

210 équivaut à 1024.
markdown
2{{< sup 10 >}} équivaut à 1024.

Chronologie  

À titre d’exemple, le shortcode suivant affiche une chronologie avec le fichier data/timeline-fr.yml en tant que données.

1 juillet 2023

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.

6 mai 2023

Lorem ipsum dolor sit amet.

4 février 2023

Cupiditate ducimus officiis quod!

Version bêta

30 novembre 2022

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.

1 juillet 2023

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.

6 mai 2023

Lorem ipsum dolor sit amet.

4 février 2023

Cupiditate ducimus officiis quod!

Version bêta

30 novembre 2022

Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum. Lorem ipsum dolor sit amet, consectetur adipisicing elit. Cupiditate ducimus officiis quod! Aperiam eveniet nam nostrum odit quasi ullam voluptatum.

markdown
{{< timeline data="timeline-fr" background="dark" >}}

Notification  

À titre d’exemple, le shortcode suivant affiche un bouton qui, lorsqu’il est cliqué, déclenche le message de notification.

Affiche la notification #1   Affiche la notification #1  
markdown
{{< button toast="toast-example-1" >}}
    Affiche la notification #1
{{< /button >}}

{{< button toast="toast-example-2" >}}
    Affiche la notification #1
{{< /button >}}

{{< toast id="toast-example-1" header="Premier titre" >}}
    Ceci est le premier message de notification. Il prend en charge le `markdown`.
{{< /toast >}}

{{< toast id="toast-example-2" header="Deuxième titre" >}}
    Ceci est le deuxième message de notification. Il prend en charge le `markdown`.
{{< /toast >}}

Infobulle  

À titre d’exemple, le shortcode suivant affiche une infobulle pour un lien hypertexte coloré.

d’une infobulle
markdown
{{< tooltip color="primary" title="Légende de l'infobulle" href="#!" >}}Démonstration{{< /tooltip >}} d'une infobulle

Vidéo  

À titre d’exemple, le shortcode suivant affiche une vidéo d’éléphant hébergée par Cloudinary.

markdown
{{< video host="cloudinary" account="demo" id="elephants" autoplay=true >}}