Acciones personalizadas en Terminal Windows

Importante

A partir Terminal Windows versión 1.4, se ha cambiado el nombre de la matriz keybindings a actions dentro del archivo settings.json. La compatibilidad con la matriz keybindings sigue existiendo por compatibilidad con versiones anteriores, pero el terminal no cambiará automáticamente el nombre de keybindings a actions dentro del archivo settings.json.

Puede crear acciones personalizadas dentro de Terminal Windows que le dan control sobre cómo interactúa con el terminal. Estas acciones se agregarán automáticamente a la paleta de comandos.

Formatos de acción

Las acciones se pueden estructurar en los siguientes formatos:

Comandos sin argumentos

{ "command": "commandName", "keys": "modifiers+key" }

Por ejemplo, esta configuración predeterminada utiliza las teclas de método abreviado Alt+F4 para cerrar la ventana del terminal:

{ "command": "closeWindow", "keys": "alt+f4" }

Comandos con argumentos

{ "command": { "action": "commandName", "argument": "value" }, "keys": "modifiers+key" }

Por ejemplo, esta configuración predeterminada utiliza las teclas de método abreviado Ctrl+Mayús+1 para abrir una nueva pestaña en el terminal según el perfil que aparezca en primer lugar en el menú desplegable (normalmente se abrirá el perfil de PowerShell):

{ "command": { "action": "newTab", "index": 0 }, "keys": "ctrl+shift+1" }


Propiedades de la acción

Las acciones se pueden construir con las siguientes propiedades.

Comando

Este es el comando que se ejecuta cuando se presionan las teclas asociadas.

Nombre de propiedad:command

Necesidad: Requerido

Acepta: Cadena

Teclas

Define las combinaciones de teclas que se usan para llamar al comando. Puede haber cualquier número de modificadores con una tecla. Las teclas y los modificadores aceptados se enumeran a continuación.

Si la acción no tiene teclas, aparecerá en la paleta de comandos, pero no se puede invocar con el teclado.

Nombre de propiedad:keys

Necesidad: Opcional

Acepta: Cadena o matriz[cadena]

Acción

Agrega funcionalidad adicional a determinados comandos.

Nombre de propiedad:action

Necesidad: Opcional

Acepta: Cadena

Nombre

Esto establece el nombre que aparecerá en la paleta de comandos. Si no se proporciona uno, el terminal intentará generar automáticamente un nombre.

Nombre de propiedad:name

Necesidad: opcional

Acepta: Cadena

Icon

Esto establece el icono que se muestra en la paleta de comandos.

Nombre de propiedad:icon

Necesidad: Opcional

Acepta: ubicación del archivo como cadena o emoji



Teclas y modificadores aceptados

Modificadores

ctrl+, shift+, alt+, win+

Nota

Aunque la clave Windows se admite como modificador, el sistema reserva la mayoría de los enlaces de clave win+<key>. Si el sistema operativo ha reservado ese enlace de claves, el terminal nunca recibirá ese enlace.

Teclas modificadoras

