Actions personnalisées et liaisons de clés dans Terminal Windows

Article
10/29/2024

Vous pouvez créer des actions personnalisées dans le Terminal Windows qui vous permettent de contrôler la façon dont vous interagissez avec le Terminal. Ces actions sont automatiquement ajoutées à la palette de commandes.

Formats d’action

Les actions peuvent être structurées aux formats suivants :

Commandes sans arguments

{ "command": "commandName", "id": "User.MyCommand" }

Par exemple, ce paramètre par défaut utilise le raccourci ALT + F4 pour fermer la fenêtre de terminal :

{ "command": "closeWindow", "id": "User.MyCloseWindow" }

Commandes avec arguments

{ "command": { "action": "commandName", "argument": "value" }, "id": "User.MyCommand" }

Par exemple, ce paramètre par défaut utilise le raccourci Ctrl + Maj + 1 pour ouvrir un nouvel onglet dans le terminal en fonction du profil qui figure en premier dans le menu déroulant (en général, le profil PowerShell s’ouvre) :

{ "command": { "action": "newTab", "index": 0 }, "id": "User.MyNewTabAction" }

Commandes avec arguments de ligne de commande

{ "command": { "action": "wt", "commandline": "value" }, "keys": "modifiers+key" }

Par exemple, ce paramètre par défaut utilise la touche de raccourci Ctrl+Maj+O pour utiliser wt pour ouvrir un nouvel onglet PowerShell avec des volets supplémentaires pour l’invite de commandes et Ubuntu :

{
  "command": 
  {
    "action": "wt",
    "commandline": "new-tab pwsh.exe ; split-pane -p \"Command Prompt\" -d C:\\ ; split-pane -p \"Ubuntu\" -H"
  },
  "keys": "ctrl+shift+o"
}

Propriétés des actions

Les actions sont stockées dans le actions tableau et peuvent être construites à l’aide des propriétés suivantes.

Commande

Il s’agit de la commande exécutée lorsque les touches associées sont activées.

Nom de la propriété : command

Nécessité : Obligatoire

Accepte : String

Action

Ajoute des fonctionnalités supplémentaires à certaines commandes.

Nom de la propriété : action

Nécessité : Facultatif

Accepte : String

Nom

Définit le nom qui s’affiche dans la palette de commandes. Si rien n’est indiqué, le terminal tente de générer automatiquement un nom.

Nom de la propriété : name

Nécessité : Facultatif

Accepte : String

Icône

Définit l’icône qui s’affiche dans la palette de commandes.

Nom de la propriété : icon

Nécessité : Facultatif

Accepte : Emplacement du fichier en tant que chaîne ou emoji

id

Cette action définit l’ID de cette action. Si l’un n’est pas fourni, le terminal génère un ID pour cette action. L’ID est utilisé pour faire référence à cette action lors de la création de liaisons de clés.

Nom de la propriété : id

Nécessité : Facultatif

Accepte : chaîne

Keybindings

Les actions peuvent être affectées à des liaisons de clés en les faisant référence à leur ID unique. Par exemple, voici un tableau possible keybindings qui affecte Alt+F4, Ctrl+Maj+1 et Ctrl+Maj+o aux actions définies ci-dessus. Plusieurs entrées de liaison de clé peuvent être créées pour la même action.

"keybindings": [
  { "keys": "alt+f4", "id": "User.MyCloseWindow" },
  { "keys": "ctrl+shift+1", "id": "User.MyNewTabAction" },
  { "keys": "ctrl+shift+o", "id": "User.MyCoolSetup"}
]

Propriétés keybinding

Les keybindings sont stockés dans le keybindings tableau et sont construits à l’aide des propriétés suivantes.

Touches

Définit les combinaisons de touches utilisées pour appeler la commande. Les touches peuvent avoir un nombre quelconque de modificateurs avec une touche. Les modificateurs et les touches acceptés sont répertoriés ci-dessous.

Si l’action n’a pas de clés, elle s’affiche dans la palette de commandes, mais ne peut pas être appelée avec le clavier.

Nom de la propriété : keys

Nécessité : Obligatoire

Accepte : Chaîne ou tableau[chaîne]

id

Il s’agit de l’ID de l’action à appeler lorsque cette liaison de touches est enfoncée.

Nom de la propriété : id

Nécessité : Obligatoire

Accepte : String

Modificateurs acceptés

ctrl+, , shift+alt+, ,win+

Remarque

Bien que la touche Windows soit prise en charge en tant que modificateur, le système réserve la plupart des combinaisons de touches de la touche< Win+>. Si le système d’exploitation a réservé cette combinaison de touches, le terminal ne recevra jamais cette combinaison.

Touches de modification

Type	Touches
Fonction et touches alphanumériques	`f1-f24`, , `a-z0-9`
symboles	`, , `plus`, `=`, , `],.\';[-/`
Touches de direction	`down`, , `left`, `upright`, , `pageupendpgdnpguppagedownhome`
Touches d’action	`tab`, , `enter`, `escapeesc`, , `backspaceappdeleteinsertspacemenu`
Touches du pavé numérique	`numpad_0-numpad_9`, , `numpad0-numpad9`, `numpad_plusnumpad_add`, , `numpad_periodnumpad_subtractnumpad_dividenumpad_minusnumpad_decimalnumpad_multiply`
Touches du navigateur	`browser_back`, `browser_forward`, , `browser_stopbrowser_refresh`, `browser_search`, , `browser_favorites`,`browser_home`

Remarque : = et plus sont équivalents. Attention à ne pas confondre cette dernière touche avec numpad_plus.

Commandes au niveau de l’application

Quitter

Ferme toutes les fenêtres du terminal ouvertes. Une boîte de dialogue de confirmation s’affiche dans la fenêtre active pour vérifier que vous souhaitez fermer toutes les fenêtres.

Nom de commande : quit

ID par défaut :

{ "command": "quit", "id": "Terminal.Quit" }

Fermer la fenêtre

Ferme la fenêtre active et tous ses onglets. Si confirmCloseAllTabs est défini sur true, une boîte de dialogue de confirmation s’affiche pour vérifiez que vous souhaitez fermer tous les onglets. Pour plus d’informations sur ce paramètre, consultez la page Apparence.

Nom de commande : closeWindow

ID par défaut :

{ "command": "closeWindow", "id": "Terminal.CloseWindow" }

Liaison par défaut :

{ "keys": "alt+f4", "id": "Terminal.CloseWindow" }

Rechercher

La boîte de dialogue Rechercher s’ouvre. Pour plus d’informations sur la recherche, consultez la page Rechercher.

Nom de commande : find

ID par défaut :

{ "command": "find", "id": "Terminal.FindText" }

Liaison par défaut :

{ "keys": "ctrl+shift+f", "id": "Terminal.FindText" }

Rechercher le résultat de recherche suivant/précédent

Permet de parcourir les résultats de votre recherche.

Nom de commande : findMatch

ID par défaut :

{ "command": { "action": "findMatch", "direction": "next" }, "id": "Terminal.FindNextMatch" },
{ "command": { "action": "findMatch", "direction": "prev" }, "id": "Terminal.FindPrevMatch" }

Paramètres

Nom	Nécessité	Accepte	Description
`direction`	Obligatoire	`"next"`, `"prev"`	Sens de navigation dans les résultats de la recherche.

Le menu déroulant s’ouvre.

Nom de commande : openNewTabDropdown

ID par défaut :

{ "command": "openNewTabDropdown", "id": "Terminal.OpenNewTabDropdown" }

Liaison par défaut :

{ "keys": "ctrl+shift+space", "id": "Terminal.OpenNewTabDropdown" }

Ouvrir les fichiers de paramètres

Ouvre l’interface utilisateur des paramètres, le fichier de paramètres personnalisés (settings.json) ou le fichier de paramètres par défaut (defaults.json) en fonction du champ target. Sans le champ target, le fichier de paramètres personnalisés s’ouvre.

Nom de commande : openSettings

ID par défaut :

{ "command": { "action": "openSettings", "target": "settingsUI" }, "id": "Terminal.OpenSettingsUI" },
{ "command": { "action": "openSettings", "target": "settingsFile" }, "id": "Terminal.OpenSettingsFile" },
{ "command": { "action": "openSettings", "target": "defaultsFile" }, "keys": "Terminal.OpenDefaultSettingsFile" }

Copier les liaisons par défaut :

{ "keys": "ctrl+,", "id": "Terminal.OpenSettingsUI" },
{ "keys": "ctrl+shift+,", "id": "Terminal.OpenSettingsFile" },
{ "keys": "ctrl+alt+,", "id": "Terminal.OpenDefaultSettingsFile" }

Paramètres

Nom	Nécessité	Accepte	Description
`target`	Facultatif	`"settingsFile"`, , `"defaultsFile""settingsUI"`, ,`"allFiles"`	Fichier de paramètres à ouvrir.

Ouvre le menu système dans l’angle supérieur gauche de la fenêtre.

