Jamdesk Documentation logo

Onglets

Panneaux pour du contenu mutuellement exclusif (gestionnaires de paquets, langages). Les titres correspondants se synchronisent sur toute la page.

Chaque fois que votre page propose des alternatives parallèles (gestionnaires de paquets, langages de programmation, instructions spécifiques à un OS), les onglets permettent aux lecteurs de choisir une fois et de rester dans le contexte. Les titres d'onglets correspondants se synchronisent automatiquement sur toute la page : sélectionner « yarn » dans un groupe fait basculer tous les autres groupes npm/yarn/pnpm pour correspondre.

Utilisez les onglets quand :

  • Plusieurs implémentations du même concept existent (npm/yarn/pnpm, JavaScript/Python)
  • Des options parallèles sont mutuellement exclusives (l'utilisateur en choisit une, pas les deux)
  • La cohérence compte - le choix du lecteur doit persister sur toute la page

Utilisation

<Tabs>
  <Tab title="npm">npm install jamdesk</Tab>
  <Tab title="pnpm">pnpm add jamdesk</Tab>
</Tabs>

Onglets de base

Content for the first tab.

<Tabs>
  <Tab title="First Tab">

    Content for the first tab.

</Tab>
  <Tab title="Second Tab">

    Content for the second tab.

</Tab>
  <Tab title="Third Tab">

    Content for the third tab.

</Tab>
</Tabs>

Onglets vs CodeGroup vs Accordion

ComposantIdéal pourSe synchronise
TabsChoix de contenu mutuellement exclusifsOui (sur toute la page)
CodeGroupBlocs de code en plusieurs langagesNon
AccordionSections repliables, FAQNon

Règle générale : Utilisez Tabs quand le choix du lecteur (comme le gestionnaire de paquets préféré) doit persister sur toute la page. Utilisez CodeGroup pour des comparaisons de code uniquement. Utilisez Accordion pour du contenu qui peut être tout pertinent.

Onglets avec icônes

Ajoutez des icônes aux titres d'onglets en utilisant les icônes Font Awesome :

function App() {
  return <h1>Hello React</h1>;
}
<Tabs>
  <Tab title="React" icon="react" iconType="brands">

    ```jsx
    function App() {
      return <h1>Hello React</h1>;
    }
    ```

</Tab>
  <Tab title="Vue" icon="vuejs" iconType="brands">

    ```vue
    <template>
      <h1>Hello Vue</h1>
    </template>
    ```

</Tab>
</Tabs>

Bordure inférieure

Utilisez la prop borderBottom pour ajouter un séparateur visuel sous le contenu de l'onglet :

Ce groupe d'onglets a une bordure inférieure pour la séparation visuelle.

<Tabs borderBottom>
  <Tab title="Overview">

    This tab group has a bottom border for visual separation.

</Tab>
  <Tab title="Details">

    Useful when tabs contain varying content lengths.

</Tab>
</Tabs>

Onglets synchronisés

Les onglets avec des titres correspondants se synchronisent automatiquement sur toute la page. Cliquez sur « yarn » dans un groupe et tous les onglets npm/yarn/pnpm de la page basculent ensemble :

Installer :

npm install my-package

Exécuter :

npm run dev

La synchronisation se produit quand les titres d'onglets correspondent (insensible à la casse).

Props

Tabs

booleandefault: false

Ajoute une bordure inférieure et un espacement au conteneur de contenu de l'onglet. Utile pour séparer visuellement le contenu à onglets du reste de la page.

Tab

stringrequired

Le libellé affiché dans la barre d'onglets. Les onglets avec des titres correspondants synchronisent automatiquement leur sélection sur toute la page.

string

Nom d'icône Font Awesome à afficher avant le titre (par exemple, « react », « code », « terminal »).

stringdefault: solid

Style d'icône Font Awesome. Options : regular, solid, light, thin, sharp-solid, duotone, brands.

Et ensuite ?

Vue d'ensemble des composants

Parcourir tous les composants disponibles

Bases de MDX

Apprendre à utiliser les composants dans MDX