Tipo Teclas
Teclas de función y alfanuméricas f1-f24, a-z, 0-9
Símbolos `, plus, -, =, [, ], \, ;, ', ,, ., /
Teclas de dirección down, left, right, up, pagedown, pageup, pgdn, pgup, end, home
Teclas de acción tab, enter, esc, escape, space, backspace, delete, insert, app, menu
Teclas del teclado numérico numpad_0-numpad_9, numpad0-numpad9, numpad_add, numpad_plus, numpad_decimal, numpad_period, numpad_divide, numpad_minus, numpad_subtract, numpad_multiply
Teclas del explorador browser_back, browser_forward, browser_refresh, browser_stop, browser_search, browser_favorites, browser_home

Nota:= y plus son equivalentes. Este último no debe confundirse con numpad_plus.


Comandos en el nivel de aplicación

Salga.

Cierra todas las ventanas de terminal abiertas. Aparecerá un cuadro de diálogo de confirmación en la ventana actual para asegurarse de que desea cerrar todas las ventanas.

Nombre del comando:quit

Enlace predeterminado:

{ "command": "quit" }

Cerrar ventana

Cierra la ventana actual y todas las pestañas que contiene. Si confirmCloseAllTabs está establecido en true, aparecerá un cuadro de diálogo de confirmación para asegurarse de que desea cerrar todas las pestañas. Se puede encontrar más información sobre esta configuración en la página Apariencia.

Nombre del comando:closeWindow

Enlace predeterminado:

{ "command": "closeWindow", "keys": "alt+f4" }

Terminal Windows confirma si se cierran todas las pestañas

Buscar

Abre el cuadro de diálogo de búsqueda. Puede encontrar más información sobre la búsqueda en la página de búsqueda.

Nombre del comando:find

Enlace predeterminado:

{ "command": "find", "keys": "ctrl+shift+f" }

Buscar la coincidencia de búsqueda siguiente o anterior

Le permite navegar por las coincidencias de búsqueda.

Nombre del comando:findMatch

Enlace predeterminado:

{ "command": { "action": "findMatch", "direction": "next" } },
{ "command": { "action": "findMatch", "direction": "prev" } }

Parámetros

Nombre Necesidad Acepta Descripción
direction Obligatorio "next", "prev" Dirección para navegar por los resultados de la búsqueda.

Abrir el menú desplegable

Abre el menú desplegable.

Nombre del comando:openNewTabDropdown

Enlace predeterminado:

{ "command": "openNewTabDropdown", "keys": "ctrl+shift+space" }

Abrir archivos de configuración

Se abre la interfaz de usuario de configuración, el archivo de configuración personalizado (settings.json) o el archivo de configuración predeterminado (defaults.json), dependiendo del campo target. Sin el campo target, se abrirá el archivo de configuración personalizado.

Nombre del comando:openSettings

Enlace predeterminado:

{ "command": { "action": "openSettings", "target": "settingsUI" }, "keys": "ctrl+," },
{ "command": { "action": "openSettings", "target": "settingsFile" }, "keys": "ctrl+shift+," },
{ "command": { "action": "openSettings", "target": "defaultsFile" }, "keys": "ctrl+alt+," },

Parámetros

Nombre Necesidad Acepta Descripción
target Opcional "settingsFile", "defaultsFile", "settingsUI", "allFiles" Archivo de configuración que se va a abrir.

Abrir menú del sistema

Abre el menú del sistema en la esquina superior izquierda de la ventana.

Nombre del comando:openSystemMenu

Enlace predeterminado:

{ "command": "openSystemMenu", "keys": "alt+space" }

Alternar pantalla completa

Permite cambiar entre el tamaño de ventana predeterminado y la pantalla completa.

Nombre del comando:toggleFullscreen

Enlace predeterminado:

{ "command": "toggleFullscreen", "keys": "alt+enter" },
{ "command": "toggleFullscreen", "keys": "f11" }

Alternar el modo de enfoque

Le permite entrar en el "modo de enfoque", que oculta las pestañas y la barra de título.

Nombre del comando:toggleFocusMode

Enlace predeterminado:

{ "command": "toggleFocusMode" }

Alternar siempre visible

Le permite alternar el estado "siempre visible" de la ventana. Cuando está en modo "siempre visible", la ventana aparecerá encima de todas las demás ventanas que no están en el nivel superior.

Nombre del comando:toggleAlwaysOnTop

Enlace predeterminado:

{ "command": "toggleAlwaysOnTop" }

Enviar entrada

Envíe una entrada de texto arbitraria al shell. Por ejemplo, la entrada "text\n" escribirá "texto" seguido de una nueva línea en el shell.

Se pueden usar secuencias de escape ANSI, pero los códigos de escape como \x1b deben escribirse como \u001b. Por ejemplo, "\u001b[A" se comportará como si se hubiera presionado el botón de flecha arriba.

Nombre del comando:sendInput

Enlace predeterminado:

Este comando no está enlazado actualmente en la configuración predeterminada.

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

Parámetros

Nombre Necesidad Acepta Descripción
input Requerido String Entrada de texto que se introducirá en el shell.


Comandos de administración de pestañas

Cerrar pestaña

Cierra la pestaña en un índice determinado. Si no se proporciona ningún índice, use el índice de la pestaña enfocada.

Nombre del comando:closeTab

Parámetros

Nombre Necesidad Acepta Descripción
index Opcional Entero Posición de la pestaña que se cerrará.

Cerrar todas las demás pestañas

Cierra todas las pestañas excepto la de un índice. Si no se proporciona ningún índice, use el índice de la pestaña enfocada.

Nombre del comando:closeOtherTabs

Enlace predeterminado:

{ "command": "closeOtherTabs" }

Parámetros

Nombre Necesidad Acepta Descripción
index Opcional Entero Posición de la pestaña que se va a mantener abierta.

Cerrar pestañas después del índice

Cierra las pestañas siguientes a la pestaña en un índice. Si no se proporciona ningún índice, use el índice de la pestaña enfocada.

Nombre del comando:closeTabsAfter

Enlace predeterminado:

{ "command": "closeTabsAfter" }

Parámetros

Nombre Necesidad Acepta Descripción
index Opcional Entero Posición de la última pestaña que se va a mantener abierta.

Duplicar pestaña

Realiza una copia del perfil y el directorio de la pestaña actual y lo abre. No incluye VARIABLES ENV modificadas o agregadas.

Nombre del comando:duplicateTab

Enlace predeterminado:

{ "command": "duplicateTab", "keys": "ctrl+shift+d" }

Nueva pestaña

Crea una pestaña. Sin argumentos, abre el perfil predeterminado en una nueva pestaña. Si no se especifica un índice, se usa la configuración equivalente del perfil predeterminado. Si el índice no se asigna a un perfil, las claves se envían directamente al terminal (o se omiten si no se usó ninguna clave para invocar la acción).

Nombre del comando:newTab

Enlace predeterminado:

{ "command": "newTab", "keys": "ctrl+shift+t" },
{ "command": { "action": "newTab", "index": 0 }, "keys": "ctrl+shift+1" },
{ "command": { "action": "newTab", "index": 1 }, "keys": "ctrl+shift+2" },
{ "command": { "action": "newTab", "index": 2 }, "keys": "ctrl+shift+3" },
{ "command": { "action": "newTab", "index": 3 }, "keys": "ctrl+shift+4" },
{ "command": { "action": "newTab", "index": 4 }, "keys": "ctrl+shift+5" },
{ "command": { "action": "newTab", "index": 5 }, "keys": "ctrl+shift+6" },
{ "command": { "action": "newTab", "index": 6 }, "keys": "ctrl+shift+7" },
{ "command": { "action": "newTab", "index": 7 }, "keys": "ctrl+shift+8" },
{ "command": { "action": "newTab", "index": 8 }, "keys": "ctrl+shift+9" }

Parámetros

Nombre Necesidad Acepta Descripción
commandline Opcional Nombre del archivo ejecutable como una cadena El archivo ejecutable se ejecuta dentro de la pestaña.
startingDirectory Opcional Ubicación de la carpeta como una cadena Directorio en el que se abrirá la pestaña.
elevate Opcional true, false, null Invalida la propiedad elevate del perfil. Si se omite, esta acción se comportará de acuerdo con el valor de configuración elevate del perfil. Si se establece en true o false, esta acción se comportará como si el perfil estuviese establecido con "elevate": true o "elevate": false (respectivamente).
tabTitle Opcionales Cadena Título de la pestaña nueva
index Opcional Entero Perfil que se abrirá en función de su posición en la lista desplegable (comenzando en 0).
profile Opcional Nombre o GUID del perfil como una cadena Perfil que se abrirá en función del GUID o nombre.
colorScheme Opcional Nombre de la combinación de colores como una cadena Esquema que se va a usar en lugar del conjunto del perfil colorScheme
suppressApplicationTitle Opcional true, false Cuando se establece en false, las aplicaciones pueden cambiar el título de la pestaña mediante el envío de mensajes de cambio de título. Cuando se establece en true, estos mensajes se suprimen. Si no se proporciona, el comportamiento se hereda de la configuración del perfil. Para escribir un nuevo título de pestaña y hacer que el título se conserve, debe establecerse en true.

Abrir siguiente pestaña

Se abre la pestaña situada a la derecha de la actual.

Nombre del comando:nextTab

Enlace predeterminado:

{ "command": "nextTab", "keys": "ctrl+tab" }

Parámetros

Nombre Necesidad Acepta Descripción
tabSwitcherMode Opcional "mru", "inOrder", "disabled" Se mueve a la pestaña siguiente mediante "tabSwitcherMode". Si no se proporciona ningún modo, use el definido globalmente.

Abrir pestaña anterior

Se abre la pestaña situada a la izquierda de la actual.

Nombre del comando:prevTab

Enlace predeterminado:

{ "command": "prevTab", "keys": "ctrl+shift+tab" }

Parámetros

Nombre Necesidad Acepta Descripción
tabSwitcherMode Opcional "mru", "inOrder", "disabled" Se mueve a la pestaña anterior mediante "tabSwitcherMode". Si no se proporciona ningún modo, use el definido globalmente.

Se abre el cuadro de búsqueda de pestañas.

Nombre del comando:tabSearch

Enlace predeterminado:

Este comando no está enlazado actualmente en la configuración predeterminada.

{"command": "tabSearch", "keys": ""}

Búsqueda de pestañas de Terminal Windows

Abrir una pestaña específica

Se abre una pestaña específica según el índice.

Nombre del comando:switchToTab

Enlace predeterminado:

{ "command": { "action": "switchToTab", "index": 0 }, "keys": "ctrl+alt+1" },
{ "command": { "action": "switchToTab", "index": 1 }, "keys": "ctrl+alt+2" },
{ "command": { "action": "switchToTab", "index": 2 }, "keys": "ctrl+alt+3" },
{ "command": { "action": "switchToTab", "index": 3 }, "keys": "ctrl+alt+4" },
{ "command": { "action": "switchToTab", "index": 4 }, "keys": "ctrl+alt+5" },
{ "command": { "action": "switchToTab", "index": 5 }, "keys": "ctrl+alt+6" },
{ "command": { "action": "switchToTab", "index": 6 }, "keys": "ctrl+alt+7" },
{ "command": { "action": "switchToTab", "index": 7 }, "keys": "ctrl+alt+8" },
{ "command": { "action": "switchToTab", "index": 8 }, "keys": "ctrl+alt+9" }

Parámetros

Nombre Necesidad Acepta Descripción
index Requerido Entero Pestaña que se abrirá en función de su posición en la barra de pestañas (comenzando en 0).

Cambiar nombre de pestaña

Este comando se puede usar para cambiar el nombre de una pestaña a una cadena específica.

Nombre del comando:renameTab

Enlace predeterminado:

Este comando no está enlazado actualmente en la configuración predeterminada.

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

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

Parámetros

Nombre Necesidad Acepta Descripción
title Opcional String Nuevo título que se va a usar para esta pestaña. Si se omite, este comando revertirá el título de la pestaña a su valor original.

Cuadro de texto Abrir nombre de pestaña

Este comando cambia el título de la pestaña a un campo de texto que le permite editar el título de la pestaña actual. Al borrar el campo de texto, se restablecerá el título de la pestaña al valor predeterminado de la instancia de shell actual.

Nombre del comando:openTabRenamer

Enlace predeterminado:

{ "command": "openTabRenamer" }

Cambiar el color de la pestaña

Este comando se puede usar para cambiar el color de una pestaña a un valor específico.

Nombre del comando:setTabColor

Enlace predeterminado:

Este comando no está enlazado actualmente en la configuración predeterminada.

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

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

Parámetros

Nombre Necesidad Acepta Descripción
color Opcional Cadena en formato hexadecimal: "#rgb" o "#rrggbb" Nuevo color que se va a usar para esta pestaña. Si se omite, este comando revertirá el color de la pestaña a su valor original.

Abrir selector de colores de la pestaña

Este comando se puede usar para abrir el selector de colores de la pestaña activa. El selector de colores se puede usar para establecer un color para la pestaña en tiempo de ejecución.

Nombre del comando:openTabColorPicker

Enlace predeterminado:

{ "command": "openTabColorPicker" }

Mover pestaña

Este comando mueve la pestaña "hacia atrás" y "hacia delante", que equivale a "izquierda" y "derecha" en la interfaz de usuario de izquierda a derecha.

Nombre del comando:moveTab

Enlace predeterminado:

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

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

Parámetros

Nombre Necesidad Acepta Descripción
direction Obligatorio "backward", "forward" Dirección en la que se moverá la pestaña.


Comandos de administración de ventanas

Nueva ventana

Crea una ventana nueva. Sin argumentos, se abrirá el perfil predeterminado en una nueva ventana (independientemente de la configuración de windowingBehavior). Si no se especifica una acción, se usa la configuración equivalente del perfil predeterminado.

Nombre del comando:newWindow

Enlace predeterminado:

{ "command": "newWindow", "keys": "ctrl+shift+n" },

Parámetros

Nombre Necesidad Acepta Descripción
commandline Opcional Nombre del archivo ejecutable como una cadena El archivo ejecutable se ejecuta dentro de la pestaña.
startingDirectory Opcional Ubicación de la carpeta como una cadena Directorio en el que se abrirá la ventana.
tabTitle Opcional String Título de la pestaña de la ventana.
index Opcional Entero Perfil que se abrirá en función de su posición en la lista desplegable (comenzando en 0).
profile Opcional Nombre o GUID del perfil como una cadena Perfil que se abrirá en función del GUID o nombre.
suppressApplicationTitle Opcional true, false Cuando se establece en false, permite a las aplicaciones cambiar el título de la pestaña mediante el envío de mensajes de cambio de título. Cuando se establece en true, estos mensajes se suprimen. Si no se proporciona, el comportamiento se hereda de la configuración del perfil.

Cambio de nombre de ventana

Este comando se puede usar para cambiar el nombre de una ventana a una cadena específica.

Nombre del comando:renameWindow

Enlace predeterminado:

Este comando no está enlazado actualmente en la configuración predeterminada.

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

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

Parámetros

Nombre Necesidad Acepta Descripción
name Opcional String Nuevo nombre que se va a usar para esta ventana. Si se omite, este comando revertirá el nombre de la ventana a su valor original.

Apertura del cuadro de diálogo de cambio de nombre de ventana

Este comando muestra una ventana emergente que le permite editar el nombre de la ventana actual. Al borrar el campo de texto, se restablecerá el nombre de la ventana.

Nombre del comando:openWindowRenamer

Enlace predeterminado:

{ "command": "openWindowRenamer" }

Identificar ventana

Aparece una superposición en la ventana enfocada que muestra el nombre y el índice de la ventana.

Nombre del comando:identifyWindow

Enlace predeterminado:

{"command": "identifyWindow", "keys": "" },

Identificar ventanas

Aparece una superposición en todas las ventanas que muestra el nombre y el índice de cada ventana.

Nombre del comando:identifyWindows

Enlace predeterminado:

Este comando no está enlazado actualmente en la configuración predeterminada.

{"command": "identifyWindows" },


Comandos de administración de paneles

Cerrar panel

Cierra el panel activo. Si no hay ningún panel dividido, se cierra la pestaña actual. Si solo hay una pestaña abierta, se cierra la ventana.

Nombre del comando:closePane

Enlace predeterminado:

{ "command": "closePane", "keys": "ctrl+shift+w" }

Desplazar el foco del panel

El foco cambia a un panel diferente en función de la dirección. Al establecer direction en "previous", se moverá el foco al panel usado más recientemente.

Nombre del comando:moveFocus

Enlace predeterminado:

{ "command": { "action": "moveFocus", "direction": "down" }, "keys": "alt+down" },
{ "command": { "action": "moveFocus", "direction": "left" }, "keys": "alt+left" },
{ "command": { "action": "moveFocus", "direction": "right" }, "keys": "alt+right" },
{ "command": { "action": "moveFocus", "direction": "up" }, "keys": "alt+up" },
{ "command": { "action": "moveFocus", "direction": "previous" }, "keys": "ctrl+alt+left" }

Parámetros

Nombre Necesidad Acepta Descripción
direction Obligatorio "left", "right", "up", "down", "previous" Dirección en la que se moverá el foco.

Ampliar un panel

Expande el panel enfocado para rellenar todo el contenido de la ventana.

Nombre del comando:togglePaneZoom

Enlace predeterminado:

{ "command": "togglePaneZoom" }

Cambio del zoom de un panel en Terminal Windows

Cambiar el tamaño de un panel

Cambia el tamaño del panel activo.

Nombre del comando:resizePane

Enlace predeterminado:

{ "command": { "action": "resizePane", "direction": "down" }, "keys": "alt+shift+down" },
{ "command": { "action": "resizePane", "direction": "left" }, "keys": "alt+shift+left" },
{ "command": { "action": "resizePane", "direction": "right" }, "keys": "alt+shift+right" },
{ "command": { "action": "resizePane", "direction": "up" }, "keys": "alt+shift+up" }

Parámetros

Nombre Necesidad Acepta Descripción
direction Requerido "left", "right", "up", "down" Dirección en la que se cambiará el tamaño del panel.

Marcar un panel como de solo lectura

Puede marcar un panel como de solo lectura, lo que impedirá que la entrada entre en el búfer de texto. Si intenta cerrar o introducir texto en un panel de solo lectura, el terminal mostrará una advertencia emergente en su lugar.

Nombre del comando:toggleReadOnlyMode

Enlace predeterminado:

{ "command": "toggleReadOnlyMode" }

Dividir un panel

Divide el tamaño del panel activo y abre otro. Sin argumentos, abre el perfil predeterminado en el nuevo panel. Si no se especifica una acción, se usa la configuración equivalente del perfil predeterminado.

Nombre del comando:splitPane

Enlace predeterminado:

// In settings.json
{ "command": { "action": "splitPane", "split": "auto", "splitMode": "duplicate" }, "keys": "alt+shift+d" },

// In defaults.json
{ "command": { "action": "splitPane", "split": "horizontal" }, "keys": "alt+shift+-" },
{ "command": { "action": "splitPane", "split": "vertical" }, "keys": "alt+shift+plus" },
{ "command": { "action": "splitPane", "split": "up" } },
{ "command": { "action": "splitPane", "split": "right" } },
{ "command": { "action": "splitPane", "split": "down" } },
{ "command": { "action": "splitPane", "split": "left" } }

Parámetros

Nombre Necesidad Acepta Descripción
split Obligatorio "vertical", "horizontal", "auto", "up", "right", "down", "left" Cómo se dividirá el panel. "auto" dividirá en la dirección que ofrece un área expuesta mayor.
commandline Opcional Nombre del archivo ejecutable como una cadena El archivo ejecutable se ejecuta dentro del panel.
startingDirectory Opcional Ubicación de la carpeta como una cadena Directorio en el que se abrirá el panel.
elevate Opcional true, false, null Invalida la propiedad elevate del perfil. Si se omite, esta acción se comportará de acuerdo con el valor de configuración elevate del perfil. Si se establece en true o false, esta acción se comportará como si el perfil estuviese establecido con "elevate": true o "elevate": false (respectivamente).
tabTitle Opcionales Cadena Título de la pestaña cuando el nuevo panel recibe el foco.
index Opcional Entero Perfil que se abrirá en función de su posición en la lista desplegable (comenzando en 0).
profile Opcional Nombre o GUID del perfil como una cadena Perfil que se abrirá en función del GUID o nombre.
colorScheme Opcional Nombre de la combinación de colores como una cadena Esquema que se va a usar en lugar del conjunto del perfil colorScheme
suppressApplicationTitle Opcional true, false Cuando se establece en false, las aplicaciones pueden cambiar el título de la pestaña mediante el envío de mensajes de cambio de título. Cuando se establece en true, estos mensajes se suprimen. Si no se proporciona, el comportamiento se hereda de la configuración del perfil.
splitMode Opcional "duplicate" Controla cómo se divide el panel. Solo acepta "duplicate", que duplicará el perfil del panel que tiene el foco en un nuevo panel.
size Opcional Float Especifique el tamaño que debe tener el nuevo panel, como una fracción del tamaño del panel actual. 1.0 sería "todo el panel actual" y 0.0 es "Ninguno del elemento primario". Tiene como valor predeterminado 0.5.


Comandos de integración del portapapeles

Copiar

Copia en el portapapeles el contenido seleccionado en el terminal. Si no existe ninguna selección, la llave se envía directamente al terminal.

Nombre del comando:copy

Enlace predeterminado:

// In settings.json
{ "command": { "action": "copy", "singleLine": false }, "keys": "ctrl+c" },

// In defaults.json
{ "command": { "action": "copy", "singleLine": false }, "keys": "ctrl+shift+c" },
{ "command": { "action": "copy", "singleLine": false }, "keys": "ctrl+insert" },
{ "command": { "action": "copy", "singleLine": false }, "keys": "enter" }

Parámetros

Nombre Necesidad Acepta Descripción
singleLine Opcional true, false Cuando es true, el contenido se copia como una sola línea. Cuando es false, se conservan las nuevas líneas del texto seleccionado.
copyFormatting Opcionales true, false, "all", "none", "html", "rtf" Cuando es true, el color y el formato de fuente del texto seleccionado también se copian en el portapapeles. Cuando es false, solo se copia en el Portapapeles el texto sin formato. También puede especificar qué formatos desea copiar. Cuando es null, se hereda el comportamiento "copyFormatting" global.

Pegar

Inserta el contenido que se copió en el portapapeles.

Nombre del comando:paste

Enlace predeterminado:

// In settings.json
{ "command": "paste", "keys": "ctrl+v" },

// In defaults.json
{ "command": "paste", "keys": "ctrl+shift+v" },
{ "command": "paste", "keys": "shift+insert" }

Seleccionar todo

Esto selecciona todo el contenido del búfer de texto.

Nombre del comando:selectAll

Enlace predeterminado:

{ "command": "selectAll", "keys": "ctrl+shift+a" }

Modo de marcado (versión preliminar)

Esto activa el modo de marcado. El modo de marcado es un modo en el que puede usar el teclado para crear una selección en la posición del cursor en el terminal.

Nombre del comando:markMode

Enlace predeterminado:

{ "command": "markMode", "keys": "ctrl+shift+m" },

Importante

Esta característica solo está disponible en la versión preliminar de Terminal Windows.

Marcador de selección de conmutador (versión preliminar)

Al modificar una selección mediante el teclado, se mueve un extremo de la selección alrededor. Puede usar esta acción para cambiar al otro marcador de selección.

Nombre del comando:switchSelectionEndpoint

Enlace predeterminado:

{ "command": "switchSelectionEndpoint" },

Importante

Esta característica solo está disponible en la versión preliminar de Terminal Windows.

Alternar modo de selección de bloque (versión preliminar)

Hace que la selección existente sea una selección de bloque, lo que significa que el área seleccionada es un rectángulo, en lugar de encapsular hasta el principio y el final de cada línea.

Nombre del comando:toggleBlockSelection

Enlace predeterminado:

{ "command": "toggleBlockSelection" },

Importante

Esta característica solo está disponible en la versión preliminar de Terminal Windows.



Comandos de desplazamiento

Desplazar hacia arriba

Desplaza la pantalla hacia arriba por el número de filas definidas por "rowsToScroll". Si no se proporciona "rowsToScroll", se desplazará hacia arriba la cantidad definida por el valor predeterminado del sistema, que es la misma cantidad que el desplazamiento del mouse.

Nombre del comando:scrollUp

Enlace predeterminado:

{ "command": "scrollUp", "keys": "ctrl+shift+up" }

Parámetros

Nombre Necesidad Acepta Descripción
rowsToScroll Opcional Entero Número de filas que se va a desplazar.

Desplazarse hacia abajo

Desplaza la pantalla hacia abajo por el número de filas definidas por "rowsToScroll". Si no se proporciona "rowsToScroll", se desplazará hacia abajo la cantidad definida por el valor predeterminado del sistema, que es la misma cantidad que el desplazamiento del mouse.

Nombre del comando:scrollDown

Enlace predeterminado:

{ "command": "scrollDown", "keys": "ctrl+shift+down" }

Parámetros

Nombre Necesidad Acepta Descripción
rowsToScroll Opcional Entero Número de filas que se va a desplazar.

Desplazar una página hacia arriba

Desplaza una página completa hacia arriba, que es el alto de la ventana.

Nombre del comando:scrollUpPage

Enlace predeterminado:

{ "command": "scrollUpPage", "keys": "ctrl+shift+pgup" }

Desplazar una página hacia abajo

Desplaza una página completa hacia abajo, que es el alto de la ventana.

Nombre del comando:scrollDownPage

Enlace predeterminado:

{ "command": "scrollDownPage", "keys": "ctrl+shift+pgdn" }

Desplazarse hasta el historial más antiguo

Desplaza la pantalla hasta la parte superior del búfer de entrada.

Nombre del comando:scrollToTop

Enlace predeterminado:

{ "command": "scrollToTop", "keys": "ctrl+shift+home" }

Desplazarse hasta el historial más reciente

Desplaza la pantalla hacia abajo hasta la parte inferior del búfer de entrada.

Nombre del comando:scrollToBottom

Enlace predeterminado:

{ "command": "scrollToBottom", "keys": "ctrl+shift+end" }

Borrado del búfer

Esta acción se puede usar para borrar manualmente el búfer del terminal. Resulta útil para escenarios en los que no se encuentra ante un símbolo del sistema del shell de línea de comandos y no puede ejecutar fácilmente Clear-Host/cls/clear.

Nombre del comando:clearBuffer

Enlace predeterminado:

{ "command": { "action": "clearBuffer", "clear": "all" } }

Parámetros

Nombre Necesidad Acepta Descripción
clear Opcional "screen", "scrollback", "all" Qué parte de la pantalla se va a borrar.
  • "screen": borra el contenido de la ventanilla del terminal. Deja el desplazamiento hacia atrás intacto. Mueve la fila del cursor a la parte superior de la ventanilla (sin modificar).
  • "scrollback": borra el desplazamiento hacia atrás. Deja la ventanilla intacta.
  • "all" (valor predeterminado): borra el desplazamiento hacia atrás y la ventanilla visible. Mueve la fila del cursor a la parte superior de la ventanilla.

Comandos de ajuste visual

Ajustar tamaño de fuente

Cambia el tamaño del texto en una cantidad de puntos especificada.

Nombre del comando:adjustFontSize

Enlace predeterminado:

{ "command": { "action": "adjustFontSize", "delta": 1 }, "keys": "ctrl+=" },
{ "command": { "action": "adjustFontSize", "delta": -1 }, "keys": "ctrl+-" },
{ "command": { "action": "adjustFontSize", "delta": 1 }, "keys": "ctrl+numpad_plus" },
{ "command": { "action": "adjustFontSize", "delta": -1 }, "keys": "ctrl+numpad_minus" }

Parámetros

Nombre Necesidad Acepta Descripción
delta Requerido Entero Cantidad de cambio del tamaño en cada invocación del comando.

Restablecer tamaño de fuente

Restablece el tamaño del texto al valor predeterminado.

Nombre del comando:resetFontSize

Enlace predeterminado:

{ "command": "resetFontSize", "keys": "ctrl+0" },
{ "command": "resetFontSize", "keys": "ctrl+numpad_0" }

Ajuste de la opacidad

Esta opción cambia la opacidad de la ventana. Si relative se establece en true, ajustará la opacidad con respecto a la opacidad actual. De lo contrario, establecerá la opacidad directamente en el valor de opacity proporcionado.

Nombre del comando:adjustOpacity

Enlace predeterminado:

{ "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": 100 } }

Parámetros

Nombre Necesidad Acepta Descripción
opacity Opcional Entero Opacidad que debería tener el terminal o cambio de opacidad que debería aplicarse, en función del valor de relative.
relative Opcionales Boolean Si es true, ajuste la opacidad actual mediante el parámetro opacity especificado. Si es false, establezca la opacidad exactamente en ese valor.

Alternar los efectos del sombreador de píxeles

Esto alterna los efectos de sombreador de píxeles habilitados en el terminal. Si el usuario especificó un sombreador válido con experimental.pixelShaderPath, esta acción activará o desactivará ese sombreador. También alternará el "efecto de terminal retro", que está habilitado con la configuración de perfil experimental.retroTerminalEffect.

Nombre del comando:toggleShaderEffects

Enlace predeterminado:

{ "command": "toggleShaderEffects" }

Precaución

La acción toggleRetroEffect ya no está disponible en las versiones 1.6 y posteriores. Por este motivo se recomienda usar toggleShaderEffects en su lugar.

Establecer la combinación de colores

Cambia la combinación de colores activa.

Nombre del comando:setColorScheme

Parámetros

Nombre Necesidad Acepta Descripción
colorScheme Requerido String name de la combinación de colores que se va a aplicar.

Enlace de ejemplo:

{ "command": { "action": "setColorScheme", "colorScheme": "Campbell" }, "keys": "" }

Marca de desplazamiento para agregar experimental (versión preliminar)

Añade una marca de desplazamiento al búfer de texto. Si hay una selección, la marca se coloca en la selección; de lo contrario, se coloca en la fila del cursor. Es una característica experimental y no se garantiza su continuidad.

Nombre del comando:addMark

Parámetros

Nombre Necesidad Acepta Descripción
color Opcional Cadena en formato hexadecimal: "#rgb" o "#rrggbb" Color de la marca.

Enlace de ejemplo:

{ "command": { "action": "addMark", "color": "#ff00ff" } }

Importante

Esta característica solo está disponible en la versión preliminar de Terminal Windows.

Desplazamiento experimental de marcado (versión preliminar)

Se desplaza hasta la marca de desplazamiento en la dirección especificada. Es una característica experimental y no se garantiza su continuidad.

Nombre del comando:scrollToMark

Parámetros

Nombre Necesidad Acepta Descripción
direction Requerido "first", "previous", "next", "last" Dirección en la que se va a desplazar.

Enlace de ejemplo:

{ "command": { "action": "scrollToMark", "direction": "previous" } }

Importante

Esta característica solo está disponible en la versión preliminar de Terminal Windows.

Borrado de marcado experimental (versión preliminar)

Borra la marca de desplazamiento en la posición actual, ya sea en una selección si hay una o en la posición del cursor. Es una característica experimental y no se garantiza su continuidad.

Nombre del comando:clearMark

Enlace de ejemplo:

{ "command": { "action": "clearMark" } }

Importante

Esta característica solo está disponible en la versión preliminar de Terminal Windows.

Borrado de todo el marcado experimental (versión preliminar)

Borra todas las marcas de desplazamiento del búfer de texto. Es una característica experimental y no se garantiza su continuidad.

Nombre del comando:clearAllMarks

Enlace de ejemplo:

{ "command": { "action": "clearAllMarks" } }

Importante

Esta característica solo está disponible en la versión preliminar de Terminal Windows.



Exportación del búfer

Exportación del búfer

Esta opción permite al usuario exportar el texto del búfer a un archivo. Si el archivo no existe, se creará. Si el archivo ya existe, su contenido se reemplazará por el texto del búfer del terminal.

Nombre del comando:exportBuffer

Enlace predeterminado:

{ "command": { "action": "exportBuffer" } }

Parámetros

Nombre Necesidad Acepta Descripción
path Opcional String Si se proporciona, el terminal exportará el contenido del búfer al archivo proporcionado. De lo contrario, el terminal abrirá un selector de archivos para elegir el archivo de destino de la exportación.

Comandos globales

Invocación global

Se trata de una acción especial que funciona globalmente en el sistema operativo, en lugar de solo en el contexto de la ventana del terminal. Cuando se presiona, esta acción invoca la ventana del terminal. Las propiedades de esta acción controlan qué ventana se invoca, dónde se invoca y cómo se comporta cuando se invoca.

Notas

  • Las claves enlazadas a acciones globalSummon en el terminal no funcionarán en otras aplicaciones mientras se ejecuta el terminal; siempre centrarán la ventana del terminal.

  • Si otra aplicación en ejecución ya está registrada para el valor keys determinado mediante la API RegisterHotKey, el terminal no podrá escuchar esos trazos clave.

  • Las instancias con privilegios elevados y privilegios reducidos del terminal no podrán registrarse para las mismas claves. Lo mismo se aplica a las versiones preliminar y estable del terminal; la primera que se inicia siempre gana.

  • Estos trazos clave solo funcionarán cuando ya se esté ejecutando una instancia del terminal. Para iniciar el terminal automáticamente al iniciar sesión, vea startOnUserLogin.

Nombre del comando:globalSummon

Enlace predeterminado:

Este comando no está enlazado actualmente en la configuración predeterminada.

{ "keys": "", "command": { "action": "globalSummon" } }

Parámetros

Nombre Necesidad Acepta Descripción
desktop Opcional any, toCurrent, onCurrent Controla cómo debe interactuar el terminal con los escritorios virtuales.
  • "any": deje la ventana en el escritorio que ya esté activado; cambiará a ese escritorio a medida que se active la ventana.
  • "toCurrent" (valor predeterminado): mueve la ventana al escritorio virtual actual.
  • "onCurrent": solo puede invocar la ventana si ya está en el escritorio virtual actual.
monitor Opcional any, toCurrent, toMouse Controla el monitor desde y hacia el que se va a invocar la ventana.
  • "any": se invoca la ventana usada más recientemente, independientemente del monitor en el que se encuentra actualmente.
  • "toCurrent": se invoca la ventana usada más recientemente en el monitor con la ventana de primer plano actual.
  • "toMouse" (valor predeterminado): se invoca la ventana usada más recientemente en el monitor donde está el cursor del mouse.
name Opcionales String Cuando se omite(valor predeterminado), use monitor y desktop para buscar la ventana usada más recientemente adecuada para invocar. Cuando se proporciona, invoque la ventana cuyo nombre o identificador coincida con el valor name especificado. Si no existe dicha ventana, cree una nueva ventana con ese nombre.
dropdownDuration Opcional Entero Tiene como valor predeterminado 0. Cuando se le proporciona un número positivo, "deslice" la ventana desde la parte superior de la pantalla mediante una animación que dure dropdownDuration milisegundos. 200 es un valor razonable para esta configuración.
toggleVisibility Opcional true, false Tiene como valor predeterminado true. Cuando es true, al presionar las teclas asignadas para esta acción, se descartará (minimizará) la ventana cuando sea la ventana en primer plano actualmente. Cuando es false, al presionar las teclas asignadas solo se pondrá la ventana en primer plano.

Cuando se proporciona nameconmonitor o desktop, name se comporta de las maneras siguientes:

  • desktop
    • "any": vaya al escritorio en el que la ventana dada ya está activa.
    • "toCurrent": si la ventana está en otro escritorio virtual, muévala al que está activo actualmente.
    • "onCurrent": si la ventana está en otro escritorio virtual, muévala al que está activo actualmente.
  • monitor
    • "any": deje la ventana en el monitor en el que ya está.
    • "toCurrent": si la ventana está en otro monitor, muévela al monitor con la ventana de primer plano actual.
    • "toMouse": si la ventana está en otro monitor, muévela al monitor que tiene el cursor del mouse.

Las propiedades desktop y monitor se pueden combinar de las maneras siguientes:

Combinaciones "desktop": "any" "desktop": "toCurrent" "desktop": "onCurrent" No incluido
"monitor": "any" Vaya al escritorio en el que se encuentra la ventana (deje la posición sola). Mueva la ventana a este escritorio (deje la posición sola). Si no hay ninguna en este escritorio:
  • Cree una nueva en la posición predeterminada.
O bien:
  • Active la de este escritorio (no la mueva).
Invocación de la ventana de MRU
"monitor": "toCurrent" Vaya al escritorio en el que se encuentra la ventana y muévala al monitor con la ventana de primer plano. Mueva la ventana a este escritorio y muévala al monitor con la ventana de primer plano. Si no hay ninguna en este escritorio:
  • Cree una nueva.
O bien:
  • Active la que se encuentra en este escritorio y muévala al monitor con la ventana de primer plano.
Invocación de la ventana de MRU al monitor con la ventana de primer plano
"monitor": "toMouse" Vaya al escritorio en el que se encuentra la ventana y muévala al monitor con el mouse. Mueva la ventana a este escritorio y muévala al monitor con el mouse. Si no hay ninguna en este escritorio:
  • Cree una nueva.
O bien:
  • Active la que se encuentra en este escritorio y muévala al monitor con el mouse.
Invocación de la ventana de MRU al monitor con el mouse
No se incluye Déjelo donde está. Muévalo al escritorio actual. Solo en el escritorio actual N/D

Ejemplos


// 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.
{ "keys": "ctrl+1", "command": { "action": "globalSummon" } },

// 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.
{ "keys": "ctrl+2", "command": { "action": "globalSummon", "desktop": "any" } },

// Summon the MRU window to the current desktop, leaving the position of the window untouched.
{ "keys": "ctrl+3", "command": { "action": "globalSummon", "monitor": "any" } },

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

// Summon the MRU window with a dropdown duration of 200ms.
{ "keys": "ctrl+5", "command": { "action": "globalSummon", "dropdownDuration": 200 } },

// Summon the MRU window. If the window is already in the foreground, do nothing.
{ "keys": "ctrl+6", "command": { "action": "globalSummon", "toggleVisibility": false } },

// Summon the window named "_quake". If no window with that name exists, then create a new window.
{ "keys": "ctrl+7", "command": { "action": "globalSummon", "name": "_quake" } }

Abrir la ventana del modo de seísmo

Esta acción es una variación especial de la acción globalSummon. Concretamente, invoca la ventana del modo de seísmo. Es una abreviatura de la acción globalSummon siguiente:

{
"keys": "win+`",
"command": {
"action": "globalSummon",
"name": "_quake",
"dropdownDuration": 200,
"toggleVisibility": true,
"monitor": "toMouse",
"desktop": "toCurrent"
}
}

