Navigateurs et contrôles webview utilisés par les compléments Office

Article
10/31/2023

Les compléments Office sont des applications web qui s’affichent à l’aide d’iframes lors de l’exécution dans Office sur le Web. Dans Office pour les clients de bureau et mobiles, les compléments Office utilisent un contrôle de navigateur incorporé (également appelé vue web). Les compléments ont également besoin d’un moteur JavaScript pour exécuter le code JavaScript. Le navigateur incorporé et le moteur sont fournis par un navigateur installé sur l’ordinateur de l’utilisateur. Dans cet article, « webview » fait référence à la combinaison d’un contrôle webview et d’un moteur JavaScript.

La vue web utilisée dépend des éléments suivants :

Système d’exploitation de l’ordinateur.
Si le complément s’exécute dans Office sur le Web, dans Office téléchargé à partir d’un abonnement Microsoft 365 ou dans Office 2013 ou version ultérieure.
Dans les versions perpétuelles d’Office sur Windows, si le complément s’exécute dans la variante « vente au détail » ou « sous licence en volume ».

Importante

Les vues web provenant des Explorer internet et des Version antérieure de Microsoft Edge sont toujours utilisées dans les compléments Office

Certaines combinaisons de plateformes et de versions d’Office, y compris les versions perpétuelles sous licence en volume via Office 2019, utilisent toujours les contrôles webview fournis avec Internet Explorer 11 (appelé « Trident ») et Version antérieure de Microsoft Edge (appelé « EdgeHTML ») pour héberger les compléments, comme expliqué dans cet article. Internet Explorer 11 a été désactivé dans Windows 10 et Windows 11 en février 2023, et l’interface utilisateur pour son lancement a été supprimée, mais elle est toujours installée sur ces systèmes d’exploitation. Ainsi, Trident et d’autres fonctionnalités d’Internet Explorer peuvent toujours être appelées par programme par Office.

Nous vous recommandons (mais n’exigez pas) de continuer à prendre en charge ces combinaisons, du moins de manière minimale, en fournissant aux utilisateurs de votre complément un message d’échec approprié lorsque votre complément est lancé dans l’une de ces vues web. Gardez ces points supplémentaires à l’esprit :

Office sur le Web ne s’ouvre plus dans internet Explorer ou Version antérieure de Microsoft Edge. Par conséquent, AppSource ne teste pas les compléments dans Office sur le Web sur ces navigateurs.
AppSource teste toujours les combinaisons de versions de plateforme et de bureau Office qui utilisent Trident ou EdgeHTML. Toutefois, il émet un avertissement uniquement lorsque le complément ne prend pas en charge ces vues web ; le complément n’est pas rejeté par AppSource.
L’outil Script Lab ne prend plus en charge Trident.

Pour plus d’informations sur la prise en charge de Trident ou EdgeHTML, notamment sur la configuration d’un message d’échec approprié sur votre complément, voir Prise en charge des vues web Microsoft plus anciennes et des versions d’Office.

Les sections suivantes spécifient le navigateur utilisé pour les différentes plateformes et systèmes d’exploitation.

Plateformes non Windows

Pour ces plateformes, la plateforme détermine seule le navigateur utilisé.

Système d’exploitation	Version d’Office	Navigateur
indifférent	Office sur le web	Navigateur dans lequel Office sur le web est ouvert. (Notez toutefois que Office sur le Web ne s’ouvre pas dans les Explorer Internet. Si vous tentez de le faire, Office sur le Web s’ouvre dans Edge.)
Mac	indifférent	Safari avec WKWebView
iOS	indifférent	Safari avec WKWebView
Android	indifférent	Chrome

Importante

L’accès conditionnel n’est pas pris en charge pour les compléments Office sur iOS ou Android. Ces compléments utilisent le WKWebView basé sur Safari ou le WebView android, et non un contrôle de navigateur basé sur Edge.

Windows

Un complément s’exécutant sur Windows peut utiliser l’une des trois vues web différentes :

