O editor

Atalhos de teclado

Todas as teclas que o editor escuta, e a única regra sobre quando ele não escuta.

A regra

Um atalho nunca dispara enquanto você está digitando. Se o foco está no editor de código, na entrada serial, no título do projeto ou em qualquer outro campo, a tecla pertence a esse campo. Nenhuma das teclas do canvas precisa da tecla Alt, e qualquer tecla pressionada com Alt é ignorada lá.

Os atalhos de tecla única (letras, dígitos e as teclas de + e - abaixo) podem ser desligados, ou configurados para exigir Alt+Shift com cada uma delas, pelo bloco Teclas do menu do canvas. Cada aperto avança um passo, depois Alt+Shift, depois desliga. Fica guardado neste navegador junto com a grade e o tema. Ctrl/Cmd abaixo podem ser desligados, ou configurados para exigir Delete, Escape e as teclas em Trabalhando sem mouse não são afetadas, porque só funcionam quando o próprio canvas está em foco. O editor de código tem teclas próprias, em a última tabela.

Num Mac o modificador é ⌘; em qualquer outro lugar é Ctrl. O editor detecta qual é e avisa nos próprios menus.

O documento

Tecla O que faz
Ctrl/Cmd+S Salvar
Ctrl/Cmd+Shift+H Histórico: as versões salvas anteriores deste projeto
Ctrl/Cmd+Z Desfazer
Ctrl/Cmd+Shift+Z ou Ctrl/Cmd+Y Refazer
Ctrl/Cmd+A Selecionar tudo
Ctrl/Cmd+C Copiar a seleção
Ctrl/Cmd+X Recortar a seleção
Ctrl/Cmd+V Colar
Ctrl/Cmd+D Duplicar a seleção
Ctrl/Cmd+\ Ocultar ou mostrar o painel de código, quando o canvas e o código ficam lado a lado

O Ctrl/Cmd+S é capturado antes de qualquer outra coisa, não importa onde esteja o foco, então o navegador nunca oferece salvar a página no lugar.

O Ctrl/Cmd+C e o Ctrl/Cmd+X cedem lugar quando há texto selecionado na página fora de um controle: essa é a cópia do próprio navegador, que é como você tira uma linha do log serial.

O canvas

Tecla O que faz
A Abrir o painel de componentes
R Girar 90 graus os componentes selecionados
Delete ou Backspace Apagar a seleção
D Abrir ou fechar as ferramentas de desenho
T Organizar fios: reorganizar a seleção, ou todos os fios
L Abrir ou fechar o painel de camadas
Shift+L Mostrar níveis: o nível e a tensão ao vivo em cada nó
Shift+O Calcular o ponto de operação DC; aperte de novo para guardar
C Adicionar um comentário onde está o ponteiro
Enter ou F2 Renomear o quadro selecionado, ou editar a nota selecionada
F Ajustar o circuito inteiro à tela
+ ou = Aumentar o zoom
- ou _ Diminuir o zoom
Espaço (segurado) Mover a visão ao arrastar
Alt (Option) ao arrastar uma protoboard Move só a placa, deixando no lugar os componentes encaixados nela
Escape Abandonar o fio sendo desenhado, ou limpar a seleção

Escape faz primeiro a coisa mais próxima: larga a ferramenta de desenho, fecha uma nota ou quadro em que você está digitando, fecha um comentário aberto, descarta um fio desenhado pela metade e só então limpa a seleção. Ele também fecha o painel de componentes, o menu do canvas, as amostras de cores e o painel de compartilhamento.

Com uma nota adesiva selecionada e mais nada, digitar uma letra abre a nota e digita essa letra nela. C, R e as outras letras viram texto, não atalhos.

Enquanto o circuito roda

Tecla ou clique O que faz
Uma tecla que você vinculou a um botão Mantém o botão pressionado enquanto a tecla estiver pressionada. Várias teclas ao mesmo tempo funcionam
Shift e um clique em um botão Mantém o botão pressionado até você clicar com Shift de novo

Vincule teclas a um botão de pressão ou qualquer outro componente que você pressiona com o ponteiro: selecione-o e, nas propriedades dele, em Teclas do teclado, aperte Definir tecla, depois a tecla, ou escolha uma em Escolha rápida. As teclas ficam salvas com o componente, então acompanham o projeto. Uma tecla digitada no editor de código ou em um campo nunca pressiona um componente.

