Aller au contenu

Raccourcis clavier

Les raccourcis proviennent d’un unique registre const, KeybindingRegistry, dans lib/core/constants/keybindings.dart. Il contient 49 raccourcis. Paramètres → Vous → Raccourcis clavier affiche ce registre sous forme de référence en lecture seule : il n’existe aucune interface de réaffectation ni aucun fichier de raccourcis utilisateur.

Dans la suite de cette page, Cmd désigne le modificateur de commande principal — ⌘ sous macOS, Ctrl sous Windows et Linux. Un raccourci ne se déclenche que si sa commande dispose d’un gestionnaire enregistré sur l’écran courant et si sa clause when est vraie ; !textInputFocus signifie que la touche est transmise à un champ de texte qui a le focus.

Il n’existe aucun raccourci de navigation par les touches numériques. La boîte de réception, les tickets, les demandes de tirage et le reste s’atteignent depuis la barre latérale ou avec ⌘K. L’observabilité n’a pas de raccourci non plus.

Portée global : ils sont donc actifs partout dans le shell.

Raccourci Action Condition
Cmd/Ctrl + K Palette de commandes —
Shift + / (?) Aide-mémoire des raccourcis clavier Ne pas saisir dans un champ
Cmd/Ctrl + Z Annuler Ne pas saisir dans un champ (un champ qui a le focus conserve sa propre annulation)
Cmd/Ctrl + Shift + Z Rétablir Ne pas saisir dans un champ
Cmd/Ctrl + Shift + T Basculer le thème —
Cmd/Ctrl + , Ouvrir les paramètres (arrive sur /settings/you/appearance) —
Cmd/Ctrl + Shift + Alt + F Basculer le mode focus —
Cmd/Ctrl + Shift + W Basculer le sélecteur d’espace —
Cmd/Ctrl + ] Espace de travail suivant —
Cmd/Ctrl + [ Espace de travail précédent —
Cmd/Ctrl + Alt + 1 … Cmd/Ctrl + Alt + 9 Passer à l’espace de travail 1–9 —

Portée /pull-requests. Tous exigent route == '/pull-requests' et qu’aucun champ de texte n’ait le focus ; ils ne se déclenchent donc pas lorsque la route de détail d’une PR est ouverte par-dessus la liste.

Raccourci Action
R Actualiser
Enter Ouvrir la PR
F Ouvrir le menu de filtres

Enter (pr.list-open) est déclaré dans le registre et figure dans la référence des raccourcis, mais l’écran de liste n’enregistre aucun gestionnaire pour cette touche, il ne se déclenche donc pas actuellement. F ouvre le menu de filtres (pr.list-open-filter), et non la recherche.

Portée /pull-requests/. L’actualisation exige qu’aucun champ de texte n’ait le focus. La fermeture d’onglet n’a pas de garde de saisie de texte (une combinaison modifiée par ⌘ n’est jamais du texte brut) et dispose d’une expression régulière de route, si bien qu’elle ne se déclenche pas sur la liste.

Raccourci Action Condition
R Actualiser Ne pas saisir dans un champ
Cmd/Ctrl + W Fermer l’onglet Sur un emplacement /pull-requests/<…>

Le changement d’onglet (1/2/3), le marquage « vu » et le repli d’un fichier (V/C), la liste des fichiers (T) et la recherche dans le diff (Cmd/Ctrl + F) sont gérés par le gestionnaire propre à la visionneuse de diff — voir Touches de la visionneuse de diff hors du registre.

Raccourci Action
F Ouvrir le menu de filtres

Exige route == '/inbox' et qu’aucun champ de texte n’ait le focus.

Portée /users/. La clause when est une expression régulière appliquée à /users/<login> ou /teams/<organization>/<slug>, et exige en plus qu’aucun champ de texte n’ait le focus.

Raccourci Action
R Actualiser
/ Aller à la recherche
Cmd/Ctrl + F Aller à la recherche

Portée /spaces. Les clauses when utilisent une expression régulière, si bien qu’ils se déclenchent à la fois sur la liste des espaces (/spaces) et sur un espace sélectionné (/spaces/<id>).

Raccourci Action Condition
Enter Envoyer le message —
Cmd/Ctrl + N Nouveau espace Sur une route /spaces
J Espace suivant Ne pas saisir dans un champ
K Espace précédent Ne pas saisir dans un champ
Cmd/Ctrl + Shift + D Dictée par appui pour parler —
Cmd/Ctrl + T Ouvrir un onglet d’éditeur Sur une route /spaces
Cmd/Ctrl + W Fermer l’onglet d’éditeur Sur une route /spaces
Cmd/Ctrl + B Basculer la barre latérale de l’éditeur Sur une route /spaces
Cmd/Ctrl + P Aller au fichier Sur une route /spaces

« Aller au fichier » ouvre un sélecteur sur les fichiers de la conversation. Sans saisie, il liste les fichiers que vous avez ouverts le plus récemment ; la saisie lance une recherche dans tous les fichiers des arbres de travail de la conversation. Enter ouvre le fichier sélectionné dans un nouvel onglet, Cmd/Ctrl + Enter ou le bouton de division de la ligne l’ouvre dans un volet à droite, et le × d’une ligne récente le retire de la liste.

L’envoi par Entrée est géré par le champ de texte du compositeur de messages ; l’appui pour parler est géré par le bouton micro du compositeur (son propre gestionnaire de clavier physique). Les deux figurent dans le registre pour la référence des paramètres.

Portée /workspaces, actifs uniquement sur le sélecteur lui-même.

Raccourci Action
Cmd/Ctrl + N Nouvel espace de travail
Enter Ouvrir l’espace de travail

Enter exige qu’aucun champ de texte n’ait le focus.

Raccourci Action Écran
J Page de paramètres suivante Toute route /settings, hors saisie
K Page de paramètres précédente Toute route /settings, hors saisie
Cmd/Ctrl + N Nouvel agent Paramètres → Espace de travail → Agents
Cmd/Ctrl + N Ajouter un dépôt Paramètres → Espace de travail → Dépôts
R Rescanner les adaptateurs Paramètres → Serveur → Fournisseurs de modèles

Portée /newsfeed. Tous exigent route == '/newsfeed' et qu’aucun champ de texte n’ait le focus.

Raccourci Action
J Article suivant
K Article précédent
Enter Ouvrir l’article
S Basculer le signet
R Actualiser les flux

Touches de la visionneuse de diff hors du registre

Section intitulée « Touches de la visionneuse de diff hors du registre »

La visionneuse de diff des PR gère ces touches elle-même (PrDiffKeyboardHandler). La recherche, l’état « vu » et le repli figurent dans les commentaires du registre uniquement pour la référence des paramètres — aucun gestionnaire de répartiteur n’est enregistré, le répartiteur les laisse donc à la vue de diff. Ils n’apparaissent pas comme des lignes distinctes dans la référence des raccourcis clavier.

Raccourci Action
Cmd/Ctrl + F Rechercher dans le diff
J / K Fichier suivant / précédent
V Basculer l’état « vu » du fichier actif
C Basculer le repli du fichier actif
T Afficher la liste des fichiers
Enter Correspondance suivante (uniquement lorsque la recherche dans le diff est ouverte)
Shift + Enter Correspondance précédente
Escape Fermer la recherche dans le diff ou effacer la sélection de texte du diff
Cmd/Ctrl + C Copier la sélection du diff

Dans la version web, le navigateur intercepte certains raccourcis avant que la page ne les voie ; les raccourcis correspondants ne peuvent donc jamais se déclencher dans ce contexte. Ils fonctionnent normalement sur ordinateur. Sont réservés lorsqu’ils sont combinés au modificateur de commande principal : T, W, N et les chiffres 1–9.

Cela concerne le changement d’espace de travail avec Cmd/Ctrl + Alt + 1–9, Cmd/Ctrl + N (nouvel espace, nouvel espace de travail, nouvel agent, ajouter un dépôt) et Cmd/Ctrl + T / Cmd/Ctrl + W dans les espaces et le détail d’une PR.