WebView2, qui est fourni par Microsoft Edge (basé sur Chromium).
EdgeHTML, fourni par Version antérieure de Microsoft Edge.
Trident+, fourni par Internet Explorer 11. Le « + » à la fin indique que les compléments Office utilisent des fonctionnalités supplémentaires d’Internet Explorer 11 qui ne sont pas intégrées à Trident proprement dit.

Versions perpétuelles d’Office sur Windows

Pour les versions perpétuelles d’Office sur Windows, le navigateur utilisé est déterminé par la version d’Office, si la licence est commercialisée ou sous licence en volume, et si Edge WebView2 (basé sur Chromium) est installé. La version de Windows n’a pas d’importance, mais notez que les compléments web Office ne sont pas pris en charge sur les versions antérieures à Windows 7 et Office 2021 n’est pas pris en charge sur les versions antérieures à Windows 10.

Pour déterminer si Office 2016 ou Office 2019 est commercialisé ou sous licence en volume, utilisez le format de la version d’Office et du numéro de build. (Pour Office 2013 et Office 2021, la distinction entre licence en volume et vente au détail n’a pas d’importance.)

Vente au détail : pour Office 2016 et 2019, le format est YYMM (xxxxx.xxxxxx), se terminant par deux blocs de cinq chiffres ; par exemple, 2206 (Build 15330.20264).
Licence en volume :
- Pour Office 2016, le format est 16.0.xxxx.xxxxx, se terminant par deux blocs de quatre chiffres ; par exemple, 16.0.5197.1000.
- Pour Office 2019, le format est 1808 (xxxxx.xxxxxx), se terminant par deux blocs de cinq chiffres ; par exemple, 1808 (Build 10388.20027). Notez que l’année et le mois sont toujours 1808.

Version d’Office	Vente au détail et licence en volume	WebView2 installé ?	Navigateur
Office 2021	Peu importe	Oui¹	WebView2 (Basé sur Microsoft Edge² Chromium)
Office 2019	Commerce	Oui¹	WebView2 (Basé sur Microsoft Edge² Chromium)
Office 2019	Commerce	Non	EdgeHTML (Version antérieure de Microsoft Edge)^{2, 3} Si Edge n’est pas installé, Trident+ (Internet Explorer 11) est utilisé.
Office 2019	Licence en volume	Peu importe	Trident+ (Internet Explorer 11)
Office 2016	Commerce	Oui¹	WebView2 (Basé sur Microsoft Edge² Chromium)
Office 2016	Commerce	Non	EdgeHTML (Version antérieure de Microsoft Edge)^{2, 3} Si Edge n’est pas installé, Trident+ (Internet Explorer 11) est utilisé.
Office 2016	Licence en volume	Peu importe	Trident+ (Internet Explorer 11)
Office 2013	Peu importe	Peu importe	Trident+ (Internet Explorer 11)

¹ Sur les versions de Windows antérieures à Windows 11, le contrôle WebView2 doit être installé afin qu’Office puisse l’incorporer. Il est installé avec une Office 2021 perpétuelle ou ultérieure, mais il n’est pas automatiquement installé avec Microsoft Edge. Si vous disposez d’une version antérieure d’Office perpétuel, suivez les instructions d’installation du contrôle sur Microsoft Edge WebView2 / Incorporer du contenu web ... avec Microsoft Edge WebView2.

² Lorsque vous utilisez EdgeHTML ou WebView2, le Narrateur Windows (parfois appelé « lecteur d’écran ») lit la <title> balise dans la page qui s’ouvre dans le volet Office. Dans Trident+, le Narrateur lit la barre de titre du volet Office, qui provient du nom du complément spécifié dans le manifeste du complément.

³ Si votre complément utilise un manifeste XML et inclut l’élément <Runtimes> dans le manifeste ou s’il utilise le manifeste unifié et qu’il inclut une propriété « extensions.runtimes.lifetime », il n’utilise pas EdgeHTML. Si les conditions d’utilisation de WebView2 sont remplies, le complément utilise WebView2. Sinon, il utilise Trident+. Pour plus d’informations, consultez Runtimes et Configurer votre complément Outlook pour l’activation basée sur les événements.

