À quoi ça sert ?
Le menu partagé est le fil rouge de l’écosystème : un bouton de navigation présent sur l’ensemble des sites et outils. Il est utilisé sur les outils du comité data. Et il peut être utilisé facilement sur tous les sites (outils communs, sites régionaux …) qui souhaitent intégrer ce menu. Il permet aux utilisateurs de passer d’un outil à l’autre de manière fluide, et donne une cohérence visuelle à l’ensemble de la plateforme.
C’est une application 100% client : un simple fichier JavaScript hébergé sur GitLab Pages, chargé par chaque outil de l’écosystème. Aucun serveur dédié n’est nécessaire.
Ce menu peut se “contextualiser” par réseau : des liens spécifiques s’affichent selon le réseau, pour permettre aux utilisateurs de revenir dans les sites et outils de leur réseau.
Principe de fonctionnement
C’est un Web Component (
- Un bouton fixe de 44 px (icône « TL ») s’affiche dans un coin configurable de la page
- Au clic, un panneau de navigation s’ouvre avec les liens vers tous les outils de l’écosystème
- Les entrées du menu sont gérées dans Grist (document national, page 🚦 Menu commun, table MenuItems) et servies par l’API des tiers-lieux (api.tiers-lieux.fr/menu), ce qui permet de les mettre à jour sans toucher au code
- Un cache localStorage de 5 minutes assure un affichage instantané sans requête réseau
- Le composant détecte automatiquement le réseau régional (Bretagne, Réunion, etc.) et le transmet d’un site à l’autre par les liens du menu ; il le mémorise aussi entre les sites *.tiers-lieux.fr (les navigateurs cloisonnent cette mémoire par domaine)
- Un **fallback statique **prend le relais si l’API est indisponible
Intégration
L’intégration sur n’importe quel site se fait en deux lignes :
<script type="module" src="https://menu.tiers-lieux.fr/menu.js"></script> <tl-menu></tl-menu>
Compatible avec les sites statiques, Svelte, React, ou via reverse proxy Nginx.
Le script se charge toujours avec type=“module”. Un site qui restreint ses ressources (politique de sécurité CSP) doit autoriser menu.tiers-lieux.fr pour le script et l’iframe, et api.tiers-lieux.fr pour la lecture des entrées. Tout ce que le menu affiche (entrées Grist, réseau transmis par les liens) est traité comme du texte : un lien piégé ne peut rien injecter dans la page. Détails dans le README du dépôt.