Nom de commande : openSystemMenu

ID par défaut :

{ "command": "openSystemMenu", "id": "Terminal.OpenSystemMenu" }

Liaison par défaut :

{ "keys": "alt+space", "id": "Terminal.OpenSystemMenu" }

Passer en plein écran

Cela vous permet de basculer entre les tailles de fenêtre par défaut et plein écran.

Nom de commande : toggleFullscreen

ID par défaut

{ "command": "toggleFullscreen", "id": "Terminal.ToggleFullscreen" }

Copier les liaisons par défaut :

{ "keys": "alt+enter", "id": "Terminal.ToggleFullscreen" },
{ "keys": "f11", "id": "Terminal.ToggleFullscreen" }

Activer/désactiver le mode Focus

Vous permet d’entrer en « mode Focus », qui masque les onglets et la barre de titre.

Nom de commande : toggleFocusMode

ID par défaut :

{ "command": "toggleFocusMode", "id": "Terminal.ToggleFocusMode" }

Activer/désactiver le mode Toujours visible

Vous permet d’activer ou de désactiver l’état « Toujours visible » de la fenêtre. En mode « Toujours visible », la fenêtre s’affiche devant toutes les autres fenêtres qui ne sont pas au premier plan.

Nom de commande : toggleAlwaysOnTop

ID par défaut :

{ "command": "toggleAlwaysOnTop", "id": "Terminal.ToggleAlwaysOnTop" }

Envoyer l’entrée

Envoie une entrée de texte arbitraire au shell. À titre d’exemple, l’entrée "text\n" écrit « text » suivi d’un saut de ligne dans le shell.

Les séquences d’échappement ANSI peuvent être utilisées, mais les codes d’échappement comme \x1b doivent être écrits sous la forme \u001b. Par exemple, "\u001b[A" se comporte comme si le bouton flèche haut avait été enfoncé.

Nom de commande : sendInput

Liaison par défaut :

Cette commande n’est pas actuellement liée dans les paramètres par défaut.

{ "command": { "action": "sendInput", "input": "\u001b[A" } }

Paramètres

Nom	Nécessité	Accepte	Description
`input`	Obligatoire	String	Entrée de texte à alimenter dans le shell.

Commandes de gestion des onglets

Fermer l’onglet

Ferme l’onglet à un index donné. Si aucun index n’est fourni, utilise l’index de l’onglet ayant le focus.

Nom de commande : closeTab

Paramètres

Nom	Nécessité	Accepte	Description
`index`	Facultatif	Integer	Position de l’onglet à fermer.

Fermer tous les autres onglets

Ferme tous les onglets sauf celui à un index donné. Si aucun index n’est fourni, utilise l’index de l’onglet ayant le focus.

Nom de commande : closeOtherTabs

ID par défaut :

{ "command": "closeOtherTabs", "id": "Terminal.CloseOtherTabs" }

Paramètres

Nom	Nécessité	Accepte	Description
`index`	Facultatif	Integer	Position de l’onglet à garder ouvert.

Fermer les onglets après l’index

Ferme les onglets situés après l’onglet à un index donné. Si aucun index n’est fourni, utilise l’index de l’onglet ayant le focus.

Nom de commande : closeTabsAfter

ID par défaut :

{ "command": "closeTabsAfter", "id": "Terminal.CloseTabsAfter" }

Paramètres

Nom	Nécessité	Accepte	Description
`index`	Facultatif	Integer	Position du dernier onglet à garder ouvert.

Dupliquer l'onglet

Fait une copie du profil et du répertoire de l’onglet actuel et l’ouvre. Les VARIABLES ENV modifiées/ajoutées ne sont pas incluses.

Nom de commande : duplicateTab

ID par défaut :

{ "command": "duplicateTab", "id": "Terminal.DuplicateTab" }

Liaison par défaut :

{ "keys": "ctrl+shift+d", "id": "Terminal.DuplicateTab" }

Nouvel onglet

Cela crée un nouvel onglet. Sans aucun argument, cela ouvrira le profil par défaut dans un nouvel onglet. Si aucun index n'est spécifié, le paramètre équivalent du profil par défaut sera utilisé. Si l'index ne correspond pas à un profil, les clés sont transmises directement au terminal (ou ignorées si aucune clé n'a été utilisée pour invoquer l'action).

Nom de commande : newTab

ID par défaut :

{ "command": "newTab", "id": "Terminal.OpenNewTab" },
{ "command": { "action": "newTab", "index": 0 }, "id": "Terminal.OpenNewTabProfile0" },
{ "command": { "action": "newTab", "index": 1 }, "id": "Terminal.OpenNewTabProfile1" },
{ "command": { "action": "newTab", "index": 2 }, "id": "Terminal.OpenNewTabProfile2" },
{ "command": { "action": "newTab", "index": 3 }, "id": "Terminal.OpenNewTabProfile3" },
{ "command": { "action": "newTab", "index": 4 }, "id": "Terminal.OpenNewTabProfile4" },
{ "command": { "action": "newTab", "index": 5 }, "id": "Terminal.OpenNewTabProfile5" },
{ "command": { "action": "newTab", "index": 6 }, "id": "Terminal.OpenNewTabProfile6" },
{ "command": { "action": "newTab", "index": 7 }, "id": "Terminal.OpenNewTabProfile7" },
{ "command": { "action": "newTab", "index": 8 }, "id": "Terminal.OpenNewTabProfile8" }

Copier les liaisons par défaut :

{ "keys": "ctrl+shift+t", "id": "Terminal.OpenNewTab" },
{ "keys": "ctrl+shift+1", "id": "Terminal.OpenNewTabProfile0" },
{ "keys": "ctrl+shift+2", "id": "Terminal.OpenNewTabProfile1" },
{ "keys": "ctrl+shift+3", "id": "Terminal.OpenNewTabProfile2" },
{ "keys": "ctrl+shift+4", "id": "Terminal.OpenNewTabProfile3" },
{ "keys": "ctrl+shift+5", "id": "Terminal.OpenNewTabProfile4" },
{ "keys": "ctrl+shift+6", "id": "Terminal.OpenNewTabProfile5" },
{ "keys": "ctrl+shift+7", "id": "Terminal.OpenNewTabProfile6" },
{ "keys": "ctrl+shift+8", "id": "Terminal.OpenNewTabProfile7" },
{ "keys": "ctrl+shift+9", "id": "Terminal.OpenNewTabProfile8" }

Paramètres

Nom	Nécessité	Accepte	Description
`commandline`	Facultatif	Nom de fichier exécutable sous forme de chaîne	Exécutable exécuté dans l’onglet.
`startingDirectory`	Facultatif	Emplacement du dossier sous forme de chaîne	Répertoire dans lequel l’onglet s’ouvre.
`elevate`	Facultatif	`true`, , `falsenull`	Remplace la propriété `elevate` du profil. En cas d’omission, cette action se comporte conformément au paramètre `elevate` du profil. Quand la valeur est `true` ou `false`, cette action se comporte comme si le profil était défini avec `"elevate": true` ou `"elevate": false` (respectivement).
`tabTitle`	Facultatif	String	Le titre du nouvel onglet.
`index`	Facultatif	Entier	Le profil qui s’ouvre en fonction de sa position dans la liste déroulante (à partir de 0).
`profile`	Facultatif	Nom ou GUID du profil sous forme de chaîne	Le profil qui s’ouvre en fonction de son GUID ou de son nom.
`colorScheme`	Facultatif	Nom du modèle de couleurs en tant que chaîne	Modèle à utiliser à la place du `colorScheme` défini pour le profil
`suppressApplicationTitle`	Facultatif	`true`, `false`	Quand la valeur est `false`, les applications peuvent modifier le titre de l’onglet en envoyant des messages de modification de titre. Quand la valeur est `true`, ces messages sont supprimés. Si rien n’est indiqué, le comportement est hérité des paramètres du profil. Pour entrer un nouveau titre d’onglet et le rendre persistant, cette valeur doit être true.

Ouvrir l’onglet suivant

Ouvre l’onglet à droite de l’onglet actuel.

Nom de commande : nextTab

ID par défaut :

{ "command": "nextTab", "id": "Terminal.NextTab" }

Liaison par défaut :

{ "keys": "ctrl+tab", "id": "Terminal.NextTab" }

Paramètres

Nom	Nécessité	Accepte	Description
`tabSwitcherMode`	Facultatif	`"mru"`, , `"inOrder""disabled"`	Permet de passer à l’onglet suivant avec `"tabSwitcherMode"`. Si aucun mode n’est fourni, utilisez celui défini globalement.

Ouvrir l'onglet précédent

Ouvre l’onglet à gauche de l’onglet actuel.

Nom de commande : prevTab

ID par défaut :

{ "command": "prevTab", "id": "Terminal.PrevTab" }

Liaison par défaut :

{ "keys": "ctrl+shift+tab", "id": "Terminal.PrevTab" }

Paramètres