Versions d’abonnement Microsoft 365 d’Office sur Windows

Pour l’abonnement Office sur Windows, le navigateur utilisé est déterminé par le système d’exploitation, la version d’Office et si le contrôle WebView2 est installé.

Système d’exploitation	Version d’Office	WebView2 installé ?	Navigateur
Windows 11, Windows 10, Windows 8.1, Windows Server 2022, Windows Server 2019, Windows Server 2016	Microsoft 365 ver. >= 16.0.13530.20424¹	Oui²	WebView2 (Basé sur Microsoft Edge³ Chromium)
Fenêtre 11, Windows 10 version >= 1903	Microsoft 365 ver. >= 16.0.13530.20424¹	Non	EdgeHTML (Version antérieure de Microsoft Edge)^{3, 4}
Windows 11, Windows 10 version >= 1903	Microsoft 365 ver. >= 16.0.11629 ET< 16.0.13530.20424¹	Peu importe	EdgeHTML (Version antérieure de Microsoft Edge)^{3, 4}
Windows 11, Windows 10 version >= 1903	Microsoft 365 ver. < 16.0.11629¹	Peu importe	Trident+ (Internet Explorer 11)
Windows 10 version < 1903, Windows 8.1	Microsoft 365	Non	Trident+ (Internet Explorer 11)
Windows 7	Microsoft 365	Peu importe	Trident+ (Internet Explorer 11)

¹ Pour plus d’informations, consultez la page d’historique des mises à jour et comment rechercher la version de votre client Office et le canal de mise à jour .

^{2 Sur les} versions de Windows antérieures à Windows 11, le contrôle WebView2 doit être installé afin qu’Office puisse l’incorporer. Il est installé avec Microsoft 365, version 2101 ou ultérieure, mais il n’est pas automatiquement installé avec Microsoft Edge. Si vous disposez d’une version antérieure de Microsoft 365, suivez les instructions pour installer le contrôle dans Microsoft Edge WebView2 / Incorporer du contenu web ... avec Microsoft Edge WebView2. Sur les builds Microsoft 365 antérieures à 16.0.14326.xxxxx, vous devez également créer la clé de Registre HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\Win32WebView2 et définir sa valeur sur dword:00000001.

³ Lorsque vous utilisez EdgeHTML ou WebView2, le Narrateur Windows (parfois appelé « lecteur d’écran ») lit la <title> balise dans la page qui s’ouvre dans le volet Office. Dans Trident+, le Narrateur lit la barre de titre du volet Office, qui provient du nom du complément spécifié dans le manifeste du complément.

⁴ Si votre complément utilise un manifeste XML et inclut l’élément <Runtimes> dans le manifeste ou s’il utilise le manifeste unifié et qu’il inclut une propriété « extensions.runtimes.lifetime », il n’utilise pas EdgeHTML. Si les conditions d’utilisation de WebView2 sont remplies, le complément utilise WebView2. Sinon, il utilise Trident+. Pour plus d’informations, consultez Runtimes et Configurer votre complément Outlook pour l’activation basée sur les événements.

Utilisation de Trident+ (Internet Explorer 11)

Trident+ ne prend pas en charge les versions JavaScript ultérieures à ES5. Si l’un des utilisateurs de votre complément a des plateformes qui utilisent Trident+, vous avez deux options pour utiliser la syntaxe et les fonctionnalités d’ECMAScript 2015 ou version ultérieure.

Écrivez votre code dans ECMAScript 2015 (également appelé ES6) ou javaScript ultérieur, ou dans TypeScript, puis compilez votre code dans JavaScript ES5 à l’aide d’un compilateur tel que babel ou tsc.
Écrivez dans ECMAScript 2015 ou une version ultérieure de JavaScript, mais chargez également une bibliothèque polyfill telle que core-js qui permet à Internet Explorer d’exécuter votre code.

Pour plus d’informations sur ces options, voir Prise en charge des anciennes vues web microsoft et versions d’Office.

En outre, Trident+ ne prend pas en charge certaines fonctionnalités HTML5 telles que les médias, l’enregistrement et l’emplacement. Pour en savoir plus, consultez Déterminer la vue web dans laquelle le complément s’exécute au moment de l’exécution.

