Editor de código de Scripts do Office

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 de Scripts do Office é baseado no Visual Studio Code, portanto, se você já usou esse ambiente antes, 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 de Scripts do Office usa o TypeScript. Como o TypeScript é um superconjunto de JavaScript, qualquer código de script que você escrever em JavaScript funcionará bem.

Os Scripts do Office são, em grande parte, partes 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 lida com a instalação, compilação e execução de código, portanto, você não precisa se preocupar com nada além do próprio script. É possível aprender a linguagem e criar scripts sem conhecimento prévio de programação. No entanto, se você for iniciante na programação, recomendamos aprender alguns conceitos básicos antes de prosseguir com os 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 presumir que o código pode 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 seu script na documentação de referência da API de Scripts do Office.

Suporte a biblioteca externa

Os Scripts do Office não oferecem suporte ao uso de bibliotecas JavaScript externas de terceiros. No momento, você não pode chamar nenhuma biblioteca além das APIs de Scripts do Office a partir de um script. Você ainda tem acesso a qualquer objeto JavaScript interno, como Math.

IntelliSense

O IntelliSense é um conjunto de recursos de editor de código que ajuda você a escrever código. Ele fornece preenchimento automático, realce de erros de sintaxe e documentação de API embutida.

O IntelliSense fornece sugestões enquanto você digita, semelhante ao texto sugerido no Excel. Usar a tecla Tab ou Enter insere o membro sugerido. Dispare o IntelliSense no local atual do cursor com 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 é obrigató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 sugestão de código, representado por uma linha ondulada vermelha ou amarela, para ver sugestões sobre como corrigir o problema. Muitas vezes, o IntelliSense fornece uma opção de "Correção Rápida" para alterar automaticamente o código.

Uma mensagem de erro no texto de foco 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 o 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 do Visual Studio Code também funciona no editor de códigos 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ódigos:

Confira também

  • Last updated on