Atalhos de teclado e paleta de comandos
O Aseptic usa-se por inteiro com o rato sem faltar nada. Mas o que se faz vinte vezes por dia —mudar de secção, saltar para um cenário, arrancá-lo, abrir os logs— faz-se mais depressa com uma tecla. Esta é a lista completa.
A paleta de comandos
Ctrl + K abre a paleta: um campo de texto e uma lista que se filtra à medida que se escreve. As setas movem a seleção, Enter executa e Esc fecha. Lá dentro há três tipos de coisas, agrupadas:
- Secções e painéis. As secções da barra esquerda —Cenários, Serviços, Bibliotecas e Mocks—, os painéis de apoio da direita —Notificações, Docker, Bases de dados, Verificação e o copiloto— e as Definições.
- Cenários. Cada cenário do projeto pelo seu nome. Escolher um seleciona-o e abre a sua secção.
- Ações. As que fazem sentido neste momento: arrancar aparece com um cenário parado selecionado, parar só se estiver a correr, limpar só se não estiver. Ao lado, as que valem sempre: alternar o painel inferior, abrir os logs em ecrã inteiro ou ver esta mesma lista.
É essa última parte que a separa de um menu. Um menu mostra tudo o que a aplicação sabe fazer e atenua o que agora não se aplica; a paleta lista o que se pode executar no estado em que a janela está. Por isso funciona escrevendo o que se quer —«arr», «logs», o nome do cenário— em vez de recordando onde estava.
Os atalhos
São 12, repartidos por 4 grupos. Ctrl é ⌘ no macOS, e a aplicação deteta-o sozinha: a referência mostra a tecla da plataforma em que está. Ctrl + 1 a 4 levam, por essa ordem, a Cenários, Serviços, Mocks e ao painel do Docker.
Navegação
| Atalho | Ação |
|---|---|
| Ctrl/⌘ K | Abrir a paleta de comandos |
| Ctrl/⌘ F | Procurar na barra lateral da secção ativa |
| Ctrl/⌘ 1–4 | Mudar de secção |
| Ctrl/⌘ J | Mostrar ou ocultar o painel inferior |
| ↑↓ | Mover a seleção na lista lateral |
| Enter | Abrir ou editar o elemento selecionado |
Ações
| Atalho | Ação |
|---|---|
| Ctrl/⌘ N | Criar o elemento da secção ativa (cenário · serviço · stub) |
| Ctrl/⌘ Enter | Iniciar ou parar o cenário selecionado |
| Ctrl/⌘ E | Exportar o cenário selecionado |
| Esc | Fechar o editor ou a caixa de diálogo aberta |
Vista
| Atalho | Ação |
|---|---|
| Ctrl/⌘ +−0 | Ampliar · reduzir · repor o zoom |
Ajuda
| Atalho | Ação |
|---|---|
| ? | Mostrar esta referência de atalhos |
Porque são poucos
12 combinações cabem na cabeça; quarenta consultam-se, e consultar uma lista de atalhos é exatamente o que um atalho vinha evitar. A lista mantém-se curta de propósito: uma tecla ganha-se quando a ação se repete muitas vezes por dia. Todo o resto vive na paleta, que não é preciso memorizar porque se procura escrevendo.
As teclas sem modificador —Enter, Esc, as setas, ?— não roubam a escrita: dentro de um campo de texto comportam-se como em qualquer campo de texto. A única exceção é Enter a partir da lupa da barra lateral, que abre o elemento selecionado na lista ao lado.
E o que está à frente manda sobre o que está atrás: com a paleta, uma caixa de diálogo ou a própria referência abertas, Esc fecha essa superfície e os restantes atalhos não chegam à janela. Sem essa regra, fechar um menu pendente fechava também o editor por baixo.
A mesma lista, dentro da aplicação
A referência abre-se com ? a qualquer momento, e está também em Definições → Atalhos de teclado. O guia documenta-a em Atalhos de teclado.
Se algum dia esta página e a aplicação não coincidirem, quem está errada é esta página: a tabela acima não se escreve, gera-se ao publicar o site a partir do mesmo registo de atalhos que despacha as teclas na aplicação. Um atalho que mude na aplicação muda aqui, e nos seis idiomas, sem que ninguém se tenha de lembrar.
Perguntas frequentes
Os atalhos podem ser alterados?
Hoje não: não há editor de combinações. Enquanto forem 12 e não colidirem entre si, reatribuir teclas resolve um problema que ainda não existe.
Funcionam igual no macOS?
Sim. O modificador é ⌘ em vez de Ctrl e a aplicação deteta-o sozinha, por isso a referência e os menus mostram a tecla da plataforma em que se está.
O que acontece se carregar em Ctrl+Enter sem um cenário selecionado?
Nada. Um atalho resolve sempre para a mesma ação, mas a ação verifica o seu estado antes de executar: arrancar precisa de um cenário escolhido e sem o editor aberto, tal como o botão da barra superior. A tecla não põe em fila um arranque pela metade.
Há atalhos para a CLI?
A CLI aseptic não tem atalhos: tem comandos. O que faz a
aplicação e o que faz a CLI saem do mesmo registo de operações, por isso quase tudo
o que aqui se lança com uma tecla tem lá o seu comando.