Nom	Nécessité	Accepte	Description
`tabSwitcherMode`	Facultatif	`"mru"`, , `"inOrder""disabled"`	Permet de passer à l’onglet précédent avec `"tabSwitcherMode"`. Si aucun mode n’est fourni, utilisez celui défini globalement.

Recherche d’onglet

Ouvre la zone de recherche d’onglet.

Nom de commande : tabSearch

Liaison par défaut :

Cette commande n’est pas actuellement liée dans les paramètres par défaut.

{"command": "tabSearch"}

Ouvrir un onglet spécifique

Ouvre un onglet spécifique en fonction de l’index.

Nom de commande : switchToTab

ID par défaut :

{ "command": { "action": "switchToTab", "index": 0 }, "id": "Terminal.SwitchToTab0" },
{ "command": { "action": "switchToTab", "index": 1 }, "id": "Terminal.SwitchToTab1" },
{ "command": { "action": "switchToTab", "index": 2 }, "id": "Terminal.SwitchToTab2" },
{ "command": { "action": "switchToTab", "index": 3 }, "id": "Terminal.SwitchToTab3" },
{ "command": { "action": "switchToTab", "index": 4 }, "id": "Terminal.SwitchToTab4" },
{ "command": { "action": "switchToTab", "index": 5 }, "id": "Terminal.SwitchToTab5" },
{ "command": { "action": "switchToTab", "index": 6 }, "id": "Terminal.SwitchToTab6" },
{ "command": { "action": "switchToTab", "index": 7 }, "id": "Terminal.SwitchToTab7" }

Copier les liaisons par défaut :

{ "keys": "ctrl+alt+1", "id": "Terminal.SwitchToTab0" },
{ "keys": "ctrl+alt+2", "id": "Terminal.SwitchToTab1" },
{ "keys": "ctrl+alt+3", "id": "Terminal.SwitchToTab2" },
{ "keys": "ctrl+alt+4", "id": "Terminal.SwitchToTab3" },
{ "keys": "ctrl+alt+5", "id": "Terminal.SwitchToTab4" },
{ "keys": "ctrl+alt+6", "id": "Terminal.SwitchToTab5" },
{ "keys": "ctrl+alt+7", "id": "Terminal.SwitchToTab6" },
{ "keys": "ctrl+alt+8", "id": "Terminal.SwitchToTab7" }

Paramètres

Nom	Nécessité	Accepte	Description
`index`	Obligatoire	Entier	L’onglet qui s’ouvre en fonction de sa position dans la barre d’onglets (à partir de 0).

Renommer un onglet

Cette commande peut être utilisée pour renommer un onglet en une chaîne spécifique.

Nom de commande : renameTab

Liaison par défaut :

Cette commande n’est pas actuellement liée dans les paramètres par défaut.

// Rename a tab to "Foo"
{ "command": { "action": "renameTab", "title": "Foo" } }

// Reset the tab's name
{ "command": { "action": "renameTab", "title": null } }

Paramètres

Nom	Nécessité	Accepte	Description
`title`	Facultatif	String	Nouveau titre à utiliser pour cet onglet. En cas d’omission, cette commande rétablit le titre d’origine de l’onglet.

Ouvrir la zone de texte de renommage d’un onglet

Cette commande remplace le titre de l’onglet par un champ de texte qui vous permet de modifier le titre de l’onglet actif. Si vous effacez le champ de texte, le titre d’onglet par défaut est rétabli pour l’instance de shell active.

Nom de commande : openTabRenamer

ID par défaut :

{ "command": "openTabRenamer", "id": "Terminal.OpenTabRenamer" }

Modifier la couleur de l’onglet

Cette commande peut être utilisée pour remplacer la couleur d’un onglet par une valeur spécifique.

Nom de commande : setTabColor

Liaison par défaut :

Cette commande n’est pas actuellement liée dans les paramètres par défaut.

// Change the tab's color to a bright magenta
{ "command": { "action": "setTabColor", "color": "#ff00ff" } }

// Reset the tab's color
{ "command": { "action": "setTabColor", "color": null } }

Paramètres

Nom	Nécessité	Accepte	Description
`color`	Facultatif	Chaîne au format hexadécimal : `"#rgb"` ou `"#rrggbb"`	Nouvelle couleur à utiliser pour cet onglet. En cas d’omission, cette commande rétablit la couleur d’origine de l’onglet.

Ouvrir le sélecteur de couleurs d’onglet

Vous pouvez utiliser cette commande pour ouvrir le sélecteur de couleurs pour l’onglet actif. Le sélecteur permet de définir une couleur pour l’onglet au moment de l’exécution.

Nom de commande : openTabColorPicker

ID par défaut :

{ "command": "openTabColorPicker", "id": "Terminal.OpenTabColorPicker" }

Déplacer l’onglet

Cette commande déplace l’onglet vers l’arrière (« backward ») et vers l’avant (« forward »), ce qui équivaut à « left » et « right » dans l’interface utilisateur de gauche à droite.

Nom de commande : moveTab

ID par défaut :

// Move tab backward (left in LTR)
{ "command": { "action": "moveTab", "direction": "backward" }, "id": "Terminal.MoveTabBackward" }

// Move tab forward (right in LTR)
{ "command": { "action": "moveTab", "direction": "forward" }, "id": "Terminal.MoveTabForward" }

Paramètres

Nom	Nécessité	Accepte	Description
`direction`	Obligatoire	`"backward"`, `"forward"`	Direction dans laquelle l’onglet est déplacé.
`window`	Facultatif	ID de fenêtre	Voir ci-dessous

window est facultatif et suit le même format que l’argument --window-id à la ligne de commande wt.exe. S’il est omis, cela déplace l’onglet dans la fenêtre active. Si elle est fournie, il peut s’agir de l’ID entier d’une fenêtre ou du nom d’une fenêtre. Il accepte également les valeurs réservées suivantes :

"new" ou -1 : toujours exécuter cette commande dans une nouvelle fenêtre
"last" ou 0 : toujours exécuter cette commande dans la dernière fenêtre utilisée

Si aucune fenêtre n’existe avec l’ID window donné, une nouvelle fenêtre est créée avec cet ID/nom.

Entrée de diffusion

Cette commande basculera en « mode de diffusion » pour un volet. Lorsque le mode de diffusion est activé, toutes les entrées envoyées au volet seront envoyées à tous les volets du même onglet. Ceci est utile pour envoyer la même entrée à plusieurs volets à la fois.

Comme pour n’importe quelle action, vous pouvez également appeler « mode de diffusion » en recherchant « Activer/désactiver l’entrée de diffusion dans tous les volets » dans la palette de commandes.

Nom de commande : toggleBroadcastInput

ID par défaut :

{ "command": "toggleBroadcastInput", "id": "Terminal.ToggleBroadcastInput" }

Entrée de diffusion

Cette commande ouvrira le menu contextuel « clic droit » pour le volet actif. Ce menu propose des actions contextuelles pour la gestion des volets, le copier-coller, etc. Cette action ne nécessite pas que le paramètre experimental.rightClickContextMenu soit activé.

Nom de commande : showContextMenu

ID par défaut :

{ "command": "showContextMenu", "id": "Terminal.ShowContextMenu" }

Ouvrir la boîte de dialogue À propos

Cette commande ouvrira la boîte de dialogue À propos du terminal. Cette boîte de dialogue contient des informations sur le terminal, notamment le numéro de version, la licence, etc.

Nom de commande : openAbout

ID par défaut :

{ "command": "openAbout", "id": "Terminal.OpenAboutDialog" }

Important

Cette fonctionnalité n’est disponible que dans la préversion de Terminal Windows.

Rechercher sur le web

Tente d'ouvrir une fenêtre de navigateur avec une recherche du texte sélectionné. Cela ne fait rien si aucun texte n'est sélectionné. Si le paramètre queryUrl n’est pas fourni, le paramètre searchWebDefaultQueryUrl sera utilisé à la place. Si le paramètre queryUrl est fourni, un %s dans la chaîne sera remplacé par le texte sélectionné.

Nom de commande : searchWeb

ID par défaut :

{ "command": { "action": "searchWeb" }, "id": "Terminal.SearchWeb" },

Paramètres

Nom	Nécessité	Accepte	Description
`queryUrl`	Obligatoire	String	URL à utiliser pour effectuer la recherche. Un `%s` dans cette chaîne sera remplacé par le texte sélectionné. En cas d'omission, le paramètre `searchWebDefaultQueryUrl` sera défini par défaut.

Important

Cette fonctionnalité n’est disponible que dans la préversion de Terminal Windows.

Commandes de gestion des fenêtres

Nouvelle fenêtre

Crée une fenêtre. Si aucun argument n’est spécifié, le profil par défaut s’ouvre dans une nouvelle fenêtre (quel que soit la valeur du paramètre windowingBehavior). Si aucune action n’est spécifiée, le paramètre équivalent du profil par défaut est utilisé.

Nom de commande : newWindow

ID par défaut :

