Explorer l’API JavaScript Office à l’aide de Script Lab
Script Lab est un outil gratuit permettant à quiconque d’apprendre à développer des compléments Office. Script Lab vous permet de coder et d’exécuter les API JavaScript Office en même temps que votre document dans Excel, Outlook, PowerPoint et Word. Utilisez cet outil pratique pour prototyper et vérifier les fonctionnalités souhaitées dans votre propre complément.
Découvrez Script Lab en action dans cette vidéo YouTube d’une minute.
Qu’est-ce que script Lab ?
Script Lab est un complément pour le prototypage de compléments. Il utilise l’API JavaScript Office dans Excel, Outlook, Word et PowerPoint et se trouve dans un volet Office à l’intérieur de votre document, feuille de calcul ou courrier électronique. Il dispose d’un éditeur de code compatible IntelliSense, basé sur le même framework que celui utilisé par Visual Studio Code. Grâce à Script Lab, vous pouvez accéder à une bibliothèque d’exemples pour tester rapidement des fonctionnalités ou utiliser ces exemples comme point de départ de votre propre code. Vous pouvez même essayer les API à venir dans Script Lab qui sont toujours en préversion pour les développeurs.
Principales fonctionnalités
Script Lab propose de nombreuses fonctionnalités pour vous aider à explorer l’API JavaScript Office et la fonctionnalité de complément prototype.
Explorer des exemples
Commencez rapidement avec une collection d’exemples d’extraits de code intégrés qui montrent comment effectuer des tâches avec l’API. Vous pouvez exécuter les exemples pour afficher instantanément le résultat dans le volet des tâches ou le document, examiner les exemples pour découvrir le fonctionnement de l’API, voire utiliser les exemples pour prototyper votre propre complément.
Code et style
En plus du code JavaScript ou TypeScript qui appelle l’API Office JS, chaque extrait de code contient également une balise HTML qui définit le contenu du volet des tâches et CSS qui définit l’apparence de ce dernier. Vous pouvez personnaliser la balise HTML et CSS pour tester le placement des éléments et les styles lorsque vous prototypez la conception du volet des tâches pour votre propre complément.
Conseil
Pour appeler des API d’aperçu dans un extrait de code, vous devez mettre à jour les bibliothèques de l’extrait de code pour utiliser le réseau de distribution de contenu bêta (CDN) (https://appsforoffice.microsoft.com/lib/beta/hosted/office.js) et les définitions de type d’aperçu @types/office-js-preview. De plus, certaines API d’aperçu sont accessibles uniquement si vous êtes inscrit au programme Office Insider et que vous exécutez une version Insider d’Office.
Enregistrer et partager des extraits de code
Par défaut, les extraits de code que vous ouvrez dans Script Lab sont enregistrés dans le cache de votre navigateur. Pour enregistrer définitivement un extrait de code, vous pouvez l’exporter dans un contenu Gist GitHub. Créez un contenu Gist secret pour enregistrer un extrait de code exclusivement pour votre usage personnel ou créez un contenu Gist public si vous envisagez de le partager avec d’autres personnes.
Importer des extraits de code
Vous pouvez importer un extrait de code dans Script Lab en spécifiant l’URL du contenu Gist GitHub public où le YAML de l’extrait de code est stocké ou en collant dans le YAML complet de l’extrait de code. Cette fonctionnalité peut être utile dans les cas où quelqu’un d’autre a partagé son extrait de code avec vous, soit en le publiant dans un contenu Gist GitHub, soit en fournissant le YAML de son extrait de code.
Clients pris en charge
Script Lab est pris en charge pour Excel, Word et PowerPoint sur les clients suivants.
- Office sur Windows*
- Office sur Mac
- Office sur le web
Script Lab pour Outlook est disponible sur les clients suivants.
- Outlook sur Windows*
- Outlook sur Mac
- Outlook sur le web avec des navigateurs Chrome, Microsoft Edge ou Safari
Pour obtenir plus d’informations sur Script Lab pour Outlook, voir le billet de blog associé.
Importante
* Script Lab ne fonctionne plus avec les combinaisons de plateforme et de version d’Office qui utilisent Internet Explorer pour héberger des compléments. Cela inclut les versions perpétuelles d’Office à Office 2019. Pour plus d’informations, voir Navigateurs utilisés par les compléments Office.
Étapes suivantes
Pour utiliser Script Lab dans Excel, Word ou PowerPoint, installez le complément Script Lab à partir d’AppSource.
Pour utiliser le Script Lab pour Outlook, vous pouvez installer le complément Script Lab pour Outlook depuis AppSource.
Nous vous invitons à développer l’exemple de bibliothèque dans Script Lab en apportant de nouveaux extraits de code dans le référentiel GitHub Office-js-snippets.
Lorsque vous êtes prêt à créer votre premier complément Office, essayez le guide de démarrage rapide pour Excel, Outlook, Word, OneNote, PowerPoint ou Project.