Résoudre les problèmes liés à EdgeHTML et WebView2 (Microsoft Edge)

Les travailleurs du service ne fonctionnent pas

Les compléments Office ne prennent pas en charge les Workers de service lorsque EdgeHTML est utilisé. Elles sont prises en charge avec WebView2.

La barre de défilement n’apparaît pas dans le volet Office

Par défaut, les barres de défilement dans EdgeHTML et WebView2 sont masquées jusqu’à ce qu’elles soient survolées. Pour vous assurer que la barre de défilement est toujours visible, les styles CSS qui s’appliquent à l’<body>élément des pages dans le volet des tâches doivent inclure la propriété -ms-overflow-style et la valeur scrollbar doit être attribuée.

Lorsque vous déboguez avec Microsoft Edge DevTools, le complément se bloque ou se recharge

La définition de points d’arrêt dans Microsoft Edge DevTools pour EdgeHTML peut amener Office à penser que le complément est bloqué. Lorsque cela se produit, le complément est alors automatiquement rechargé. Pour éviter ce phénomène, ajoutez la valeur et la clé de registre suivantes à l’ordinateur de développement : [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\16.0\Wef]"AlertInterval"=dword:00000000.

Lorsque le complément tente de s’ouvrir, l’erreur « ERREUR DE COMPLÉMENT Impossible d’ouvrir ce complément à partir de localhost » apparaît.

L’une des causes connues est que EdgeHTML exige que localhost soit exempté de bouclage sur l’ordinateur de développement. Suivez les instructions à l’emplacement suivant : Impossible d’ouvrir le complément à partir de localhost.

Obtenir des erreurs lors de la tentative de téléchargement d’un fichier PDF

Le téléchargement direct d’objets blob en tant que fichiers PDF dans un complément n’est pas pris en charge avec EdgeHTML ou WebView2. La solution de contournement consiste à créer une application web simple qui télécharge des objets blob sous forme de fichiers PDF. Dans votre complément, appelez la Office.context.ui.openBrowserWindow(url) méthode et transmettez l’URL de l’application web. L’application web s’ouvre dans une fenêtre de navigateur en dehors d’Office.

Documents protégés par WIP

Une étape supplémentaire est nécessaire pour que les compléments s’exécutent dans un document avec WIP (Windows Information Protection) et utilisent WebView2 (Basé sur Microsoft Edge Chromium). Ajoutez le processus WebView2, msedgewebview2.exe, à la liste des applications protégées dans la stratégie WIP de votre entreprise. Un administrateur ajoute cette stratégie WIP via Intune avec les valeurs suivantes.

Nom : Webview2
Éditeur : O=MICROSOFT CORPORATION, L=REDMOND, S=WASHINGTON, C=US
Nom du produit : MICROSOFT EDGE WEBVIEW2
Fichier : MSEDGEWEBVIEW2.EXE
Version minimale : *
Version maximale : *

Si la stratégie WIP n’a pas été ajoutée, le complément est défini par défaut sur un runtime plus ancien. Dans les sections Versions perpétuelles d’Office sur Windows et les versions d’abonnement Microsoft 365 d’Office sur Windows plus haut dans cet article, remplacez EdgeHTML (Version antérieure de Microsoft Edge) par WebView2 (Microsoft Edge Chromium) partout où ce dernier apparaît.

Pour déterminer si un document est protégé par WIP, procédez comme suit.

Ouvrez le fichier.
Sélectionnez l’onglet Fichier dans le ruban.
Sélectionnez Informations.
Dans la section supérieure de la page Informations , juste en dessous du nom de fichier, un document compatible WIP a une icône de porte-documents suivie de Géré par le travail (...).

Remarque

La prise en charge de WebView2 dans les documents compatibles WIP a été ajoutée avec la build 16.0.16626.20132. Si vous utilisez une version antérieure, votre runtime est défini par défaut sur EdgeHTML (Version antérieure de Microsoft Edge), quelle que soit la stratégie.