{ "command": "newWindow", "id": "Terminal.OpenNewWindow" },

Liaison par défaut :

{ "keys": "ctrl+shift+n", "id": "Terminal.OpenNewWindow" },

Paramètres

Nom	Nécessité	Accepte	Description
`commandline`	Facultatif	Nom de fichier exécutable sous forme de chaîne	Exécutable exécuté dans l’onglet.
`startingDirectory`	Facultatif	Emplacement du dossier sous forme de chaîne	Répertoire dans lequel la fenêtre s’ouvre.
`tabTitle`	Facultatif	String	Titre de l’onglet de la fenêtre.
`index`	Facultatif	Entier	Le profil qui s’ouvre en fonction de sa position dans la liste déroulante (à partir de 0).
`profile`	Facultatif	Nom ou GUID du profil sous forme de chaîne	Le profil qui s’ouvre en fonction de son GUID ou de son nom.
`suppressApplicationTitle`	Facultatif	`true`, `false`	Quand la valeur est `false`, les applications peuvent modifier le titre de l’onglet en envoyant des messages de modification de titre. Lorsqu’il est défini sur `true` supprime ces messages. Si rien n’est indiqué, le comportement est hérité des paramètres du profil.

Renommer une fenêtre

Cette commande peut être utilisée pour renommer une fenêtre en une chaîne spécifique.

Nom de commande : renameWindow

Liaison par défaut :

Cette commande n’est pas actuellement liée dans les paramètres par défaut.

// Rename a window to "Foo"
{ "command": { "action": "renameWindow", "name": "Foo" } }

// Reset the window's name
{ "command": { "action": "renameWindow", "name": null } }

Paramètres

Nom	Nécessité	Accepte	Description
`name`	Facultatif	String	Nouveau nom à utiliser pour cette fenêtre. En cas d’omission, cette commande rétablit le nom d’origine de la fenêtre.

Ouvrir la boîte de dialogue de renommage de fenêtre

Cette commande affiche une fenêtre contextuelle qui vous permet de modifier le nom de la fenêtre active. L’effacement du champ de texte réinitialise le nom de la fenêtre.

Nom de commande : openWindowRenamer

ID par défaut :

{ "command": "openWindowRenamer", "id": "Terminal.OpenWindowRenamer" }

Identifier la fenêtre

Ouvre une fenêtre de superposition sur la fenêtre qui a le focus pour afficher le nom et l’index de la fenêtre.

Nom de commande : identifyWindow

ID par défaut :

{"command": "identifyWindow", "id": "Terminal.IdentifyWindow" },

Identifier les fenêtres

Ouvre une fenêtre de superposition sur toutes les fenêtre pour afficher le nom et l’index de chaque fenêtre.

Nom de commande : identifyWindows

Liaison par défaut :

Cette commande n’est pas actuellement liée dans les paramètres par défaut.

{ "command": "identifyWindows" },

Commandes de gestion du volet

Fractionner un volet

Divise par deux la taille du volet actif et en ouvre un autre. Sans aucun argument, le profil par défaut s’ouvre dans le nouveau volet. Si aucune action n’est spécifiée, le paramètre équivalent du profil par défaut est utilisé.

Nom de commande : splitPane

ID par défaut :

{ "command": { "action": "splitPane", "splitMode": "duplicate", "split": "auto" }, "id": "Terminal.DuplicatePaneAuto" },
{ "command": { "action": "splitPane", "split": "up" }, "id": "Terminal.SplitPaneUp" },
{ "command": { "action": "splitPane", "split": "down" }, "id": "Terminal.SplitPaneDown" },
{ "command": { "action": "splitPane", "split": "left" }, "id": "Terminal.SplitPaneLeft" },
{ "command": { "action": "splitPane", "split": "right" }, "id": "Terminal.SplitPaneRight" },
{ "command": { "action": "splitPane", "splitMode": "duplicate", "split": "down" }, "id": "Terminal.DuplicatePaneDown" },
{ "command": { "action": "splitPane", "splitMode": "duplicate", "split": "right" }, "id": "Terminal.DuplicatePaneRight" }

Copier les liaisons par défaut :

{ "keys": "alt+shift+d", "id": "Terminal.DuplicatePaneAuto" },
{ "keys": "alt+shift+-", "id": "Terminal.DuplicatePaneDown" },
{ "keys": "alt+shift+plus", "id": "Terminal.DuplicatePaneRight" }

Paramètres

Nom	Nécessité	Accepte	Description
`split`	Obligatoire	`"vertical"`, `"horizontal"`, , `"up""auto"`, `"right"`, , `"down"`,`"left"`	Mode de fractionnement du volet. `"auto"` fractionne dans le sens qui fournit la plus grande surface.
`commandline`	Facultatif	Nom de fichier exécutable sous forme de chaîne	Exécutable exécuté dans le volet.
`startingDirectory`	Facultatif	Emplacement du dossier sous forme de chaîne	Répertoire dans lequel le volet s’ouvre.
`elevate`	Facultatif	`true`, , `falsenull`	Remplace la propriété `elevate` du profil. En cas d’omission, cette action se comporte conformément au paramètre `elevate` du profil. Quand la valeur est `true` ou `false`, cette action se comporte comme si le profil était défini avec `"elevate": true` ou `"elevate": false` (respectivement).
`tabTitle`	Facultatif	String	Titre de l’onglet lorsque le nouveau volet a le focus.
`index`	Facultatif	Entier	Le profil qui s’ouvre en fonction de sa position dans la liste déroulante (à partir de 0).
`profile`	Facultatif	Nom ou GUID du profil sous forme de chaîne	Le profil qui s’ouvre en fonction de son GUID ou de son nom.
`colorScheme`	Facultatif	Nom du modèle de couleurs en tant que chaîne	Modèle à utiliser à la place du `colorScheme` défini pour le profil
`suppressApplicationTitle`	Facultatif	`true`, `false`	Quand la valeur est `false`, les applications peuvent modifier le titre de l’onglet en envoyant des messages de modification de titre. Quand la valeur est `true`, ces messages sont supprimés. Si rien n’est indiqué, le comportement est hérité des paramètres du profil.
`splitMode`	Facultatif	`"duplicate"`	Contrôle le mode de fractionnement du volet. Accepte uniquement `"duplicate"`, qui duplique le profil du volet actif dans un nouveau volet.
`size`	Facultatif	Float	Spécifiez la taille du nouveau volet en tant que fraction de la taille du volet actif. `1.0` signifie « tout du volet actuel » et `0.0` signifie « rien du parent ». La valeur par défaut est `0.5`.

Fermer le volet

Ferme le volet actif. S’il n’existe pas de volets fractionnés, l’onglet actuel est fermé. Si un seul onglet est ouvert, la fenêtre est fermée.

Nom de commande : closePane

ID par défaut :

{ "command": "closePane", "id": "Terminal.ClosePane" }

Liaison par défaut :

{ "keys": "ctrl+shift+w", "id": "Terminal.ClosePane" }

Déplacer le focus du volet

Modifie le focus sur un autre volet en fonction de la direction. La définition de direction sur "previous" déplace le focus vers le dernier volet utilisé.

Nom de commande : moveFocus

ID par défaut :

{ "command": { "action": "moveFocus", "direction": "down" }, "id": "Terminal.MoveFocusDown" },
{ "command": { "action": "moveFocus", "direction": "left" }, "id": "Terminal.MoveFocusLeft" },
{ "command": { "action": "moveFocus", "direction": "right" }, "id": "Terminal.MoveFocusRight" },
{ "command": { "action": "moveFocus", "direction": "up" }, "id": "Terminal.MoveFocusUp" },
{ "command": { "action": "moveFocus", "direction": "previous" }, "id": "Terminal.MoveFocusPrevious" }

Copier les liaisons par défaut :

{ "keys": "alt+down", "id": "Terminal.MoveFocusDown" },
{ "keys": "alt+left", "id": "Terminal.MoveFocusLeft" },
{ "keys": "alt+right", "id": "Terminal.MoveFocusRight" },
{ "keys": "alt+up", "id": "Terminal.MoveFocusUp" },
{ "keys": "ctrl+alt+left", "id": "Terminal.MoveFocusPrevious" }

Paramètres

Nom	Nécessité	Accepte	Description
`direction`	Obligatoire	`"left"`, , `"right"`, `"down""up"`, , `"previousInOrder""parent""nextInOrder""first""previous""child"`	Direction dans laquelle le focus se déplace.

Valeurs direction acceptées

up, down, left ou right : déplace le focus dans la direction donnée.
first : déplace le focus sur le premier volet de nœud terminal dans l’arborescence.
previous : déplace le focus sur le dernier volet utilisé avant le volet actif.
nextInOrder ou previousInOrder : déplace le focus sur le volet suivant ou précédent selon l’ordre de création.
parent : déplace le focus pour sélectionner le volet parent du volet actif. Cela permet à l’utilisateur de sélectionner plusieurs volets à la fois.
child : déplace le focus sur le premier volet enfant de ce volet.

