Navigation de l'app
Palette de commandes
Command palette
Démo
Chargement de la démo…
Un champ de recherche qui s'ouvre par un raccourci, souvent Cmd+K, et liste toutes les actions de l'app. On tape quelques lettres, on choisit au clavier, l'action part. Elle évite de fouiller dans des menus profonds.
Histoire
Le saviez-vous
Les devs modernes l'ont redécouverte avec Sublime Text, mais l'idée a un ancêtre de près de cinquante ans : le M-x d'Emacs, qui permet déjà de taper le nom de n'importe quelle commande.
Historique
- 1970sEmacs :
M-xpour lancer une commande par son nom. - 2005Spotlight sur Mac OS X, aux côtés de lanceurs comme Quicksilver puis Alfred.
- 2011Sublime Text 2 popularise la « Command Palette ».
- 2019+Cmd+K devient un standard des SaaS (Linear, Notion, Vercel).
Vocabulaire
Noms
- FR
- Palette de commandes, barre de commandes, lanceur
- EN
- Command palette, Cmd+K menu, command bar, command menu, quick switcher, omnibox
Usages courants
- Accéder à n'importe quelle action au clavier
- Rechercher fichiers, pages ou personnes
- Remplacer des menus profonds dans les outils pro
Souvent associé à
Les composants qu'on retrouve avec lui, par type de page, dans l'ordre de lecture.
Code
<dialog id="palette" aria-label="Command palette">
<input id="q" role="combobox" aria-expanded="true" aria-controls="list"
aria-autocomplete="list" placeholder="Type a command…">
<ul id="list" role="listbox"></ul>
</dialog>
<script>
const commands = ['New project', 'Invite a member', 'Dark mode', 'Open settings']
let hits = commands, active = 0
function render() {
hits = commands.filter(c => c.toLowerCase().includes(q.value.toLowerCase()))
list.replaceChildren(...hits.map((c, i) => {
const li = Object.assign(document.createElement('li'), { id: 'opt-' + i, textContent: c })
li.setAttribute('role', 'option')
li.setAttribute('aria-selected', i === active)
li.onclick = () => choose(c)
return li
}))
if (hits.length) q.setAttribute('aria-activedescendant', 'opt-' + active)
else q.removeAttribute('aria-activedescendant')
}
function choose(cmd) { console.log('Run:', cmd); palette.close() }
addEventListener('keydown', e => {
if ((e.metaKey || e.ctrlKey) && e.key === 'k') {
e.preventDefault(); q.value = ''; active = 0; render(); palette.showModal()
}
})
q.oninput = () => { active = 0; render() }
q.onkeydown = e => {
if (e.key === 'ArrowDown') active = Math.min(active + 1, hits.length - 1)
else if (e.key === 'ArrowUp') active = Math.max(active - 1, 0)
else if (e.key === 'Enter' && hits[active]) return choose(hits[active])
else return
e.preventDefault(); render()
}
</script>À savoir
<dialog>+showModal()te donnent gratuitement le fond inerte, Échap et le focus sur le premier champ à l'ouverture.- Ctrl+K est déjà pris par Chrome et Firefox (recherche web) :
preventDefault()est obligatoire. Affiche ⌘K sur Mac et Ctrl K ailleurs. - Quand la liste défile, appelle
scrollIntoView({ block: 'nearest' })sur l'option active, sinon la sélection sort de l'écran. includes()suffit pour vingt commandes. Au-delà, passe à une recherche floue qui tolère les fautes. Côté React, la libcmdkest devenue la référence.
Accessibilité
Prioritaire
- Le champ porte
role="combobox",aria-expandedetaria-controlsvers la liste. La liste arole="listbox", chaque lignerole="option"avecaria-selected. - Le focus reste dans le champ. La sélection se déplace avec
aria-activedescendant: flèches haut/bas pour bouger, Entrée pour lancer, Échap pour fermer. - Donne un nom à la fenêtre (
aria-label) et au champ : un placeholder seul ne suffit pas.
Souvent oublié
- Annoncer le nombre de résultats dans une région
aria-live="polite": un lecteur d'écran ne dit rien quand la liste se filtre. - Retirer
aria-activedescendantquand il n'y a plus de résultat. Un id qui pointe vers une option disparue casse la lecture. - Rendre le focus à l'élément d'avant à la fermeture.
<dialog>le fait seul, une palette maison doit le coder.
Bonus
- Afficher à droite de chaque commande son raccourci direct : la palette apprend le clavier aux gens.
- Regrouper les options avec
role="group"et unaria-label(Navigation, Actions…). - Gérer Début et Fin pour sauter à la première ou à la dernière option.