FRENEnglish version

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

  1. 1970sEmacs : M-x pour lancer une commande par son nom.
  2. 2005Spotlight sur Mac OS X, aux côtés de lanceurs comme Quicksilver puis Alfred.
  3. 2011Sublime Text 2 popularise la « Command Palette ».
  4. 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 lib cmdk est devenue la référence.

Accessibilité

Prioritaire

  • Le champ porte role="combobox", aria-expanded et aria-controls vers la liste. La liste a role="listbox", chaque ligne role="option" avec aria-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-activedescendant quand 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 un aria-label (Navigation, Actions…).
  • Gérer Début et Fin pour sauter à la première ou à la dernière option.

Qui l'utilise