Volet Déplacer

Permet de déplacer le volet actif vers un autre onglet de la fenêtre.

Nom de commande : movePane

ID par défaut :

{ "command": { "action": "movePane", "index": 0 }, "id": "Terminal.MovePaneToTab0" },
{ "command": { "action": "movePane", "index": 1 }, "id": "Terminal.MovePaneToTab1" },
{ "command": { "action": "movePane", "index": 2 }, "id": "Terminal.MovePaneToTab2" },
{ "command": { "action": "movePane", "index": 3 }, "id": "Terminal.MovePaneToTab3" },
{ "command": { "action": "movePane", "index": 4 }, "id": "Terminal.MovePaneToTab4" },
{ "command": { "action": "movePane", "index": 5 }, "id": "Terminal.MovePaneToTab5" },
{ "command": { "action": "movePane", "index": 6 }, "id": "Terminal.MovePaneToTab6" },
{ "command": { "action": "movePane", "index": 7 }, "id": "Terminal.MovePaneToTab7" },
{ "command": { "action": "movePane", "index": 8 }, "id": "Terminal.MovePaneToTab8" }

Paramètres

Nom	Nécessité	Accepte	Description
`index`	Obligatoire	nombre	Index indexé à zéro de l’onglet vers lequel se déplacer.

Permuter les volets

Permet de permuter la position de deux volets dans un onglet. L’opération porte sur le volet actif et un volet cible désigné par le paramètre direction.

Nom de commande : swapPane

ID par défaut :

{ "command": { "action": "swapPane", "direction": "down" }, "id": "Terminal.SwapPaneDown" },
{ "command": { "action": "swapPane", "direction": "left" }, "id": "Terminal.SwapPaneLeft" },
{ "command": { "action": "swapPane", "direction": "right" }, "id": "Terminal.SwapPaneRight" },
{ "command": { "action": "swapPane", "direction": "up" }, "id": "Terminal.SwapPaneUp" },
{ "command": { "action": "swapPane", "direction": "previous"}, "id": "Terminal.SwapPanePrevious" },
{ "command": { "action": "swapPane", "direction": "previousInOrder"}, "id": "Terminal.SwapPanePreviousInOrder" },
{ "command": { "action": "swapPane", "direction": "nextInOrder"}, "id": "Terminal.SwapPaneNextInOrder" },
{ "command": { "action": "swapPane", "direction": "first" }, "id": "Terminal.SwapPaneFirst" }

Paramètres

Nom	Nécessité	Accepte	Description
`direction`	Obligatoire	`"left"`, , `"right"`, `"down""up"`, , `"previousInOrder""parent""nextInOrder""first""previous""child"`	Direction dans laquelle le focus se déplace.

Valeurs direction acceptées (valeurs identiques à celles de la commande moveFocus)

up, down, left ou right : permute le volet actif avec le volet situé dans la direction donnée.
first : permute le volet actif avec le premier volet de nœud terminal de l’arborescence.
previous : permute le volet actif avec le dernier volet utilisé avant le volet actif.
nextInOrder ou previousInOrder : permute le volet actif avec le volet suivant ou précédent selon l’ordre de création.
parent : ne fait rien.
child : ne fait rien.

Zoomer sur un volet

Développe le volet ayant le focus pour remplir tout le contenu de la fenêtre.

Nom de commande : togglePaneZoom

ID par défaut :

{ "command": "togglePaneZoom", "id": "Terminal.TogglePaneZoom" }

Activation/Désactivation du zoom sur un volet du Terminal Windows

Redimensionner un volet

Modifie la taille du volet actif.

Nom de commande : resizePane

ID par défaut :

{ "command": { "action": "resizePane", "direction": "down" }, "id": "Terminal.ResizePaneDown" },
{ "command": { "action": "resizePane", "direction": "left" }, "id": "Terminal.ResizePaneLeft" },
{ "command": { "action": "resizePane", "direction": "right" }, "id": "Terminal.ResizePaneRight" },
{ "command": { "action": "resizePane", "direction": "up" }, "id": "Terminal.ResizePaneUp" }

Copier les liaisons par défaut :

{ "keys": "alt+shift+down", "id": "Terminal.ResizePaneDown" },
{ "keys": "alt+shift+left", "id": "Terminal.ResizePaneLeft" },
{ "keys": "alt+shift+right", "id": "Terminal.ResizePaneRight" },
{ "keys": "alt+shift+up", "id": "Terminal.ResizePaneUp" }

Paramètres

Nom	Nécessité	Accepte	Description
`direction`	Obligatoire	`"left"`, , `"right""up"`, ,`"down"`	Sens dans lequel le volet sera redimensionné.

Marquage d’un volet en lecture seule

Vous pouvez marquer un volet comme étant en lecture seule, ce qui a pour effet d’empêcher le transfert de toute entrée dans la mémoire tampon de texte. Si vous tentez de fermer ou d’entrer du texte dans un volet en lecture seule, le terminal affiche un avertissement contextuel.

Nom de commande : toggleReadOnlyMode

ID par défaut :

{ "command": "toggleReadOnlyMode", "id": "Terminal.ToggleReadOnlyMode" }

Vous pouvez activer le mode lecture seule dans un volet. Cela fonctionne de la même façon qu’un bouton bascule, mais par contre, cela ne change pas l’état si redéclenché.

Nom de commande : enableReadOnlyMode

ID par défaut :

{ "command": "enableReadOnlyMode", "id": "Terminal.EnableReadOnlyMode" }

Vous pouvez désactiver le mode lecture seule dans un volet. Cela fonctionne de la même façon qu’un bouton bascule, mais par contre, cela ne change pas l’état si redéclenché.

Nom de commande : disableReadOnlyMode

ID par défaut :

{ "command": "disableReadOnlyMode", "id": "Terminal.DisableReadOnlyMode" }

Redémarrer un volet

Cette commande redémarrera manuellement le commandline dans le volet actif. Ceci est particulièrement utile pour des scénarios tels que ssh, dans lesquels vous souhaiterez peut-être redémarrer une connexion sans fermer le volet.

Notez que cela mettra fin au processus dans le volet, s'il est en cours d'exécution.

Nom de commande : restartConnection

ID par défaut :

{ "command": "restartConnection", "id": "Terminal.RestartConnection" }

Commandes d’intégration du presse-papiers

Copier

Cette option permet de copier le contenu du terminal sélectionné dans le presse-papiers. Si aucune sélection n’existe, la pression simultanée sur les touches est envoyée directement au terminal.

Nom de commande : copy

ID par défaut :

{ "command": { "action": "copy", "singleLine": false }, "id": "Terminal.CopyToClipboard" }

Copier les liaisons par défaut :

{ "keys": "ctrl+c", "id": "Terminal.CopyToClipboard" },
{ "keys": "ctrl+shift+c", "id": "Terminal.CopyToClipboard" },
{ "keys": "ctrl+insert", "id": "Terminal.CopyToClipboard" },
{ "keys": "enter", "id": "Terminal.CopyToClipboard" }

Paramètres

Nom	Nécessité	Accepte	Description
`singleLine`	Facultatif	`true`, `false`	Si `true`, le contenu copié est copié sous la forme d’une ligne unique. Si `false`, les nouvelles lignes sont conservées à partir du texte sélectionné.
`copyFormatting`	Facultatif	`true`, , `false`, `"none""all"`, , `"html""rtf"`	Quand la valeur est `true`, la mise en forme de la couleur et de la police du texte sélectionné est également copiée dans votre Presse-papiers. Quand la valeur est `false`, seul le texte brut est copié dans votre Presse-papiers. Vous pouvez également spécifier les formats que vous souhaitez copier. Quand la valeur est `null`, le comportement global de `"copyFormatting"` est hérité.

Coller

Insère le contenu qui a été copié dans le presse-papiers.

Nom de commande : paste

ID par défaut :

{ "command": "paste", "id": "Terminal.PasteFromClipboard" }

Copier les liaisons par défaut :

{ "keys": "ctrl+v", "id": "Terminal.PasteFromClipboard" },
{ "keys": "ctrl+shift+v", "id": "Terminal.PasteFromClipboard" },
{ "keys": "shift+insert", "id": "Terminal.PasteFromClipboard" }

Étendre la sélection au mot

Si une sélection existe, cela développe la sélection pour englober entièrement les mots partiellement sélectionnés.

Nom de commande : expandSelectionToWord

ID par défaut :

{ "command": "expandSelectionToWord", "id": "Terminal.ExpandSelectionToWord" }

Sélectionner tout

Cela sélectionne tout le contenu du tampon de texte.

Nom de commande : selectAll

ID par défaut :

{ "command": "selectAll", "id": "Terminal.SelectAll" }

Liaison par défaut :

{ "keys": "ctrl+shift+a", "id": "Terminal.SelectAll" }

Mode Marque

Cela active ou désactive le mode marquage. Le mode marquage est un mode qui vous permet d’utiliser le clavier pour faire une sélection à la position du curseur dans le terminal.

