Commit 9b6f9fd1 by PLN (Algolia)

site-wide: chip « ? » à côté du theme pill — registre mécanique de raccourcis…

site-wide: chip « ? » à côté du theme pill — registre mécanique de raccourcis (registerShortcuts par feature), tout raccourci actif apparaît dans le menu, le chip ne peint que s'il en existe ; les fiches les-femmes y déclarent flèches/Échap/Entrée
parent e32b779e
......@@ -4,6 +4,7 @@ import '@/styles/globals.css';
import '@/styles/main.css';
import '@/styles/masonry.css';
import ThemeSwitcher from '@/components/ThemeSwitcher';
import KeyboardShortcuts from '@/components/KeyboardShortcuts';
import { SITE_URL } from '@/lib/site';
export const metadata = {
......@@ -48,6 +49,7 @@ export default function RootLayout({ children }: { children: React.ReactNode })
<body>
{children}
<ThemeSwitcher />
<KeyboardShortcuts />
</body>
</html>
);
......
......@@ -2,6 +2,7 @@
import { useEffect, useState } from "react";
import { useTransitionNav } from "./useTransitionNav";
import { registerShortcuts } from "@/components/KeyboardShortcuts";
import style from "./style.module.css";
/**
......@@ -15,6 +16,16 @@ export default function FemmeKeys({ prev, next, imgSrc, imgAlt }) {
const [zoom, setZoom] = useState(false);
useEffect(() => {
// Le chip « ? » site-wide liste mécaniquement tout raccourci enregistré.
const shortcuts = [
{ keys: "← →", desc: "femme précédente / suivante" },
{ keys: "Échap Home", desc: "retour au landing" },
...(imgSrc ? [{ keys: "Entrée", desc: "zoom portrait" }] : []),
];
return registerShortcuts("les-femmes", shortcuts);
}, [imgSrc]);
useEffect(() => {
const onKey = (e) => {
const t = e.target;
if (t instanceof HTMLElement && /^(INPUT|TEXTAREA|SELECT)$/.test(t.tagName)) return;
......
'use client';
import { useEffect, useState } from 'react';
import styles from './KeyboardShortcuts.module.css';
/**
* Site-wide keyboard shortcut help — the "?" chip next to the theme pill.
*
* The guarantee is mechanical: any feature that registers a shortcut in the
* registry (registerShortcuts) SHOWS UP in this menu, and a feature that
* unregisters on unmount disappears from it. A shortcut that is active but
* absent from the menu is a bug in the feature, not in the menu. The chip
* itself only paints once at least one shortcut is registered.
*
* Registry lives on window so client islands (fiche pages, future apps)
* register without any shared context wiring.
*/
const REGISTRY_KEY = '__plnShortcuts';
function registry() {
if (typeof window === 'undefined') return new Map();
if (!window[REGISTRY_KEY]) window[REGISTRY_KEY] = new Map();
return window[REGISTRY_KEY];
}
/** Feature-side API: registerShortcuts('les-femmes', [{keys: '← →', desc: '...'}, ...]).
* Returns the unregister function. Same id replaces (idempotent mounts). */
export function registerShortcuts(id, shortcuts) {
const reg = registry();
reg.set(id, shortcuts);
window.dispatchEvent(new Event('pln:shortcuts-changed'));
return () => {
reg.delete(id);
window.dispatchEvent(new Event('pln:shortcuts-changed'));
};
}
export default function KeyboardShortcuts() {
const [entries, setEntries] = useState([]);
const [open, setOpen] = useState(false);
useEffect(() => {
const sync = () => setEntries([...registry().values()].flat());
sync();
window.addEventListener('pln:shortcuts-changed', sync);
return () => window.removeEventListener('pln:shortcuts-changed', sync);
}, []);
if (entries.length === 0) return null;
return (
<div className={styles.wrap}>
{open && (
<div className={styles.menu} role="dialog" aria-label="Raccourcis clavier">
<p className={styles.title}>Raccourcis clavier</p>
<ul className={styles.list}>
{entries.map((s, i) => (
<li key={i}>
<kbd>{s.keys}</kbd>
<span>{s.desc}</span>
</li>
))}
</ul>
</div>
)}
<button
type="button"
className={styles.chip}
onClick={() => setOpen((o) => !o)}
aria-expanded={open}
aria-label="Raccourcis clavier"
>
?
</button>
</div>
);
}
/* Chip « ? » + menu des raccourcis — même register que le theme pill. */
.wrap {
position: fixed;
bottom: calc(1rem + 3.1rem);
right: 1rem;
z-index: 60;
display: flex;
flex-direction: column;
align-items: flex-end;
gap: 0.4rem;
}
@media (max-width: 768px) {
.wrap {
bottom: calc(0.5rem + env(safe-area-inset-bottom, 0px) + 2.7rem);
right: 0.5rem;
}
}
.chip {
width: 2.1rem;
height: 2.1rem;
border-radius: 999px;
border: 1px solid var(--border);
background: var(--surface);
color: var(--text-muted);
font-size: 0.95rem;
font-weight: 700;
cursor: pointer;
box-shadow: 0 4px 14px rgba(0, 0, 0, 0.12);
transition: color 120ms ease, border-color 120ms ease;
}
.chip:hover {
color: var(--text-primary);
border-color: var(--text-muted);
}
.menu {
background: var(--surface);
border: 1px solid var(--border);
border-radius: 12px;
padding: 0.8rem 1rem;
box-shadow: 0 16px 40px rgba(0, 0, 0, 0.18);
min-width: 16rem;
max-width: 18rem;
}
.title {
font-size: 0.68rem;
text-transform: uppercase;
letter-spacing: 0.08em;
color: var(--text-muted);
margin: 0 0 0.5rem;
}
.list {
list-style: none;
margin: 0;
padding: 0;
display: flex;
flex-direction: column;
gap: 0.4rem;
}
.list li {
display: flex;
align-items: baseline;
gap: 0.6rem;
font-size: 0.82rem;
color: var(--text-primary);
}
.list kbd {
flex: 0 0 auto;
font-family: ui-monospace, monospace;
font-size: 0.72rem;
border: 1px solid var(--border);
border-radius: 5px;
padding: 0.1rem 0.4rem;
background: var(--surface-raised);
color: var(--text-primary);
}
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment