Aller au contenu

Header et menu utilisateur

Référence du header partagé de Kirexo et de son menu utilisateur déroulant. Le header est un composant d'interface transverse aux trois espaces (public, utilisateur, admin) : cette page décrit le markup qu'il produit, les entrées du menu selon le contexte, et le contrat d'accessibilité du panneau déroulant.

Cette page décrit ce que le header rend et comment il se comporte. Pour le pourquoi (un seul header pour trois contextes, la visibilité de la bascule comme commodité d'affichage), voir l'explication Entête partagé : identité, déconnexion et bascule. Pour les règles générales de couleurs, de thème et d'accessibilité auxquelles ce composant se conforme, voir Design system : tokens, thèmes et accent.

Le composant <twig:Header>

Le header est rendu par un composant Twig unique — src/Twig/Components/Header.php et son gabarit templates/components/Header.html.twig — instancié dans chaque layout via une seule balise :

<twig:Header space="public" />
<twig:Header space="user" />
<twig:Header space="admin" />

C'est un composant Twig simple (pas un Live Component) : le panneau du menu s'ouvre et se ferme entièrement côté client (assets/js/user-menu.js), sans aller-retour serveur.

Les trois espaces rendent le même header — il n'existe aucune barre du haut propre à un espace. En particulier, l'accueil de l'espace utilisateur (/u, templates/user/home.html.twig) rend <twig:Header space="user" /> ; les éléments propres à cette page (barre de recherche, onglets Carnets) restent dans le corps de la page, hors du header. Les sélecteurs de l'ancienne topbar /u (.ud-topbar, .ud-brand, .ud-theme-seg, .ud-user) n'ont plus de consommateur.

La prop space

Le composant reçoit une unique propriété space ('public', 'user' ou 'admin'), fournie par le layout. Elle pilote l'affichage : brand, présence de l'action principale, route de bascule et de déconnexion, présence des liens de gestion admin (Utilisateurs, Invitations, Plugins, Réglages). Elle n'est jamais une donnée de sécurité — le cloisonnement des espaces reste porté par les firewalls (voir Architecture des firewalls).

Méthodes exposées

Le composant Header (src/Twig/Components/Header.php) expose les méthodes suivantes au gabarit.

Méthode Type retour Rôle
getUser() ?User Le compte connecté (instanceof User), ou null.
isMixed() bool Vrai si le compte porte à la fois ROLE_USER et ROLE_ADMIN.
getSwitchTarget() 'admin'\|'user'\|null Espace de destination de la bascule selon space, ou null si non éligible (compte non mixte, ou espace public).
getDisplayName() ?string Prénom du compte connecté (User::getFirstName()), ou null si personne n'est connecté — le bouton du menu n'est alors pas rendu.
getSwitchLabel() 'Espace admin'\|'Espace user'\|null Libellé UI de la cible de bascule, dérivé de getSwitchTarget().

Le nom affiché sur le bouton du menu est toujours le prénom, jamais l'email (règle §3 du design system). getFirstName() renvoie un string non nullable : dès qu'un compte est connecté, un prénom est affiché.

Structure du header rendu

Le header rend, de gauche à droite :

  • la brand « Kirexo » (logomark + mot), pointant vers l'accueil de l'espace courant (app_user_home pour user, app_admin_dashboard pour admin, sinon app_home) ; suffixée d'une pastille .tag « Admin » quand space == 'admin' ;
  • la zone .header__actions, dont le contenu dépend de l'état de connexion (détaillé ci-dessous).

Compte connecté

Deux blocs sont rendus dans .header__actions :

Action principale visible (hors menu) — « Mon espace ». Un lien .header__primary vers app_user_home, rendu uniquement sur l'accueil public (space == 'public'). Il n'apparaît ni dans l'espace utilisateur (on y est déjà sur la home utilisateur), ni dans l'espace admin : là, l'accès à l'espace utilisateur passe par l'entrée « Espace user » de la bascule d'espace du menu, qui joue déjà ce rôle — pas de doublon (design system §2).

Menu utilisateur (disclosure). Un conteneur .user-menu[data-user-menu] avec :

  • un bouton déclencheur .user-menu__trigger[data-user-menu-trigger] portant le prénom (.user-menu__name) et un chevron ;
  • un panneau #user-menu-panel.user-menu__panel[data-user-menu-panel]. Le HTML rendu par le serveur ne porte pas l'attribut hidden : c'est assets/js/user-menu.js qui ferme le panneau au câblage (voir Repli sans JavaScript).

Le panneau regroupe les actions secondaires, dans cet ordre :

Ordre Entrée Condition d'affichage Cible
1 Sélecteur de thème (.theme-toggle, 3 boutons clair / sombre / système) toujours recâblé par assets/js/theme.js
2 Plugins space == 'user' uniquement app_user_plugins
2 bis Entrées contribuées par les plugins (<twig:UserMenuPluginLinks />) space == 'user' ; une entrée par plugin déclarant UserMenuContributorInterface et actif pour l'utilisateur courant route du plugin (ex. « Mes thèmes » → web_plugin_theme_index)
3 Bascule d'espace (« Espace admin » / « Espace user ») getSwitchTarget() non nul — comptes mixtes uniquement, hors accueil POST app_switch_to_admin / app_switch_to_user (jeton CSRF switch_space)
4 Utilisateurs space == 'admin' uniquement app_admin_users
5 Invitations space == 'admin' uniquement app_admin_invitations
6 Plugins space == 'admin' uniquement app_admin_plugins
7 Réglages space == 'admin' uniquement app_admin_settings
— séparateur .user-menu__sep toujours —
8 Se déconnecter (.user-menu__action--danger) toujours, en dernier POST app_admin_logout si space == 'admin', sinon app_logout

Le sélecteur de thème est secondaire une fois connecté : il vit dans le panneau, pas exposé à plat (règle §4 du design system). La bascule d'espace n'apparaît que pour les comptes mixtes ; sa visibilité est une commodité d'affichage, l'autorisation réelle étant portée par CanSwitchSpaceVoter — voir Mécanisme de bascule entre espaces.

Aucune route de plugin codée en dur dans le header

Le menu ne contient pas d'entrée pointant vers la configuration d'un plugin par carnet (il n'y a, par exemple, pas de lien « Mon site » pour le plugin web). Cette configuration est portée par le carnet : elle s'ouvre depuis le menu ⋯ de la carte du carnet, dans « Mon espace », via le composant App\Twig\Components\NotebookConfigLinks.

Les entrées de portée compte qu'un plugin veut exposer (ex. « Mes thèmes » du plugin web) passent, elles, par le point d'extension <twig:UserMenuPluginLinks /> : le header ne cite aucune route de plugin en dur, c'est chaque plugin qui contribue son entrée via la capability Kirexo\Plugin\Contracts\UserMenuContributorInterface, rendue uniquement s'il est actif pour l'utilisateur courant. Détail du contrat : Référence : contrat de plugin — UserMenuContributorInterface. L'entrée Plugins — l'activation des canaux, qui est un réglage de compte — reste codée par le cœur car elle ne dépend d'aucun plugin. Voir aussi Configuration par carnet et extensibilité des plugins.

Utilisateur anonyme (accueil public)

Quand personne n'est connecté et que space == 'public' (hors page de login), il n'y a pas de menu. À la place :

  • le sélecteur de thème reste visible à plat dans le header (pas de menu compte où le loger — règle §4 du design system) ;
  • un lien « Se connecter » (.header__login) vers app_login. Aucun lien vers le login admin n'est jamais exposé depuis l'accueil.

Contrat d'accessibilité — pattern disclosure

Le menu applique le pattern disclosure de la WAI-ARIA APG, pas un menu (role="menu") : son contenu est une liste de liens et de formulaires POST standards, parcourus à la tabulation naturelle. Ce choix est une règle du projet (§1 du design system) ; il évite d'annoncer un menu applicatif qui attendrait une navigation aux flèches non fournie.

Attributs ARIA

Élément État fermé État ouvert
.user-menu__trigger[data-user-menu-trigger] aria-expanded="false" aria-expanded="true"
#user-menu-panel[data-user-menu-panel] attribut hidden présent hidden retiré

Le trigger porte en permanence aria-controls="user-menu-panel" et aria-haspopup="true". Il n'y a aucun role="menu" ni role="menuitem" dans le panneau.

L'attribut hidden de l'état fermé n'est jamais écrit dans le gabarit : il est posé par le script. Sans JavaScript, le panneau n'a donc pas d'état fermé.

Comportement clavier et souris

Géré par assets/js/user-menu.js :

  • Câblage — au chargement du DOM, wire() appelle close() sur chaque [data-user-menu] (pose hidden, aria-expanded="false"), puis marque l'hôte data-wired="1". Le câblage est idempotent.
  • Ouverture — clic, Entrée ou Espace sur le trigger (comportement natif du <button>) : retire hidden, passe aria-expanded à true.
  • Échap — ferme le panneau et rend le focus au trigger.
  • Clic extérieur — un clic hors d'un [data-user-menu] ouvert ferme le panneau (sans voler le focus).
  • Sortie au Tab (focusout dont la cible de destination est hors de l'hôte) — ferme le panneau.
  • Les soumissions des formulaires POST (bascule, déconnexion) ne sont pas interceptées : le submit natif passe.

Repli sans JavaScript

Le menu suit le schéma d'amélioration progressive no-js → js : le script inline de templates/base.html.twig ajoute la classe js sur <html> avant le premier paint. Quatre règles de assets/styles/screens.css (bloc Ticket 245 — finition comptes) en dérivent :

Sélecteur Déclaration Effet
html:not(.js) .user-menu__trigger display: none Sans JavaScript, le déclencheur, inerte, disparaît.
html:not(.js) .user-menu__panel position: static; box-shadow: none; min-width: 0 Sans JavaScript, le panneau s'affiche dans le flux de l'en-tête : toutes ses entrées (dont Utilisateurs, Invitations, Plugins, Réglages en espace admin) restent atteignables.
.js [data-user-menu]:not([data-wired]) .user-menu__panel display: none Avec JavaScript, le panneau reste masqué entre le premier paint et le câblage : pas de flash.
.js .user-menu__panel[hidden] display: none [hidden] l'emporte sur le display: flex de .user-menu__panel.
Situation Déclencheur Panneau
JavaScript actif, script câblé Visible Fermé par défaut, ouvert par le déclencheur
JavaScript désactivé Masqué Affiché dans le flux, entrées cliquables ; liens et formulaires POST (bascule, déconnexion) fonctionnent

Limites connues

  • JavaScript actif mais user-menu.js non chargé (erreur d'import, par exemple) : la classe js est posée, mais l'hôte n'est jamais marqué data-wired. La règle anti-flash .js [data-user-menu]:not([data-wired]) .user-menu__panel masque alors le panneau, sans moyen de l'ouvrir.
  • Sans JavaScript, le sélecteur de thème est visible dans le panneau mais inopérant : ses boutons sont câblés par assets/js/theme.js. Limite préexistante.

Voir aussi