Nom de commande : markMode

ID par défaut :

{ "command": "markMode", "id": "Terminal.ToggleMarkMode" }

Liaison par défaut :

{ "keys": "ctrl+shift+m", "id": "Terminal.ToggleMarkMode" }

Passer à un autre marqueur de sélection

Lorsque vous modifiez une sélection à l’aide du clavier, vous déplacez une extrémité de la sélection. Vous pouvez utiliser cette action pour passer à l’autre marqueur de sélection.

Nom de commande : switchSelectionEndpoint

ID par défaut :

{ "command": "switchSelectionEndpoint", "id": "Terminal.SwitchSelectionEndpoint" },

Activer/Désactiver la sélection de bloc

Fait de la sélection existante une sélection de bloc, ce qui signifie que la zone sélectionnée est un rectangle, par opposition à l’inclusion dans un wrapper au début et à la fin de chaque ligne.

Nom de commande : toggleBlockSelection

ID par défaut :

{ "command": "toggleBlockSelection", "id": "Terminal.ToggleBlockSelection" },

Commandes de défilement

Faire défiler vers le haut

Fait défiler l’écran vers le haut du nombre de lignes défini par "rowsToScroll". Si "rowsToScroll" n’est pas fourni, le défilement vers le haut est défini par la valeur système par défaut, qui correspond au défilement avec la souris.

Nom de commande : scrollUp

ID par défaut :

{ "command": "scrollUp", "id": "Terminal.ScrollUp" }

Liaison par défaut :

{ "keys": "ctrl+shift+up", "id": "Terminal.ScrollUp" }

Paramètres

Nom	Nécessité	Accepte	Description
`rowsToScroll`	Facultatif	Integer	Nombre de lignes à faire défiler.

Faire défiler vers le bas

Fait défiler l’écran vers le bas du nombre de lignes défini par "rowsToScroll". Si "rowsToScroll" n’est pas fourni, le défilement vers le bas est défini par la valeur système par défaut, qui correspond au défilement avec la souris.

Nom de commande : scrollDown

ID par défaut :

{ "command": "scrollDown", "id": "Terminal.ScrollDown" }

Liaison par défaut :

{ "keys": "ctrl+shift+down", "id": "Terminal.ScrollDown" }

Paramètres

Nom	Nécessité	Accepte	Description
`rowsToScroll`	Facultatif	Integer	Nombre de lignes à faire défiler.

Faire défiler une page entière

Fait défiler l’écran d’une page entière, ce qui correspond à la hauteur de la fenêtre.

Nom de commande : scrollUpPage

ID par défaut :

{ "command": "scrollUpPage", "id": "Terminal.ScrollUpPage" }

Liaison par défaut :

{ "keys": "ctrl+shift+pgup", "id": "Terminal.ScrollUpPage" }

Faire défiler l’intégralité d’une page

Fait défiler l’écran d’une page entière, qui est la hauteur de la fenêtre.

Nom de commande : scrollDownPage

ID par défaut :

{ "command": "scrollDownPage", "id": "Terminal.ScrollDownPage" }

Liaison par défaut :

{ "keys": "ctrl+shift+pgdn", "id": "Terminal.ScrollDownPage" }

Faire défiler jusqu’à l’historique le plus ancien

Fait défiler l’écran jusqu’en haut de la mémoire tampon d’entrée.

Nom de commande : scrollToTop

ID par défaut :

{ "command": "scrollToTop", "id": "Terminal.ScrollToTop" }

Liaison par défaut :

{ "keys": "ctrl+shift+home", "id": "Terminal.ScrollToTop" }

Faire défiler jusqu’au dernier historique

Fait défiler l’écran jusqu’en bas de la mémoire tampon d’entrée.

Nom de commande : scrollToBottom

ID par défaut :

{ "command": "scrollToBottom", "id": "Terminal.ScrollToBottom" }

Liaison par défaut :

{ "keys": "ctrl+shift+end", "id": "Terminal.ScrollToBottom" }

Vider la mémoire tampon

Cette action peut être utilisée pour effacer manuellement la mémoire tampon du terminal. Elle est utile lorsque vous ne disposez pas d’une invite d’interpréteur de ligne de commande et que vous ne pouvez pas facilement exécuter Clear-Host/cls/clear.

Nom de commande : clearBuffer

ID par défaut :

{ "command": { "action": "clearBuffer", "clear": "all" }, "id": "Terminal.ClearBuffer" }

Paramètres

Nom	Nécessité	Accepte	Description
`clear`	Facultatif	`"screen"`, , `"scrollback""all"`	Partie de l’écran à effacer. `"screen"` : effacer le contenu de la fenêtre d’affichage du terminal. Laisse le défilement arrière intact. Déplace la ligne de curseur en haut de la fenêtre d’affichage (inchangée). `"scrollback"` : effacer le défilement arrière. Laisse la fenêtre d’affichage intacte. `"all"` (par défaut) : effacer le défilement arrière et la fenêtre d’affichage visible. Déplace la ligne de curseur en haut de la fenêtre d’affichage.

___

Commandes d’ajustement visuel

Ajuster la taille de police

Modifie la taille du texte d’une valeur de point spécifiée.

Nom de commande : adjustFontSize

ID par défaut :

{ "command": { "action": "adjustFontSize", "delta": 1 }, "id": "Terminal.IncreaseFontSize" },
{ "command": { "action": "adjustFontSize", "delta": -1 }, "id": "Terminal.DecreaseFontSize" }

Copier les liaisons par défaut :

{ "keys": "ctrl+plus", "id": "Terminal.IncreaseFontSize" },
{ "keys": "ctrl+minus", "id": "Terminal.DecreaseFontSize" },
{ "keys": "ctrl+numpad_plus", "id": "Terminal.IncreaseFontSize" },
{ "keys": "ctrl+numpad_minus", "id": "Terminal.DecreaseFontSize" }

Paramètres

Nom	Nécessité	Accepte	Description
`delta`	Obligatoire	Entier	Quantité de changement de taille par appel de commande.

Réinitialiser la taille de police

Rétablit la valeur par défaut de la taille du texte.

Nom de commande : resetFontSize

ID par défaut :

{ "command": "resetFontSize", "id": "Terminal.ResetFontSize" }

Copier les liaisons par défaut :

{ "keys": "ctrl+0", "id": "Terminal.ResetFontSize" },
{ "keys": "ctrl+numpad_0", "id": "Terminal.ResetFontSize" }

Ajuster l'opacité

Permet de modifier l’opacité de la fenêtre. Si relative a la valeur true, l’opacité est ajustée par rapport à l’opacité actuelle. Sinon, l’opacité est définie directement avec la valeur opacity donnée.

Nom de commande : adjustOpacity

Copier les liaisons par défaut :

{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 0 } },
{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 25 } },
{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 50 } },
{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 75 } },
{ "command": { "action": "adjustOpacity", "relative": false, "opacity": 100 } }

Paramètres

Nom	Nécessité	Accepte	Description
`opacity`	Facultatif	Integer	Degré d’opacité à affecter au terminal ou montant du changement de l’opacité, en fonction de la valeur de `relative`
`relative`	Facultatif	Booléen	Si la valeur est true, l’opacité actuelle est ajustée selon le paramètre `opacity` donné. Si la valeur est false, l’opacité est définie avec cette valeur.

Activer/désactiver les effets du nuanceur de pixels

Active ou désactive les effets du nuanceur de pixels activés dans le terminal. Si l’utilisateur a spécifié un nuanceur valide avec experimental.pixelShaderPath, cette action active/désactive ce nuanceur. Cela entraîne également le basculement de « l’effet façon rétro du terminal », qui est activé avec le paramètre de profil experimental.retroTerminalEffect.

Nom de commande : toggleShaderEffects

ID par défaut :

{ "command": "toggleShaderEffects", "id": "Terminal.ToggleShaderEffects" }

Attention

L’action toggleRetroEffect n’est plus disponible dans les versions 1,6 et ultérieures. Nous vous recommandons d’utiliser toggleShaderEffects à la place.

Définir le modèle de couleurs

Modifie le modèle de couleurs actif.

Nom de commande : setColorScheme

Paramètres

Nom	Nécessité	Accepte	Description
`colorScheme`	Obligatoire	String	`name` du modèle de couleurs à appliquer.

Exemple de déclaration :

{ "command": { "action": "setColorScheme", "colorScheme": "Campbell" }, "id": "User.SetSchemeToCampbell" }

Ajouter une marque de défilement

Ajoute une marque de défilement à la mémoire tampon de texte. S’il y a déjà une sélection, la marque est placée au niveau de la sélection ; sinon, elle est placée sur la ligne du curseur.

Nom de commande : addMark

Paramètres

Nom	Nécessité	Accepte	Description
`color`	Facultatif	Chaîne au format hexadécimal : `"#rgb"` ou `"#rrggbb"`	Couleur de la marque.

Exemple de déclaration :

