Icône de barre latérale dynamique pour Discourse

:information_source: Résumé Rend l’icône de bascule de la barre latérale dynamique et personnalisable
:hammer_and_wrench: Dépôt https://github.com/Lillinator/discourse-dynamic-sidebar-icon
:eyeglasses: Aperçu https://discourse.theme-creator.io/theme/Lilly/discourse-sidebar-icon
:question: Guide d’installation Comment installer un thème ou un composant de thème
:open_book: Nouveau sur les thèmes Discourse ? Guide de démarrage pour l’utilisation des thèmes Discourse

Installer ce composant de thème

Icône de barre latérale dynamique pour Discourse

:woman_technologist:t2: Résumé

Un composant de thème Discourse léger qui modifie dynamiquement l’icône de bascule de la barre latérale dans l’en-tête en fonction de l’état ouvert ou fermé de celle-ci.

Par défaut, le composant affiche le menu hamburger standard (bars) lorsque la barre latérale est fermée, et passe à une icône de fermeture (xmark) lorsqu’elle est ouverte. Les administrateurs peuvent également spécifier des icônes personnalisées.

:star: Fonctionnalités

  • Offre aux utilisateurs un retour visuel clair sur la manière d’interagir avec la barre latérale.
  • Les administrateurs peuvent facilement remplacer les icônes par défaut par n’importe quelle icône FontAwesome via les paramètres du thème.
  • Ce composant est exclusivement destiné aux vues de bureau et tablette ; il n’a aucun effet sur mobile.

Enregistrement d'écran 2026-04-15 à 23.16.01|vidéo

Enregistrement d'écran 2026-04-15 à 23.14.27|vidéo

:wrench: Paramètres

Personnalisez les icônes utilisées pour ouvrir et fermer la barre latérale en modifiant les paramètres du composant :

paramètre description
icon_to_open_the_sidebar l’icône affichée lorsque la barre latérale est réduite
(par défaut : bars)
icon_to_close_the_sidebar l’icône affichée lorsque la barre latérale est développée
(par défaut : xmark)

:warning: Remarques importantes

  • Si vous utilisez des icônes personnalisées qui ne sont pas déjà incluses dans le noyau de Discourse, elles s’afficheront en blanc ; pour corriger cela, vous devez ajouter les icônes personnalisées (par exemple, rocket, cat) au paramètre du site Sous-ensemble d'icônes SVG dans vos paramètres d’administration Discourse (voir Tous les paramètres du siteSous-ensemble d'icônes SVG).
  • Ce composant ne fonctionne pas avec le mode déroulant de l’en-tête.
10 « J'aime »

J’ai refactorisé le composant et ajouté un nouveau paramètre booléen Appliquer l'icône ouverte sur mobile (désactivé par défaut). Cela permet aux administrateurs qui modifient l’icône d’ouverture par défaut (bars) de choisir de l’activer pour les vues mobiles afin d’assurer une cohérence de l’expérience utilisateur. La barre latérale de superposition mobile se comporte différemment, de sorte que l’icône ne change pas lorsque la barre latérale est activée sur un petit format d’écran. J’ai également mis à jour le message original.

2 « J'aime »