Ambiente do Editor de Código de Scripts do Office

  • Artigo

Os Scripts do Office são escritos em TypeScript ou JavaScript e usam as APIs JavaScript de Scripts do Office para interagir com uma pasta de trabalho do Excel. O Editor de Código é baseado em Visual Studio Code, portanto, se você já usou esse ambiente antes, você se sentirá em casa.

Linguagem de script: TypeScript ou JavaScript

Os Scripts do Office são escritos em TypeScript, que é um superconjunto de JavaScript. O Gravador de Ações gera código no TypeScript e a documentação do Office Scripts usa TypeScript. Como TypeScript é um superconjunto de JavaScript, qualquer código de script que você escrever no JavaScript funcionará muito bem.

Os Scripts do Office são em grande parte peças de código independentes. Apenas uma pequena parte da funcionalidade do TypeScript é usada. Portanto, você pode editar scripts sem precisar aprender os meandros do TypeScript. O Editor de Código também manipula a instalação, a compilação e a execução do código, portanto, você não precisa se preocupar com nada além do script em si. É possível aprender o idioma e criar scripts sem conhecimento de programação anterior. No entanto, se você for novo na programação, recomendamos aprender alguns fundamentos antes de prosseguir com scripts do Office.

Office Scripts JavaScript API

Os Scripts do Office usam uma versão especializada das APIs JavaScript do Office para Suplementos do Office. Embora haja semelhanças nas duas APIs, você não deve supor que o código possa ser portado entre as duas plataformas. As diferenças entre as duas plataformas são descritas no artigo Diferenças entre Scripts do Office e Suplementos do Office . Você pode exibir todas as APIs disponíveis para o script na documentação de referência da API de Scripts do Office.

Suporte à biblioteca externa

Os Scripts do Office não dão suporte ao uso de bibliotecas JavaScript externas de terceiros. Atualmente, você não pode chamar nenhuma biblioteca diferente das APIs de Scripts do Office de um script. Você ainda tem acesso a qualquer objeto JavaScript interno, como Matemática.

Intellisense

O IntelliSense é um conjunto de recursos do Editor de Código que ajudam você a escrever código. Ele fornece realce de erro de sintaxe e preenchimento automático e documentação de API embutida.

O IntelliSense dá sugestões conforme você digita, semelhante ao texto sugerido no Excel. Pressionar a tecla Tab ou Enter insere o membro sugerido. Acione o IntelliSense no local atual do cursor pressionando as teclas Ctrl+Space. Essas sugestões são especialmente úteis ao concluir um método. A assinatura do método exibida pelo IntelliSense contém uma lista de argumentos necessários, o tipo de cada argumento, se um determinado argumento é necessário ou opcional e o tipo de retorno do método.

Passe o cursor sobre um método, classe ou outro objeto de código para ver mais informações. Passe o mouse sobre um erro de sintaxe ou uma sugestão de código, representada por uma linha vermelha ou amarela, para ver sugestões sobre como corrigir o problema. Muitas vezes, o IntelliSense fornece uma opção "Correção Rápida" para alterar automaticamente o código.

Uma mensagem de erro no texto de mouse do Editor de Código com um botão 'Correção Rápida'.

O Editor de Código de Scripts do Office usa o mesmo mecanismo IntelliSense que Visual Studio Code. Para saber mais sobre o recurso, visite os recursos do IntelliSense do Visual Studio Code.

Atalhos de teclado

A maioria dos atalhos de teclado para Visual Studio Code também funcionam no Editor de Código de Scripts do Office. Use os seguintes PDFs para saber mais sobre as opções disponíveis e aproveitar ao máximo o Editor de Código:

Confira também