Si desea cambiar el comportamiento de la acción quakeMode, se recomienda crear una nueva entrada globalSummon en actions con la configuración que prefiera.

Nombre del comando:quakeMode

Enlace predeterminado:

{ "keys": "win+`", "command": { "action": "quakeMode" } }

Modo de seísmo de Terminal Windows



Ejecución de varias acciones

Esta acción permite al usuario enlazar varias acciones secuenciales a un comando.

Nombre del comando:multipleActions

Parámetros

Nombre Necesidad Acepta Descripción
actions Obligatorio Matriz de acciones Lista de la action que se ejecutará.

Ejemplo

{ "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"
        ]
}}


Desenlace de claves (deshabilitar los enlaces de teclado)

Puede deshabilitar los enlace de teclado o "desenlazar" las claves asociadas desde cualquier comando. Esto puede ser necesario cuando se usan aplicaciones terminales subyacentes (como VIM). La clave sin enlazar pasará al terminal subyacente.

Nombre del comando:unbound

Ejemplo con unbound:

Por ejemplo, para desenlazar las teclas de método abreviado Alt+Mayús+-" y Alt+Mayús+=", incluya estos comandos en la sección actions del archivo settings.json.

{
    "actions": [
        { "command": "unbound", "keys": "alt+shift+-" },
        { "command": "unbound", "keys": "alt+shift+=" }
    ]
}

Ejemplo con NULL:

También puede desenlazar una pulsación de tecla enlazada de manera predeterminada a una acción estableciendo "command" en null. Esto también permitirá que la pulsación de tecla se asocie a la configuración de la aplicación de línea de comandos en lugar de realizar la acción predeterminada.

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

Escenario de caso de uso:

Terminal Windows usa el enlace de teclas de método abreviado Ctrl+V como comando pegar. Al trabajar con una línea de comandos de WSL, puede que desee usar una aplicación Linux como Vim para editar archivos. Sin embargo, Vim se basa en el enlace de teclas Ctrl+v para usar el modo visual en bloque. Este enlace de claves se bloqueará, teniendo prioridad el comando paste de Terminal Windows, a menos que la configuración unbound se ajuste en el archivo settings.json para que el enlace de claves se asocie a la aplicación de línea de comandos de Vim, en lugar de al enlace de Terminal Windows.