{ "command": { "action": "addMark", "color": "#ff00ff" }, "id": "User.AddMark" }

Important

Cette action est devenue stable dans la version 1.21. Avant cette version, elle était disponible uniquement dans Windows Terminal Preview

Faire défiler jusqu’à la marque

Fait défiler jusqu’à la marque de défilement dans la direction donnée. Pour plus d’informations, consultez marques de défilement et intégration Shell.

Nom de commande : scrollToMark

Paramètres

Nom	Nécessité	Accepte	Description
`direction`	Obligatoire	`"first"`, , `"previous""next"`, ,`"last"`	Sens dans lequel faire défiler.

Exemple de déclaration :

{ "command": { "action": "scrollToMark", "direction": "previous" }, "id": "User.ScrollToMark" }

Important

Cette action est devenue stable dans la version 1.21. Avant cette version, elle était disponible uniquement dans Windows Terminal Preview

Effacer la marque

Efface la marque de défilement à la position actuelle, soit au niveau d’une sélection s’il y en a une, soit à la position du curseur. Il s'agit d'une fonctionnalité expérimentale et sa pérennité n'est pas garantie.

Nom de commande : clearMark

Exemple de déclaration :

{ "command": { "action": "clearMark" }, "id": "User.ClearMark" }

Important

Cette action est devenue stable dans la version 1.21. Avant cette version, elle était disponible uniquement dans Windows Terminal Preview

Effacer toutes les marques

Efface toutes les marques de défilement dans la mémoire tampon de texte. Il s'agit d'une fonctionnalité expérimentale et sa pérennité n'est pas garantie.

Nom de commande : clearAllMarks

Exemple de déclaration :

{ "command": { "action": "clearAllMarks" }, "id": "User.ClearAllMarks" }

Important

Cette action est devenue stable dans la version 1.21. Avant cette version, elle était disponible uniquement dans Windows Terminal Preview

___

Suggestions

Cela permet à l'utilisateur d'ouvrir le menu des suggestions. Les entrées du menu de suggestions sont contrôlées par la propriété source. Le menu de suggestions se comporte un peu comme la palette de commandes. Taper dans la zone de texte filtrera les résultats pour afficher uniquement les entrées qui correspondent au texte. Appuyer enter sur exécutera l’entrée sélectionnée. Appuyer esc sur fermera le menu.

Interface utilisateur des suggestions

Nom de commande : showSuggestions

Paramètres

Nom	Nécessité	Accepte	Description
`source`	Obligatoire	n'importe quel nombre de `"recentCommands"`, `"tasks"`, ou `"all"`	Quelles sources de suggestions utiliser pour remplir ce menu. Voir ci-dessous pour une description de chacun.
`useCommandline`	Facultatif	Booléen	Si l'intégration du shell est activée, et c'est le cas de `true`, le menu de suggestions sera pré-rempli avec le contenu de la ligne de commande actuelle. La valeur par défaut est `true`

Sources de suggestions

Les sources de suggestions suivantes sont prises en charge :

"recentCommands" : Cela remplira le menu de suggestions avec les commandes les plus récemment utilisées. Ceux-ci sont alimentés par l'intégration du shell, ils ne seront donc disponibles que si votre shell est configuré pour prendre en charge l'intégration du shell. Voir Intégration Shell pour plus d’informations.
"tasks" : Cela remplira le menu de suggestions avec toutes les actions sendInput de vos paramètres.
"all" : Utilisez toutes les sources de suggestions.

Ces valeurs peuvent être utilisées seules comme valeur de paramètre de chaîne ou combinées sous forme de tableau. Par exemple :

{ "command": { "action": "showSuggestions", "source": ["recentCommands", "tasks"] } },
{ "command": { "action": "showSuggestions", "source": "all" } },
{ "command": { "action": "showSuggestions", "source": "recentCommands" } },

Dans l'exemple ci-dessus, les deux premières commandes ouvriront le menu de suggestions avec les commandes et tâches récentes. La troisième commande ouvrira le menu de suggestions avec uniquement les commandes récentes.

Important

Cette fonctionnalité n’est disponible que dans la préversion de Terminal Windows.

___

Exportation de mémoire tampon

Tampon d'exportation

Permet à l’utilisateur d’exporter le texte de la mémoire tampon dans un fichier. Si le fichier n’existe pas, il est créé. Si le fichier existe déjà, son contenu est remplacé par le texte de la mémoire tampon du terminal.

Nom de commande : exportBuffer

ID par défaut :

{ "command": { "action": "exportBuffer" }, "id": "Terminal.ExportBuffer" }

Paramètres

Nom	Nécessité	Accepte	Description
`path`	Facultatif	String	S’il est fourni, le terminal exporte le contenu de la mémoire tampon dans le fichier donné. Sinon, le terminal ouvre un sélecteur vous permettant de choisir le fichier vers lequel exporter le contenu.

___

Commandes globales

Appel global

Il s’agit d’une action spéciale qui fonctionne globalement dans le système d’exploitation, et non uniquement dans le contexte de la fenêtre du terminal. Quand vous appuyez dessus, cette action appelle la fenêtre du terminal. Les propriétés de cette action permettent de contrôler quelle fenêtre est appelée, où elle appelée et comment elle se comporte lors de son appel.

Remarques

Les touches liées aux actions globalSummon dans le terminal ne fonctionnent pas dans d’autres applications quand le terminal est en cours d’exécution. La fenêtre du terminal a toujours le focus.
Si une autre application en cours d’exécution utilise déjà les keys données avec l’API RegisterHotKey, le terminal ne peut pas écouter ces combinaisons de touches.
Les instances avec et sans élévation de privilèges du terminal ne peuvent pas utiliser les mêmes touches. Il en va de même pour les versions Préversion et Stable du terminal. La première lancée l’emportera toujours.
Ces combinaisons de touches ne fonctionnent que lorsqu’une instance du terminal est déjà en cours d’exécution. Pour lancer automatiquement le terminal dès la connexion, consultez startOnUserLogin.

Nom de commande : globalSummon

Liaison par défaut :

Cette commande n’est pas actuellement liée dans les paramètres par défaut.

{ "command": { "action": "globalSummon" } }

Paramètres

Nom	Nécessité	Accepte	Description
`desktop`	Facultatif	`any`, , `toCurrentonCurrent`	Contrôle la manière dont le terminal doit interagir avec les bureaux virtuels. `"any"` :laisse la fenêtre sur le bureau où elle se trouve déjà (bascule vers ce bureau lorsque la fenêtre est activée). `"toCurrent"` (valeur par défaut) : déplace la fenêtre vers le bureau virtuel actuel. `"onCurrent"` : appelle uniquement la fenêtre si elle se trouve déjà sur le bureau virtuel actuel.
`monitor`	Facultatif	`any`, , `toCurrenttoMouse`	Contrôle le moniteur à partir duquel ou vers lequel la fenêtre sera appelée. `"any"` :appelle la fenêtre la plus récemment utilisée, quel que soit le moniteur où elle se trouve actuellement. `"toCurrent"` : appelle la fenêtre la plus récemment utilisée sur le moniteur avec la fenêtre de premier plan active. `"toMouse"` (valeur par défaut) : appelle la fenêtre la plus récemment utilisée sur le moniteur où se trouve le curseur de la souris.
`name`	Facultatif	String	En cas d’omission (valeur par défaut), utilise `monitor` et `desktop` pour rechercher la fenêtre la plus récemment utilisée à appeler. Si cette action est fournie, appelle la fenêtre dont le nom ou l’ID correspond à la valeur `name` donnée. Si aucune fenêtre de ce type n’existe, crée une fenêtre portant ce nom.
`dropdownDuration`	Facultatif	Integer	La valeur par défaut est `0`. Si cette action est fournie avec un nombre positif, « fait glisser » la fenêtre depuis le haut de l’écran à l’aide d’une animation qui dure `dropdownDuration` millisecondes. `200` est une valeur raisonnable pour ce paramètre.
`toggleVisibility`	Facultatif	`true`, `false`	La valeur par défaut est `true`. Quand la valeur est `true`, le fait d’appuyer sur les touches affectées pour cette action ignore (réduit) la fenêtre quand celle-ci est actuellement la fenêtre de premier plan. Quand la valeur est `false`, le fait d’appuyer sur les touches affectées ne fait que mettre la fenêtre au premier plan.

Lorsqu’il name est fourni avec monitor ou desktop, name se comporte de la manière suivante :

desktop
- "any" : accède au bureau où la fenêtre donnée se trouve déjà.
- "toCurrent" : si la fenêtre se trouve sur un autre bureau virtuel, elle est déplacée vers celui qui est actuellement actif.
- "onCurrent" : si la fenêtre se trouve sur un autre bureau virtuel, elle est déplacée vers celui qui est actuellement actif.
monitor
- "any" : laisse la fenêtre sur le moniteur où elle se trouve déjà.
- "toCurrent" : si la fenêtre se trouve sur un autre moniteur, elle est déplacée vers celui avec la fenêtre de premier plan active.
- "toMouse" : si la fenêtre se trouve sur un autre moniteur, elle est déplacée vers celui où se trouve le curseur de la souris.

