1001Ferramentas
💎 Dev

Gerador de Snippet Sublime Text

Cria arquivo .sublime-snippet em formato XML com trigger, scope e conteúdo. Cole em Packages/User/ no Sublime.

Snippet do Sublime Text, no XML que ele espera

Snippet no Sublime é um arquivo XML com quatro partes: o conteúdo que será inserido, o gatilho digitado antes do Tab, o escopo em que o snippet fica disponível e a descrição que aparece no menu. O formato é simples, mas tem armadilhas de escape que produzem arquivo que o editor simplesmente ignora, sem mensagem de erro.

Preencha os campos e a página monta o XML. O conteúdo vai dentro de uma seção CDATA, que é o que permite escrever código com sinais de menor e maior sem escapar nada — e a página trata o único caso que ainda quebra ali, que é o conteúdo contendo a própria sequência de fechamento da seção. Os demais campos são escapados normalmente.

No conteúdo valem os marcadores de posição do editor: cifrão seguido de número marca as paradas do cursor na ordem, e a forma com chaves permite texto padrão em cada parada. O cifrão zero marca onde o cursor termina. O escopo é o que evita poluição: um snippet de JavaScript declarado sem escopo passa a aparecer em arquivo de texto, de configuração e de Markdown.

Perguntas frequentes

Onde salvo o arquivo?
Na pasta de pacotes do usuário, com extensão sublime-snippet. Qualquer nome serve — o que identifica o snippet é o gatilho, não o nome do arquivo. O editor recarrega sozinho ao salvar, sem precisar reiniciar.
Como descubro o escopo correto?
Com o comando que mostra o escopo sob o cursor, disponível pela paleta. Ele exibe a cadeia completa, e você escolhe o nível de especificidade — source.js pega JavaScript inteiro, enquanto níveis mais profundos restringem a contextos como dentro de string ou de comentário.
Por que meu snippet não dispara?
Quase sempre escopo errado ou gatilho em conflito com outro snippet. Vale também conferir o XML: se ele estiver malformado, o Sublime ignora o arquivo em silêncio, sem avisar — motivo pelo qual o escape correto importa mais aqui do que em formatos que reclamam.

Ferramentas Relacionadas