Trabalhando sem mouse

O canvas é uma parada na ordem do Tab. Vá até ele com Tab e essas teclas funcionam enquanto ele estiver em foco. Cada ação é lida por leitores de tela.

Tecla O que faz
Tab / Shift+Tab Seleciona o próximo componente ou o anterior. Passando do último componente, o Tab sai do canvas
Setas Move o componente selecionado um passo da grade; com Shift, cinco passos. Uma protoboard leva junto os componentes encaixados nela. Com nada selecionado, seleciona o primeiro componente
R Gira o componente selecionado
Enter ou W Liga um fio: escolha um dos pinos do componente, digite para encontrar o pino de destino e aperte Enter
P Vai para as propriedades do componente selecionado. Shift+Tab de lá volta ao canvas
Delete ou Backspace Exclui o componente selecionado
V Abre o circuito como texto
Espaço ou Enter (rodando) Pressiona um botão, ou alterna uma chave, no componente selecionado
Setas, Page Up, Page Down, Home, End (rodando) Gira o potenciômetro ou o slider selecionado

Um fio feito assim é roteado como um desenhado à mão e é um passo de Desfazer. O diálogo de fios também lista os fios já existentes no componente, cada um com um botão Excluir.

Circuito como texto (o menu do canvas, V, ou o link oculto no topo do canvas que aparece quando você vai até ele com Tab) lista cada componente em uma tabela, com seu tipo, suas configurações e, enquanto o circuito roda, o que ele está fazendo: um LED aceso ou apagado e seu brilho, o ângulo de um servo, um dígito de sete segmentos, a leitura de um medidor. Abaixo, cada conexão aparece como "componente.pino para componente.pino". Cada componente se seleciona no canvas, e cada fio pode ser excluído da lista. Enquanto o circuito roda, as mudanças são anunciadas no máximo uma vez a cada dois segundos; uma caixa de seleção desativa isso.

O painel de componentes

As setas movem pelos itens, Enter coloca o componente destacado e Escape fecha o painel. O painel captura as próprias teclas, então um A digitado dentro do campo de busca é uma letra, não uma segunda tentativa de abri-lo.

O editor de código

Com o cursor no código, estas são as teclas. Elas seguem o Sublime Text e, onde o CodeMirror, o editor por baixo, tem sua própria grafia, as duas funcionam. Onde o Arduino IDE tem uma tecla própria, a do Arduino IDE vence. Onde uma tecla de Mac difere, ela está entre colchetes.

As teclas do Arduino IDE

Tecla O que faz
Ctrl/Cmd+Enter Rodar, ou Parar enquanto roda: o mesmo que apertar o botão Rodar
Ctrl/Cmd+T ou Ctrl/Cmd+Shift+F Auto Format: reindenta o arquivo aberto, dois espaços por nível

A Auto Formatação indenta cada linha conforme sua profundidade em chaves e colchetes, alinha cada chave de fechamento com a linha que a abriu, indenta uma instrução solta sob um if ou um else, indenta rótulos case dentro de um switch, e coloca um espaço depois de if, for, while e switch. Ela mantém as linhas em branco e nunca move uma chave para outra linha. Strings, comentários e linhas com # mantêm o texto exatamente como está. É uma única edição, então um único Ctrl/Cmd+Z desfaz tudo.

Em uma janela comum do navegador, Ctrl/Cmd+T abre uma nova aba e a página nunca vê a tecla: Chrome, Edge e Firefox a reservam para si. Use Ctrl/Cmd+Shift+F, que funciona em todo lugar. Ctrl/Cmd+T chega ao editor quando o Mokxi está instalado como app e roda em janela própria.

Ctrl+R, o Verify do Arduino IDE, é deixado de lado: em um navegador ele recarrega a página. Rodar compila o código primeiro de qualquer jeito.

Autocompletar

Tecla O que faz
Ctrl+Space Mostra as sugestões para a palavra no cursor
Enter ou Tab Aceita a sugestão destacada
Up, Down, Page Up, Page Down Percorre a lista
Escape Fecha a lista
Tab, Shift+Tab Em um snippet, o próximo espaço em branco ou o anterior a preencher

