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 :
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_homepouruser,app_admin_dashboardpouradmin, sinonapp_home) ; suffixée d'une pastille.tag« Admin » quandspace == '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'attributhidden: c'estassets/js/user-menu.jsqui 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) versapp_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()appelleclose()sur chaque[data-user-menu](posehidden,aria-expanded="false"), puis marque l'hôtedata-wired="1". Le câblage est idempotent. - Ouverture — clic, Entrée ou Espace sur le trigger (comportement natif du
<button>) : retirehidden, passearia-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 (
focusoutdont 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.jsnon chargé (erreur d'import, par exemple) : la classejsest 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__panelmasque 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¶
- Entête partagé : identité, déconnexion et bascule — pourquoi un seul header pour trois contextes, et pourquoi la visibilité de la bascule n'est qu'une commodité d'affichage.
- Mécanisme de bascule entre espaces — le jeton signé à usage unique derrière l'entrée « Espace admin » / « Espace user » du menu.
- Design system : tokens, thèmes et accent — les variables CSS, le thème
[data-theme]et les contraintes RGAA respectées par le header. - Choisir le thème (clair, sombre ou système) — le sélecteur de thème logé dans le menu.
- Basculer entre l'espace administrateur et l'espace utilisateur — le parcours pas-à-pas de la bascule.
- Gérer les comptes utilisateurs — ce que permettent les entrées « Utilisateurs » et « Invitations » du menu admin.