Composant partagé
Un menu commun à tous les sites tiers-lieux
Un bouton discret dans un coin de la page, qui ouvre la liste des outils de l'écosystème : annuaire, mise à jour des données, aiguillage, observatoire… Il s'intègre en deux lignes sur n'importe quel site, et ses liens se gèrent sans toucher au code.
Essayez-le : c'est le bouton en haut à droite de cette page.
L'intégrer en deux lignes
Collez ces deux lignes juste avant </body>. Gardez
type="module" : sans lui, le menu ne s'affiche pas.
<script type="module" src="https://menu.tiers-lieux.fr/menu.js"></script> <tl-menu></tl-menu>
Placez <tl-menu> comme enfant direct de <body> : sa
position fixe se calcule alors correctement, même si le site utilise des transform ou des
filter.
Selon votre site
<body> <!-- contenu du site --> <script type="module" src="https://menu.tiers-lieux.fr/menu.js"></script> <tl-menu></tl-menu> </body>
<!-- src/app.html --> <script type="module" src="https://menu.tiers-lieux.fr/menu.js"></script> <!-- src/routes/+layout.svelte --> <tl-menu></tl-menu>
// app/layout.tsx
import Script from 'next/script'
export default function RootLayout({ children }) {
return (
<html lang="fr">
<body>
{children}
<Script type="module" src="https://menu.tiers-lieux.fr/menu.js" />
<tl-menu />
</body>
</html>
)
}# Pour une application dont vous ne maîtrisez pas le HTML
location / {
proxy_pass http://localhost:8484;
proxy_set_header Accept-Encoding "";
sub_filter_once on;
sub_filter '</body>' '
<script type="module" src="https://menu.tiers-lieux.fr/menu.js"></script>
<tl-menu position="bottom-right"></tl-menu>
</body>';
}Réglages
| Attribut | Effet |
|---|---|
position | Coin du bouton : top-right (par défaut), top-left, bottom-right, bottom-left. |
offset | Distance au bord de la fenêtre, en pixels (16 par défaut). Utile si le site a déjà un élément dans ce coin : offset="70" pour passer sous une barre de 60 px. |
current | Force l'entrée marquée « vous êtes ici » : la valeur est cherchée dans l'adresse de chaque entrée. Par défaut, le menu la trouve seul en comparant les adresses au site courant. |
Couleurs
Le menu suit la charte des données tiers-lieux et garde la police du système : il ne charge aucune police chez vous, et vos styles ne débordent pas dans ses textes. Pour l'accorder à votre site, posez des variables CSS sur l'élément.
<style>
tl-menu { --tlm-action: #2f5d50; --tlm-action-fonce: #1f4037; }
</style>Aussi disponibles : --tlm-texte, --tlm-texte-2,
--tlm-texte-doux, --tlm-bordure, --tlm-bordure-douce,
--tlm-trait, --tlm-fond-doux, --tlm-fond-puce,
--tlm-reseau-fond, --tlm-reseau-texte.
Le contexte réseau
Les réseaux régionaux ont leurs propres sites. Quand un réseau est choisi, ses liens passent en tête du menu, sous son nom, avant les outils nationaux.
- DétectéSur un site rattaché à un réseau dans la liste des entrées, ce réseau s'active seul.
- ChoisiLe bouton « Réseau » du
panneau permet de le choisir : il est alors mémorisé entre les sites
*.tiers-lieux.fr. L'étiquette du réseau se retire d'un clic, sur tous ces sites. - TransmisLes liens du menu emportent
le réseau (
#tl-region=…) le temps de la visite, sans le mémoriser.
Seul un réseau choisi est mémorisé. Les navigateurs cloisonnent la mémoire par domaine :
un choix fait sur tierslieux.re n'est pas connu de tiers-lieux.fr.
Les entrées du menu
Elles se gèrent dans le document Grist national, page « Menu commun », table
MenuItems, tenue par le comité data. Le document n'est pas public : le menu les lit via
https://api.tiers-lieux.fr/menu, et une modification apparaît sur tous les sites en moins
de 10 minutes.
| Colonne | Type | Rôle |
|---|---|---|
label | Texte | Libellé affiché |
URL | Texte | Adresse de destination (http ou https) |
info_bulle | Texte | Texte affiché au survol |
poids | Entier | Ordre d'affichage |
parent | Référence | Entrée parente : crée un sous-menu |
bientot | Case | Affiche l'étiquette « bientôt », sans lien |
appel_a_l_action | Case | Bouton plein en bas du panneau |
Reseau | Texte | Réseau régional de l'entrée (vide : national) |
Si l'API ne répond pas, le menu affiche une liste de secours, et il garde 5 minutes en mémoire la dernière liste reçue pour s'afficher sans attendre.
Sites à politique de sécurité stricte
Un site qui restreint ses ressources (Content-Security-Policy) doit autoriser :
| Directive | Origine | Pourquoi |
|---|---|---|
script-src | https://menu.tiers-lieux.fr | le script du menu |
connect-src | https://api.tiers-lieux.fr | la lecture des entrées |
frame-src | https://menu.tiers-lieux.fr | la mémoire du réseau |
style-src | 'unsafe-inline' | les styles du menu |
Sans frame-src, le menu marche mais ne garde pas le réseau d'un site à l'autre.
Sécurité
- Tout ce qui vient de Grist, de l'adresse ou de la mémoire partagée s'affiche comme du texte : un lien piégé ne peut rien injecter dans votre page.
- Seules les adresses http et https deviennent des liens ; un réseau n'est retenu que s'il fait partie des réseaux du menu.
- La mémoire partagée (
storage.html) ne garde qu'une information : le nom du réseau choisi. Aucune donnée personnelle ne passe par le menu.