Cursores e seleção

Tecla O que faz
Ctrl/Cmd+D Selecione a palavra e adicione a próxima ocorrência; continue apertando para mais
Alt+F3 (Ctrl+Cmd+G) ou Ctrl/Cmd+Shift+L Selecionar todas as ocorrências da seleção
Ctrl/Cmd+Shift+L com uma seleção de várias linhas Um cursor no fim de cada linha
Alt e um clique Adicionar um cursor ali
Alt e um arrastar Selecionar uma coluna, um retângulo ao longo das linhas
Ctrl/Cmd e um clique Adicionar um cursor ali
Ctrl/Cmd+Alt+Up ou Down Adicionar um cursor na linha de cima ou de baixo
Escape Voltar a um único cursor
Ctrl/Cmd+L Selecionar a linha; de novo para a próxima
Ctrl/Cmd+I Expandir a seleção para o bloco que a contém
Ctrl/Cmd+U Desfazer a última mudança de seleção

Buscar

Tecla O que faz
Ctrl/Cmd+F Buscar, com diferenciar maiúsculas, expressão regular e palavra inteira
Ctrl+H (Cmd+Alt+F) Buscar e substituir
F3, Shift+F3 Próxima ocorrência, ocorrência anterior (Cmd+G, Shift+Cmd+G no Mac também)
Ctrl+G ou Ctrl/Cmd+Alt+G Ir para uma linha
Ctrl/Cmd+Shift+\ Pular para o parênteses ou colchete correspondente

Linhas

Tecla O que faz
Ctrl/Cmd+/ Comentar ou descomentar as linhas
Shift+Alt+A (Shift+Ctrl+A) Comentar ou descomentar a seleção como um bloco
Ctrl/Cmd+Shift+D Duplicar a linha
Shift+Alt+Up ou Down Copiar a linha para cima ou para baixo
Alt+Up ou Down, ou Ctrl+Shift+Up ou Down (Ctrl+Cmd+Up ou Down) Mover a linha para cima ou para baixo
Ctrl/Cmd+Shift+K Apagar a linha
Ctrl/Cmd+Shift+Enter Uma nova linha acima
Tab, Shift+Tab Aumentar ou diminuir o recuo
Ctrl/Cmd+], Ctrl/Cmd+[ Aumentar ou diminuir o recuo
Ctrl/Cmd+Alt+\ Aumentar o recuo da seleção de novo, do jeito que o código pede
Enter Uma nova linha, com recuo, sem deixar espaços sobrando no fim

Dobramento, erros e a visualização

Tecla O que faz
Ctrl+Shift+[, Ctrl+Shift+] (Cmd+Alt+[, Cmd+Alt+]) Dobrar, desdobrar o bloco
Ctrl+Alt+[, Ctrl+Alt+] Dobrar tudo, desdobrar tudo
F8 Ir para o próximo erro ou aviso de compilação
Ctrl/Cmd+Shift+M A lista de erros e avisos de compilação
Alt+Z Quebrar linhas longas, ou mantê-las inteiras; a escolha é lembrada
Ctrl/Cmd+Z, Ctrl/Cmd+Shift+Z ou Ctrl+Y Desfazer, refazer
Ctrl/Cmd+S Salva o projeto, igual a qualquer outro lugar no editor

Tab cria recuo, então não tira você do código. Aperte Escape e depois Tab para sair dele com o teclado, ou Ctrl+M (Shift+Alt+M) para fazer com que Tab mova o foco até você apertar de novo.

No diagram.json, Ctrl/Cmd+Enter aplica o diagrama editado em vez disso.

Onde mais procurar

Todo botão na barra de ferramentas do canvas mostra o atalho na sua dica, porque os botões e o teclado leem a mesma tabela. Os blocos do menu "mais" trazem só uma palavra, então, para tudo que está lá, esta página é a lista.

Rodar, Parar e Salvar têm botões em vez de simples teclas, porque são as três coisas que você mais aperta, e um botão é mais fácil de achar do que depender da memória. Com o cursor no código, Ctrl/Cmd+Enter aperta Rodar (ou Parar) para você, como na IDE do Arduino, e a dica do botão Rodar diz isso.