Clause de non-responsabilité: Cet article a été généré par traduction automatique.

Comment ajouter de l’accordéon dans Markdown ?

Prev Next

Plans prenant en charge la personnalisation du texte dans l’éditeur Markdown

Professional
Business
Enterprise






Si vous souhaitez que votre contenu apparaisse en accordéon dans les articles basés sur l’éditeur Markdown, il n’est pas possible de l’ajouter à l’aide d’un outil conventionnel de la barre de menu ou d’une syntaxe Markdown simple.

Utilisez la solution de contournement ci-dessous pour ajouter un accordéon sans effort dans l’éditeur Markdown.

Solution

  1. Accédez à l’article souhaité et ouvrez-le dans l’éditeur Markdown.

  2. Collez le code ci-dessous à l’endroit souhaité où vous souhaitez que l’accordéon apparaisse

<details>
    <summary>Accordion_name</summary>
    <p>Accordion_content</p>
    </details>
  1. Remplacez le texte par le titre/le nom de l’accordéon Accordion_name souhaité

  2. Remplacez le Accordion_content texte par le contenu souhaité

Si vous souhaitez ajouter des titres à l’intérieur de l’accordéon, vous pouvez utiliser les balises HTML de titre (<h2>..</h2>, <h3>..</h3>, <h4>..</h4>) dans les Accordion_content sections

PRUDENCE

Les balises d’en-tête peuvent être utilisées dans la section récapitulative de l’accordéon « Accordion_name », mais l’alignement du texte peut être affecté.

Exemple

Code

<details>
    <summary><strong>What is Document360?</strong></summary>
    <p>A well-structured product to create a world-class knowledge base for your customers and employees. Content producers get the power, whereas content consumers get the simplicity.</p>
    <h4>Core parts</h4>
    <ul>
        <li>Knowledge base portal</li>
        <li>Knowledge base site</li>
        <li>Knowledge base widget</li>
        <li>API documentation</li>
    </ul>
</details>

Résultat

Qu’est-ce que Document360 ?

Un produit bien structuré pour créer une base de connaissances de classe mondiale pour vos clients et vos employés. Les producteurs de contenu obtiennent le pouvoir tandis que les consommateurs de contenu obtiennent la simplicité.

Pièces de base

  • Portail de la base de connaissances

  • Site de la base de connaissances

  • Widget de la base de connaissances

  • Documentation de l’API


Personnalisations avancées pour les accordéons

Vous pouvez améliorer l’accordéon en ajoutant des couleurs, des bordures en pointillés et des icônes, et en le réglant pour qu’il s’ouvre toujours. Voici comment appliquer ces personnalisations :

Ajouter la couleur de l’en-tête à l’accordéon

Pour ajouter une couleur d’en-tête à l’accordéon dans les articles, suivez les étapes ci-dessous :

  1. Accédez à Paramètres () > site de la base de connaissances > Personnaliser le site > CSS et JavaScript personnalisés dans le portail de la base de connaissances.

  2. Dans le volet de navigation de gauche, cliquez sur l’onglet CSS et collez l’extrait de code CSS suivant :

.details-wrapper details[open] summary {
    background-color: yellow !important;
    border-radius: 0.75rem 0.75rem 0rem 0rem !important;
}
.details-wrapper summary {
    background-color: yellow !important;
    border-radius: 0.75rem 0.75rem 0.75rem 0.75rem !important;
}
.details-wrapper details:not([open]) summary {
    background-color: yellow !important;
    border-radius: 0.75rem 0.75rem 0.75rem 0.75rem !important;
}
  1. Cliquez sur Enregistrer.


Application d’une couleur de bordure et de lignes pointillées

Pour appliquer une couleur de bordure et des pointillés au survol :

  1. Accédez à Paramètres () > site de la base de connaissances > Personnaliser le site > CSS et JavaScript personnalisés dans le portail de la base de connaissances.

  2. Dans le volet de navigation de gauche, cliquez sur l’onglet CSS et collez l’extrait de code CSS suivant :

.details-arrow {
    left: 16px !important;
    top: 42% !important;
    transition: revert;
    transform: rotate(317deg);
}
.details-wrapper details {
    border: 1px dotted var(--e360-base-light-gray) !important;
    transition: border 0.3s ease;
}
.details-wrapper details: hover {
    border: 1px solid var(--e360-base-light-gray) !important;
}
.details-wrapper_rendered summary {
    left: 19px;
    position: relative;
}
.details-wrapper details[open]+.details-arrow {
    transform: rotate(45deg);
}
  1. Personnalisez le code ci-dessus en fonction de vos besoins.

  2. Une fois cela fait, cliquez sur Enregistrer.


Régler un accordéon pour qu’il s’ouvre toujours

Pour garder un accordéon toujours ouvert, modifiez l’attribut open directement dans le code HTML :

<details open>
    <summary>Always Open Accordion</summary>
    <p>Content remains visible without user interaction.</p>
</details>

Cela garantit que le contenu est visible par défaut.


Ajout d’une icône plus à l’en-tête de l’accordéon

Pour ajouter une icône plus qui pivote à l’ouverture :

  1. Accédez à Paramètres () > site de la base de connaissances > Personnaliser le site > CSS et JavaScript personnalisés dans le portail de la base de connaissances.

  2. Dans le volet de navigation de gauche, cliquez sur l’onglet CSS et collez l’extrait de code CSS suivant :

    .details-wrapper details summary::before {
        content: "+";
        display: inline-block;
        margin-right: 10px;
        transition: transform 0.3s ease;
    }
    .details-wrapper details[open] summary::before {
        content: "-";
        transform: rotate(45deg);
    }
  3. Ajustez les icônes ou les transitions selon vos préférences.

  4. Cliquez sur Enregistrer.


Foire aux questions

Puis-je styliser un accordéon en utilisant uniquement Markdown ?

Markdown en lui-même ne prend pas en charge le style avancé ou l’interactivité comme vous le trouveriez avec HTML et CSS. Cependant, vous pouvez obtenir un simple effet d’accordéon en utilisant les fonctionnalités intégrées de Markdown, en particulier avec les plates-formes qui le prennent en charge, telles que Document360.

Quelles sont les limites de l’utilisation de Markdown pour les accordéons ?

  • Prise en charge du navigateur : Les <details> éléments et <summary> fonctionnent dans la plupart des navigateurs modernes, mais peuvent ne pas s’afficher correctement dans tous les environnements Markdown.

  • Style: Vous ne pourrez pas styliser l’accordéon (par exemple, les couleurs, les bordures) au-delà des styles par défaut du navigateur.

  • Interactivité: L’interactivité se limite à réduire et à développer le texte sans animations ni options de conception supplémentaires.

Comment puis-je créer un accordéon à l’aide de Markdown ?

L’utilisation des <details> balises et <summary> dans Markdown est la meilleure façon de créer un accordéon de base sans CSS ou JavaScript supplémentaire. Pour améliorer le style ou les fonctionnalités, vous devrez recourir au HTML et au CSS ou utiliser un processeur Markdown qui permet des styles personnalisés.