- 09/03/2020
- 4 minutes à lire
-
- o
- R
- A
- l
- m
-
+4
Cet article décrit comment utiliser l’API JavaScript Excel pour créer des compléments pour Excel 2016 ou une version ultérieure. Il introduit des concepts de base fondamentaux pour l’utilisation de l’API et fournit des conseils pour effectuer des tâches spécifiques telles que la lecture ou l’écriture sur une large plage, la mise à jour de toutes les cellules de la plage, etc.
Important
Consultez Utilisation du modèle d’API spécifique à l’application pour en savoir plus sur la nature asynchrone des API Excel et leur fonctionnement avec le classeur.
Bureau.api js pour Excel
Un complément Excel interagit avec des objets dans Excel à l’aide de l’API JavaScript Office, qui comprend deux modèles d’objets JavaScript:
-
API JavaScript Excel : Introduite avec Office 2016, l’API JavaScript Excel fournit des objets fortement typés que vous pouvez utiliser pour accéder à des feuilles de calcul, des plages, des tableaux, des graphiques, etc.
-
API communes : Introduite avec Office 2013, l’API commune peut être utilisée pour accéder à des fonctionnalités telles que l’interface utilisateur, les boîtes de dialogue et les paramètres clients communs à plusieurs types d’applications Office.
Bien que vous utilisiez probablement l’API JavaScript Excel pour développer la majorité des fonctionnalités des compléments ciblant Excel 2016 ou une version ultérieure, vous utiliserez également des objets dans l’API commune. Par exemple:
- Contexte : L’objet
Context
représente l’environnement d’exécution du complément et donne accès aux objets clés de l’API. Il se compose de détails de configuration de classeur tels quecontentLanguage
etofficeTheme
et fournit également des informations sur l’environnement d’exécution du complément tel quehost
etplatform
. En outre, il fournit la méthoderequirements.isSetSupported()
, que vous pouvez utiliser pour vérifier si l’ensemble d’exigences spécifié est pris en charge par l’application Excel sur laquelle le complément est en cours d’exécution.Document - : L’objet
Document
fournit la méthodegetFileAsync()
, que vous pouvez utiliser pour télécharger le fichier Excel dans lequel le complément est en cours d’exécution.
L’image suivante montre quand vous pouvez utiliser l’API JavaScript Excel ou les API communes.
Modèle d’objet spécifique à Excel
Pour comprendre les API Excel, vous devez comprendre comment les composants d’un classeur sont liés les uns aux autres.
- Un classeur contient une ou plusieurs feuilles de calcul.
- Une feuille de calcul contient des collections des objets de données présents dans la feuille individuelle et donne accès aux cellules via des objets de plage.
- Une plage représente un groupe de cellules contiguës.Les plages
- sont utilisées pour créer et placer des tables, des Graphiques, des formes et d’autres objets de visualisation de données ou d’organisation.Les classeurs
- contiennent des collections de certains de ces objets de données (tels que des tables) pour l’ensemble du classeur.
Plages
Une plage est un groupe de cellules contiguës dans le classeur. Les compléments utilisent généralement une notation de style A1 (par exemple, B3 pour la cellule unique de la colonne B et de la ligne 3 ou C2: F4 pour les cellules des colonnes C à F et des lignes 2 à 4) pour définir des plages.Les plages
ont trois propriétés principales : values
, formulas
et format
. Ces propriétés obtiennent ou définissent les valeurs de cellules, les formules à évaluer et le formatage visuel des cellules.
Échantillon de plage
L’exemple suivant montre comment créer des enregistrements de ventes. Cette fonction utilise des objets Range
pour définir les valeurs, les formules et les formats.
Cet exemple crée les données suivantes dans la feuille de calcul en cours:
Pour plus d’informations, consultez Travailler avec des plages à l’aide de l’API JavaScript Excel.
Graphiques, tableaux et autres objets de données
Les API JavaScript Excel peuvent créer et manipuler les structures de données et les visualisations dans Excel. Les tableaux et les graphiques sont deux des objets les plus couramment utilisés, mais les API prennent en charge les tableaux croisés dynamiques, les formes, les images, etc.
Création d’une table
Créez des tables à l’aide de plages remplies de données. Les contrôles de mise en forme et de table (tels que les filtres) sont automatiquement appliqués à la plage.
L’échantillon suivant crée un tableau en utilisant les plages de l’échantillon précédent.
L’utilisation de cet exemple de code sur la feuille de calcul avec les données précédentes crée le tableau suivant:
Pour plus d’informations, consultez Travailler avec des tableaux à l’aide de l’API JavaScript Excel.
Création d’un graphique
Créez des graphiques pour visualiser les données dans une plage. Les API prennent en charge des dizaines de variétés de graphiques, chacune pouvant être personnalisée en fonction de vos besoins.
L’exemple suivant crée un graphique à colonnes simple pour trois éléments et le place 100 pixels sous le haut de la feuille de calcul.
L’exécution de cet exemple sur la feuille de calcul avec le tableau précédent crée le graphique suivant:
Pour plus d’informations, consultez Travailler avec des graphiques à l’aide de l’API JavaScript Excel.