Ensembles de conditions requises de l’API JavaScript pour Excel
Les ensembles de conditions requises sont des groupes nommés de membres d’API. Les compléments Office utilisent les ensembles de conditions requises spécifiés dans le manifeste ou utilisent une vérification de l’exécution pour déterminer si une application Office prend en charge les API requises par le complément. Pour plus d’informations, consultez Versions d’Office et ensembles de conditions requises.
Disponibilité d’ensemble de conditions requises
Les compléments Excel peuvent être exécutés dans différentes versions d’Office, notamment Office 2016 ou version ultérieure sur Windows, et Office sur le web, iPad et Mac. Le tableau suivant répertorie les ensembles de conditions requises Excel, les applications clientes Office prises en charge et les builds ou versions minimales pour ces applications, le cas échéant.
Remarque
Pour utiliser des API dans l’un des ensembles de conditions requises numérotées ou ExcelApiOnline
, vous devez référencer la bibliothèque de production sur le réseau de distribution de contenu (CDN) Office.js.
Pour plus d’informations sur l’utilisation aperçu API, voir l’articleJavaScript d’Excel preview API.
Ensemble de conditions requises | Office sur le web | Office pour Windows
|
Office pour Windows
|
Office sur Mac | Office sur iPad |
---|---|---|---|---|---|
Aperçu | Utilisez la dernière version d’Office pour essayer les API en préversion (vous devrez peut-être rejoindre le programme Microsoft 365 Insider). | ||||
ExcelApiOnline | Dernière version (voir la page des ensembles de conditions requises) | Non applicable | Non applicable | Non applicable | Non applicable |
ExcelApi 1.17 | Pris en charge | Version 2302 (Build 16130.20332) | Non disponible | Version 16.70 (23021201) | Version 16.70 |
ExcelApi 1.16 | Pris en charge | Version 2208 (Build 15601.20148) | Non disponible | Version 16.64 (22081401) | Version 16.66 |
ExcelApi 1.15 | Pris en charge | Version 2202 (Build 14931.20132) | Non disponible | Version 16.58 (22021501) | Version 16.59 |
ExcelApi 1.14 | Pris en charge | Version 2108 (Build 14326.20508) | Office 2021 : Version 2108 (build 14326.20508) | Version 16.52 (21080801) | Version 16.53 |
ExcelApi 1.13 | Pris en charge | Version 2102 (Build 13801.20738) | Office 2021 : Version 2102 (build 13801.20738) | Version 16.50 (21061301) | Version 16.50 |
ExcelApi 1.12 | Pris en charge | Version 2008 (build 13127.20408) | Office 2021 : version 2008 (build 13127.20408) | Version 16.40 (20081000) | Version 16.40 |
ExcelApi 1.11 | Pris en charge | Version 2002 (build 12527.20470) | Office 2021 : Version 2002 (build 12527.20470) | Version 16.33 (20011301) | Version 16.35 |
ExcelApi 1.10 | Pris en charge | Version 1907 (build 11929.20306) | Office 2021 : Version 1907 (build 11929.20306) | Version 16.30 (19101301) | Version 16.0 |
ExcelApi 1.9 | Pris en charge | Version 1903 (build 11425.20204) | Office 2021 : Version 1903 (build 11425.20204) | Version 16.24 (19041401) | Version 16.0 |
ExcelApi 1.8 | Pris en charge | Version 1808 (build 10730.20102) | Office 2021 : Version 1808 (build 10730.20102) | Version 16.17 (18090901) | Version 16.0 |
ExcelApi 1.7 | Pris en charge | Version 1801 (build 9001.2171) | Office 2019 : version 1801 (build 9001.2171) | Version 16.9 (18011602) | Version 16.0 |
ExcelApi 1.6 | Pris en charge | Version 1704 (build 8201.2001) | Office 2019 : version 1704 (build 8201.2001) | Version 15.36 (17070200) | Version 15.0 |
ExcelApi 1.5 | Pris en charge | Version 1703 (build 8067.2070) | Office 2019 : version 1703 (build 8067.2070) | Version 15.36 (17070200) | Version 15.0 |
ExcelApi 1.4 | Pris en charge | Version 1701 (build 7870.2024) | Office 2019 : version 1701 (build 7870.2024) | Version 15.36 (17070200) | Version 15.0 |
ExcelApi 1.3 | Pris en charge | Version 1608 (build 7369.2055) | Office 2019 : version 1608 (build 7369.2055) | Version 15.27 | Version 15.0 |
ExcelApi 1.2 | Pris en charge | Version 1601 (build 6741.2088) | Office 2019 : version 1601 (build 6741.2088) | Version 15.22 | Version 15.0 |
ExcelApi 1.1 | Pris en charge | Version 1509 (build 4266.1001) | Office 2016 : version 1509 (build 4266.1001) | Version 15.20 | Version 15.0 |
Numéros de version et de build d’Office
Pour plus d’informations sur les versions et les numéros de build d’Office, voir :
- Numéros de version et de build des versions du canal de mise à jour pour les clients Microsoft 365
- Quelle est la version d’Office que j’utilise ?
Utiliser les conditions requises Excel au moment de l’exécution et dans le manifeste
Remarque
Cette section suppose que vous êtes familiarisé avec les rubriques Versions d’Office et ensembles de conditions requises et Spécifier les applications Office et les exigences de l’API.
Les ensembles de conditions requises sont des groupes nommés de membres d’API. Le complément Office peut effectuer une vérification à l’exécution ou utiliser des ensembles de conditions requises spécifiés dans le manifeste pour déterminer si une application Office prend en charge les API requises par le complément.
Vérification de la prise en charge de l’ensemble de conditions requises à l’exécution
L’exemple de code suivant montre comment déterminer si l’application Office dans laquelle le complément est en cours d’exécution prend en charge l’ensemble spécifié de conditions requises pour l’API.
if (Office.context.requirements.isSetSupported('ExcelApi', '1.3')) {
// Perform actions.
}
else {
// Provide alternate flow/logic.
}
Définition de la prise en charge de l’ensemble de conditions requises dans le manifeste
Vous pouvez utiliser l’élément Requirements dans le manifeste de complément pour spécifier les ensembles de conditions requises minimales et/ou les méthodes d’API que votre complément doit activer. Si la plateforme ou l’application Office ne prend pas en charge les ensembles de conditions requises ou les méthodes d’API spécifiées dans l’élément Requirements
du manifeste, le complément ne s’exécute pas dans cette application ou plateforme et ne s’affiche pas dans la liste de compléments dans Mes compléments.Si votre complément requiert une configuration spécifique pour les fonctionnalités complètes, mais qu’il peut fournir une valeur même pour les utilisateurs sur les plateformes qui ne prennent pas en charge la condition requise, nous vous recommandons de vérifier la prise en charge des exigences au moment de l’exécution, comme décrit ci-dessus, au lieu de définir la prise en charge de la condition requise dans le manifeste.
L’exemple de code suivant montre l’élément Requirements
dans un manifeste indiquant que le complément doit être chargé dans toutes les applications clientes Office prenant en charge l’ensemble de conditions requises ExcelApi version 1.3 ou ultérieure.
<Requirements>
<Sets DefaultMinVersion="1.3">
<Set Name="ExcelApi" MinVersion="1.3"/>
</Sets>
</Requirements>