Explore a API JavaScript do Office usando o Script Lab
Script Lab é uma ferramenta gratuita para qualquer pessoa aprender a desenvolver suplementos do Office. Script Lab permite codificar e executar as APIs JavaScript do Office ao lado do documento no Excel, Outlook, PowerPoint e Word. Use essa ferramenta conveniente para protótipo e verifique a funcionalidade desejada em seu próprio suplemento.
Confira Script Lab em ação neste vídeo de um minuto do YouTube.
O que é o script Lab?
Script Lab é um suplemento para suplementos de prototipagem. Ele usa a API JavaScript do Office no Excel, Outlook, Word e PowerPoint e está em um painel de tarefas dentro do documento, planilha ou email. Ele tem um editor de código habilitado para IntelliSense, baseado na mesma estrutura usada por Visual Studio Code. Por meio de Script Lab, você pode acessar uma biblioteca de exemplos para experimentar rapidamente recursos ou usar esses exemplos como ponto de partida para seu próprio código. Você pode até mesmo experimentar as próximas APIs no Script Lab que ainda estão na versão prévia do desenvolvedor.
Principais recursos
O script Lab oferece vários recursos para ajudá-lo a explorar a funcionalidade do suplemento API e protótipo do Office JavaScript.
Explorar amostras
Comece a trabalhar rapidamente com um conjunto de exemplos internos que mostram como concluir tarefas com a API. Você pode executar as amostras para ver instantaneamente o resultado no painel de tarefas ou documento, examinar os exemplos para saber como a API funciona e até mesmo usar amostras para criar um protótipo do seu próprio suplemento.
Código e estilo
Além de código JavaScript ou TypeScript que chama a API do Office JS, cada snippet também contém marcação HTML que define o conteúdo do painel de tarefas e CSS que define a aparência do painel de tarefas. Você pode personalizar a marcação HTML e CSS para experimentar o posicionamento e o estilo de elementos à medida que você cria seu próprio suplemento no painel de tarefas.
Dica
Para chamar APIs de visualização em um snippet, você precisará atualizar as bibliotecas do snippet para usar a CDN (rede de distribuição de conteúdo) beta (https://appsforoffice.microsoft.com/lib/beta/hosted/office.js) e as definições de tipo de visualização @types/office-js-preview. Além disso, algumas APIs de visualização são acessíveis apenas se você se inscreveu no programa Office Insider e está executando uma compilação do Office Insider.
Salvar e compartilhar trechos
Por padrão, os trechos abertos no Script Lab serão salvos no cache do navegador. Para salvar um trecho permanentemente, você pode exportá-lo para um GitHub gist. Crie uma propriedade secreta para salvar um trecho exclusivo para seu próprio uso ou criar uma conta pública se planejar compartilhá-la com outras pessoas.
Importar trechos
Você pode importar um trecho para o Script Lab especificando a URL para o do GitHub público onde o snippet YAML está armazenado ou colando-o no YAML completo do trecho. Esse recurso pode ser útil em situações em que outra pessoa compartilhou trechos com você publicando-o em uma oferta do GitHub ou fornecendo o YAML do trecho.
Clientes com suporte
O Script Lab tem suporte para o Excel, o Word e o PowerPoint nos clientes a seguir.
- Office no Windows*
- Office no Mac
- Office na Web
O Script Lab para Outlook está disponível para os seguintes clientes.
- Outlook no Windows*
- Outlook no Mac
- Outlook na Web ao usar os navegadores Chrome, Microsoft Edge ou Safari
Para obter mais detalhes sobre o Script Lab para Outlook, confira a postagem do blog relacionada.
Importante
* Script Lab não funciona mais com combinações de plataforma e versão do Office que usam o Internet Explorer para hospedar suplementos. Isso inclui versões perpétuas do Office até o Office 2019. Para obter mais informações, confira Navegadores usados pelos Suplementos do Office.
Próximas etapas
Para usar o Script Lab no Excel, no Word ou no PowerPoint, instale o suplemento do Script Lab do AppSource.
Para usar o Script Lab para Outlook, instale o suplemento Script Lab para Outlook do AppSource.
Você é bem-vindo a expandir a biblioteca de exemplo no Script Lab, contribuindo com novos trechos para o office-js-snippets repositório do GitHub.
Quando estiver pronto para criar seu primeiro suplemento do Office, experimente o início rápido para Excel, Outlook, Word, OneNote, PowerPointou Project.