Les propriétés desktop et monitor peuvent être combinées des manières suivantes :

Combinaisons	`"desktop": "any"`	`"desktop": "toCurrent"`	`"desktop": "onCurrent"`	Non inclus
`"monitor": "any"`	Accède au bureau où se trouve la fenêtre (position inchangée)	Déplace la fenêtre vers ce bureau (position inchangée)	S’il n’y en a pas sur ce bureau : En crée une à la position par défaut Sinon : Active celle sur ce bureau (sans la déplacer)	Appeler la fenêtre MRU
`"monitor": "toCurrent"`	Accède au bureau où la fenêtre se trouve, passe au moniteur avec la fenêtre de premier plan	Déplace la fenêtre vers ce bureau, passe au moniteur avec la fenêtre de premier plan	S’il n’y en a pas sur ce bureau : En crée une Sinon : Active celle sur ce bureau, passe au moniteur avec la fenêtre de premier plan	Appelle la fenêtre MRU sur le moniteur avec la fenêtre de premier plan
`"monitor": "toMouse"`	Accède au bureau où la fenêtre se trouve, passe au moniteur avec la souris	Déplace la fenêtre vers ce bureau, passe au moniteur avec la souris	S’il n’y en a pas sur ce bureau : En crée une Sinon : Active celle sur ce bureau, passe au moniteur avec la souris	Appelle la fenêtre MRU sur le moniteur avec la souris
Non incluses	Conserve la position actuelle	Passe au bureau actuel	Sur le bureau actuel uniquement	N/A

Exemples


// Summon the most recently used (MRU) window, to the current virtual desktop,
// to the monitor the mouse cursor is on, without an animation. If the window is
// already in the foreground, then minimize it.
{ "command": { "action": "globalSummon" }, "id": "User.MyGlobalSummon" },

// Summon the MRU window, by going to the virtual desktop the window is
// currently on. Move the window to the monitor the mouse is on.
{ "command": { "action": "globalSummon", "desktop": "any" }, "id": "User.MyGlobalSummonAnyDesktop" },

// Summon the MRU window to the current desktop, leaving the position of the window untouched.
{ "command": { "action": "globalSummon", "monitor": "any" }, "id": "User.MyGlobalSummonAnyMonitor" },

// Summon the MRU window, by going to the virtual desktop the window is
// currently on, leaving the position of the window untouched.
{ "command": { "action": "globalSummon", "desktop": "any", "monitor": "any" }, "id": "User.MyGlobalSummonAnywhere" },

// Summon the MRU window with a dropdown duration of 200ms.
{ "command": { "action": "globalSummon", "dropdownDuration": 200 }, "id": "User.MyGlobalSummonDrop" },

// Summon the MRU window. If the window is already in the foreground, do nothing.
{ "command": { "action": "globalSummon", "toggleVisibility": false }, "id": "User.MyGlobalSummonIfNotVisible" },

// Summon the window named "_quake". If no window with that name exists, then create a new window.
{ "command": { "action": "globalSummon", "name": "_quake" }, "id": "User.MyGlobalSummonQuake" }

Ouvrir la fenêtre en mode Quake

Cette action est une variante spéciale de l’action globalSummon. Elle appelle spécifiquement la fenêtre Quake. Il s’agit d’un raccourci pour l’action globalSummon suivante :

{
"id": "User.MySummonQuake",
"command": {
"action": "globalSummon",
"name": "_quake",
"dropdownDuration": 200,
"toggleVisibility": true,
"monitor": "toMouse",
"desktop": "toCurrent"
}
}

Si vous souhaitez modifier le comportement de l’action quakeMode, nous vous recommandons de créer une entrée globalSummon dans actions avec les paramètres de votre choix.

Nom de commande : quakeMode

ID par défaut :

{ "command": "quakeMode", "id": "Terminal.QuakeMode" }

Mode Quake dans le Terminal Windows

Exécuter plusieurs actions

Cette action permet à l’utilisateur de lier plusieurs actions séquentielles à une seule commande. Ces actions ne prennent pas en charge les ID.

Nom de commande : multipleActions

Paramètres

Nom	Nécessité	Accepte	Description
`actions`	Obligatoire	Tableau d’actions	Liste de `action` à exécuter.

Exemple

{ "name": "Create My Layout", "command": {
    "action": "multipleActions",
    "actions": [
        // Create a new tab with 3 panes
        { "action": "newTab", "tabTitle": "Work", "colorScheme": "One Half Dark" },
        { "action": "splitPane", "split": "vertical", "profile": "Windows PowerShell", "tabTitle": "Work", "colorScheme": "Campbell Powershell", },
        { "action": "splitPane", "split": "horizontal", "profile": "Windows PowerShell", "tabTitle": "Work", "colorScheme": "Campbell Powershell", },

        // Create a second tab
        { "action": "newTab", "tabTitle": "Misc"},

        // Go back to the first tab and zoom the first pane
        { "action": "prevTab", "tabSwitcherMode": "disabled" },
        { "action": "moveFocus", "direction": "first"},
        "togglePaneZoom"
        ]
}}

Dissocier les touches (désactiver les combinaisons de touches)

Vous pouvez désactiver les combinaisons de touches ou « dissocier » les touches associées à une commande. Cela peut s’avérer nécessaire lors de l’utilisation d’applications de terminal sous-jacentes (comme VIM). La touche dissociée est passée au terminal sous-jacent.

Nom de commande : unbound

Exemple utilisant unbound :

Par exemple, pour délier les touches de raccourci Alt+Maj+- « et Alt+Maj+= », incluez ces commandes dans la actionssection de votre fichier settings.json.

{
    "keybindings": [
        { "id": "unbound", "keys": "alt+shift+-" },
        { "id": "unbound", "keys": "alt+shift+=" }
    ]
}

Exemple utilisant null :

Vous pouvez également dissocier une combinaison de touches associée par défaut à une action en définissant "id" avec la valeur null. Cela permet également d’associer la combinaison de touches au paramètre d’application de ligne de commande au lieu d’exécuter l’action par défaut.

{
   "id" : null, "keys" : ["ctrl+v"]
}

Scénario d’utilisation :

Terminal Windows utilise la combinaison de touches de raccourci Ctrl + Virgule pour la commande Coller. Quand vous utilisez une ligne de commande WSL, vous pouvez utiliser une application Linux telle que Vim pour modifier des fichiers. Cependant, Vim s’appuie sur la combinaison de touches Ctrl + V pour utiliser le mode visuel par blocs (blockwise Visual). Cette combinaison de touches sera bloquée et la commande Coller du Terminal Windows sera prioritaire, sauf si le paramètre unbound est ajusté dans votre fichier settings.json de manière à associer la combinaison de touches à l’application de ligne de commande Vim plutôt qu’à la commande du Terminal Windows.

Partager via

Actions personnalisées et liaisons de clés dans Terminal Windows

Formats d’action

Commandes sans arguments

Commandes avec arguments

Commandes avec arguments de ligne de commande

Propriétés des actions

Commande

Action

Nom

Icône

id

Keybindings

Propriétés keybinding

Touches

id

Modificateurs acceptés

Touches de modification

Commandes au niveau de l’application

Quitter

Fermer la fenêtre

Rechercher

Rechercher le résultat de recherche suivant/précédent

Paramètres

Ouvrir la liste déroulante

Ouvrir les fichiers de paramètres

Paramètres

Ouvrir le menu système

Passer en plein écran

Activer/désactiver le mode Focus

Activer/désactiver le mode Toujours visible

Envoyer l’entrée

Paramètres

Commandes de gestion des onglets

Fermer l’onglet

Paramètres

Fermer tous les autres onglets

Paramètres

Fermer les onglets après l’index

Paramètres

Dupliquer l'onglet

Nouvel onglet

Paramètres

Ouvrir l’onglet suivant

Paramètres

Ouvrir l'onglet précédent

Paramètres

Recherche d’onglet

Ouvrir un onglet spécifique

Paramètres

Renommer un onglet

Paramètres

Ouvrir la zone de texte de renommage d’un onglet

Modifier la couleur de l’onglet

Paramètres

Ouvrir le sélecteur de couleurs d’onglet

Déplacer l’onglet

Paramètres

Entrée de diffusion

Ouvrir le menu contextuel

Ouvrir la boîte de dialogue À propos

Rechercher sur le web

Paramètres

Commandes de gestion des fenêtres

Nouvelle fenêtre

Paramètres

Renommer une fenêtre

Paramètres

Ouvrir la boîte de dialogue de renommage de fenêtre

Identifier la fenêtre

Identifier les fenêtres

Commandes de gestion du volet

Fractionner un volet

Paramètres

Fermer le volet

Déplacer le focus du volet

Paramètres

Volet Déplacer

Paramètres

Permuter les volets