Navegadores e controles de visão da Web usados pelos Suplementos do Office

Artigo
04/24/2024

Os suplementos do Office são aplicativos Web exibidos usando iframes ao executar em Office na Web. No Office para clientes de área de trabalho e móveis, os Suplementos do Office usam um controle de navegador inserido (também conhecido como webview). Os suplementos também precisam de um mecanismo JavaScript para executar o JavaScript. O navegador inserido e o mecanismo são fornecidos por um navegador instalado no computador do usuário. Neste artigo, "webview" refere-se à combinação de um controle webview e um mecanismo JavaScript.

Qual visão da Web é usada depende de:

O sistema operacional do computador.
Se o suplemento está em execução no Office na Web, no Office baixado de uma assinatura do Microsoft 365 ou no Perpétuo Office 2016 ou posterior.
Nas versões perpétuas do Office no Windows, se o suplemento está em execução na variação "varejo" ou "licenciado por volume".

Importante

Webviews de Explorer e Versão Prévia do Microsoft Edge da Internet ainda são usados em Suplementos do Office

Algumas combinações de plataformas e versões do Office, incluindo versões perpétuas licenciadas por volume por meio do Office 2019, ainda usam os controles webview que vêm com a Internet Explorer 11 (chamada "Trident") e Versão Prévia do Microsoft Edge (chamado "EdgeHTML") para hospedar suplementos, conforme explicado neste artigo. A internet Explorer 11 foi desabilitada em Windows 10 e Windows 11 em fevereiro de 2023, e a interface do usuário para iniciá-la foi removida; mas ainda está instalada nesses sistemas operacionais. Portanto, o Trident e outras funcionalidades da Internet Explorer ainda podem ser chamados programaticamente pelo Office.

Recomendamos (mas não requer) que você continue a dar suporte a essas combinações, pelo menos de forma mínima, fornecendo aos usuários do seu suplemento uma mensagem de falha graciosa quando seu suplemento é iniciado em uma dessas visões da Web. Tenha esses pontos adicionais em mente:

Office na Web não é mais aberto na Internet Explorer ou Versão Prévia do Microsoft Edge. Consequentemente, o AppSource não testa suplementos no Office nesses navegadores da Web.
O AppSource ainda testa combinações de versões da plataforma e da área de trabalho do Office que usam Trident ou EdgeHTML. No entanto, ele só emite um aviso quando o suplemento não dá suporte a essas visões da Web; o suplemento não é rejeitado pelo AppSource.
A ferramenta Script Lab não dá mais suporte ao Trident.

Para obter mais informações sobre como dar suporte a Trident ou EdgeHTML, incluindo a configuração de uma mensagem de falha graciosa em seu suplemento, consulte Suporte a versões mais antigas da Webviews da Microsoft e do Office.

As seções a seguir especificam qual navegador é usado para as várias plataformas e sistemas operacionais.

Plataformas que não são do Windows

Para essas plataformas, somente a plataforma determina o navegador usado.

SO	Versão do Office	Navegador
qualquer	Office na Web	O navegador no qual o Office está aberto. (Mas observe que o Office na Web não será aberto no Explorer da Internet. Tentar fazer isso abre Office na Web no Edge.)
Mac	qualquer	Safari com WKWebView
iOS	qualquer	Safari com WKWebView
Android	qualquer	Chrome

Importante

Não há suporte para acesso condicional para suplementos do Office no iOS ou Android. Esses suplementos usam o WKWebView baseado em Safari ou o WebView baseado em Android, não um controle de navegador baseado em Edge.

Windows

Um suplemento em execução no Windows pode usar qualquer uma das três visões da Web diferentes:

WebView2, que é fornecido pelo Microsoft Edge (baseado em Chromium).
EdgeHTML, que é fornecido por Versão Prévia do Microsoft Edge.
Trident+, que é fornecido pela Internet Explorer 11. O "+" no final indica que os Suplementos do Office usam funcionalidades adicionais da Internet Explorer 11 que não são incorporados no próprio Trident.

Versões perpétuas do Office no Windows

Para versões perpétuas do Office no Windows, o navegador usado é determinado pela versão do Office, se a licença é de varejo ou licenciada por volume e se o Edge WebView2 (baseado em Chromium) está instalado. A versão do Windows não importa, mas observe que os Suplementos Web do Office não têm suporte em versões anteriores ao Windows 7 e Office 2021 não há suporte em versões anteriores a Windows 10.

Para determinar se o Office 2016 ou o Office 2019 é licenciado por varejo ou volume, use o formato da versão do Office e o número de build. (Para Office 2021, a distinção entre o volume licenciado e o varejo não importa.)

Varejo: para o Office 2016 e 2019, o formato é YYMM (xxxxx.xxxxxx), terminando com dois blocos de cinco dígitos; por exemplo, 2206 (Build 15330.20264).
Licenciado por volume:
- Para o Office 2016, o formato é 16.0.xxxx.xxxxx, terminando com dois blocos de quatro dígitos; por exemplo, 16.0.5197.1000.
- Para o Office 2019, o formato é 1808 (xxxxx.xxxxxx), terminando com dois blocos de cinco dígitos; por exemplo, 1808 (Build 10388.20027). Observe que o ano e o mês são sempre 1808.

Versão do Office	Varejo vs. Licenciado por volume	WebView2 instalado?	Navegador
Office 2021	Não importa	Sim¹	WebView2 (baseado em Chromium do Microsoft Edge²)
Office 2019	Varejo	Sim¹	WebView2 (baseado em Chromium do Microsoft Edge²)
Office 2019	Varejo	Não	EdgeHTML (Versão Prévia do Microsoft Edge)^{2, 3} Se o Edge não estiver instalado, o Trident+ (Internet Explorer 11) será usado.
Office 2019	Licenciado por volume	Não importa	Trident+ (Internet Explorer 11)
Office 2016	Varejo	Sim¹	WebView2 (baseado em Chromium do Microsoft Edge²)
Office 2016	Varejo	Não	EdgeHTML (Versão Prévia do Microsoft Edge)^{2, 3} Se o Edge não estiver instalado, o Trident+ (Internet Explorer 11) será usado.
Office 2016	Licenciado por volume	Não importa	Trident+ (Internet Explorer 11)

¹ Em versões do Windows antes do Windows 11, o controle WebView2 deve ser instalado para que o Office possa incorporá-lo. Ele é instalado com Office 2021 perpétuos ou posteriores; mas não é instalado automaticamente com o Microsoft Edge. Se você tiver uma versão anterior do Office perpétuo, use as instruções para instalar o controle no Conteúdo web do Microsoft Edge WebView2/ Insira... com o Microsoft Edge WebView2.

² Quando você usa EdgeHTML ou WebView2, o Narrador do Windows (às vezes chamado de "leitor de tela") lê a <title> marca na página aberta no painel de tarefas. Em Trident+, o Narrador lê a barra de título do painel de tarefas, que vem do nome do suplemento especificado no manifesto do suplemento.

³ Se o suplemento usa um manifesto XML e inclui o <elemento Runtimes> no manifesto ou usa o manifesto unificado e inclui uma propriedade "extensions.runtimes.lifetime", ele não usará EdgeHTML. Se as condições para usar o WebView2 forem atendidas, o suplemento usará o WebView2. Caso contrário, ele usa Trident+. Para obter mais informações, consulte Runtimes e Configurar seu suplemento do Outlook para ativação baseada em eventos.

Versões de assinatura do Microsoft 365 do Office no Windows

Para a assinatura do Office no Windows, o navegador usado é determinado pelo sistema operacional, pela versão do Office e se o controle WebView2 está instalado.

SO	Versão do Office	WebView2 instalado?	Navegador
Windows 11, Windows 10, Windows 8.1, Windows Server 2022, Windows Server 2019, Windows Server 2016	Microsoft 365 ver. >= 16,0.13530.20424¹	Sim²	WebView2 (baseado em Chromium do Microsoft Edge³)
Janela 11, Versão do Windows 10 >= 1903	Microsoft 365 ver. >= 16,0.13530.20424¹	Não	EdgeHTML (Versão Prévia do Microsoft Edge)^{3, 4}
Windows 11, Versão do Windows 10 >= 1903	Microsoft 365 ver. >= 16,0,11629 E< 16,0.13530.20424¹	Não importa	EdgeHTML (Versão Prévia do Microsoft Edge)^{3, 4}
Windows 11, Versão do Windows 10 >= 1903	Microsoft 365 ver. < 16.0.11629¹	Não importa	Trident+ (Internet Explorer 11)
Versão do Windows 10 < 1903, Windows 8.1	Microsoft 365	Não	Trident+ (Internet Explorer 11)
Windows 7	Microsoft 365	Não importa	Trident+ (Internet Explorer 11)

¹ Confira a página histórico de atualizações e como encontrar a versão do cliente do Office e o canal de atualização para obter mais detalhes.

² Em versões do Windows antes do Windows 11, o controle WebView2 deve ser instalado para que o Office possa incorporá-lo. Ele é instalado com o Microsoft 365, Versão 2101 ou posterior, mas não é instalado automaticamente com o Microsoft Edge. Se você tiver uma versão anterior do Microsoft 365, use as instruções para instalar o controle no Microsoft Edge WebView2 / Inserir conteúdo da Web ... com o Microsoft Edge WebView2. Em builds do Microsoft 365 antes de 16.0.14326.xxxxx, você também deve criar a chave do registro HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\WEF\Win32WebView2 e definir seu valor como dword:00000001.

³ Quando você usa EdgeHTML ou WebView2, o Narrador do Windows (às vezes chamado de "leitor de tela") lê a <title> marca na página aberta no painel de tarefas. Em Trident+, o Narrador lê a barra de título do painel de tarefas, que vem do nome do suplemento especificado no manifesto do suplemento.

⁴ Se o suplemento usa um manifesto XML e inclui o <elemento Runtimes> no manifesto ou usa o manifesto unificado e inclui uma propriedade "extensions.runtimes.lifetime", ele não usará EdgeHTML. Se as condições para usar o WebView2 forem atendidas, o suplemento usará o WebView2. Caso contrário, ele usa Trident+. Para obter mais informações, consulte Runtimes e Configurar seu suplemento do Outlook para ativação baseada em eventos.

Trabalhando com Trident+ (Internet Explorer 11)

O Trident+ não dá suporte a versões JavaScript posteriores ao ES5. Se algum dos usuários do suplemento tiver plataformas que usam Trident+, para usar a sintaxe e os recursos do ECMAScript 2015 ou posterior, você terá duas opções.

Escreva seu código no ECMAScript 2015 (também chamado de ES6) ou javaScript posterior ou no TypeScript e compile seu código para o JavaScript ES5 usando um compilador como babel ou tsc.
Escreva no ECMAScript 2015 ou posterior JavaScript, mas também carregue uma biblioteca de polyfill , como core-js , que permite que o IE execute seu código.

Para obter mais informações sobre essas opções, consulte Suporte a versões mais antigas da Webviews da Microsoft e do Office.

Além disso, o Trident+ não dá suporte a alguns recursos HTML5, como mídia, gravação e localização. Para saber mais, confira Determinar a visão da Web em que o suplemento está em execução no runtime.

Solucionar problemas de EdgeHTML e WebView2 (Microsoft Edge)

Os trabalhadores do serviço não estão funcionando

Os suplementos do Office não dão suporte aos Trabalhadores de Serviço quando o EdgeHTML é usado. Eles têm suporte com o WebView2.

A barra de rolagem não aparece no painel de tarefas

Por padrão, as barras de rolagem no EdgeHTML e no WebView2 ficam ocultas até passar o mouse. Para garantir que a barra de rolagem fique sempre visível, o estilo de CSS que se aplica ao elemento <body> das páginas no painel de tarefas deve incluir a propriedade (-ms- reoverflow-style) e deve ser definida como scrollbar.

Ao depurar com o Microsoft Edge DevTools, o suplemento falha ou recarrega

Definir pontos de interrupção no Microsoft Edge DevTools para EdgeHTML pode fazer com que o Office pense que o suplemento está suspenso. Ele recarrega automaticamente o suplemento quando isso acontece. Para evitar isso, adicione a seguinte chave do registro e valor ao computador de desenvolvimento [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\16.0\Wef]"AlertInterval"=dword:00000000:.

Quando o suplemento tentar abrir, o erro “ADD-IN ERROR não é possível abrir este suplemento a partir do localhost" acontece

Uma causa conhecida é que o EdgeHTML exige que o localhost tenha uma isenção de loopback no computador de desenvolvimento. Siga as instruções em não é possível abrir o suplemento do localhost.

Obter erros ao tentar baixar um arquivo PDF

Não há suporte para baixar blobs diretamente como arquivos PDF em um suplemento com EdgeHTML ou WebView2. A solução alternativa é criar um aplicativo Web simples que baixe blobs como arquivos PDF. No suplemento, chame o Office.context.ui.openBrowserWindow(url) método e passe a URL do aplicativo Web. Isso abrirá o aplicativo Web em uma janela do navegador fora do Office.

Documentos protegidos por WIP

Há uma etapa extra necessária para os Suplementos serem executados em um documento com WIP (Windows Proteção de Informações) e usar o WebView2 (baseado em Chromium do Microsoft Edge). Adicione o processo WebView2, msedgewebview2.exe, à lista de aplicativos protegidos na política wip da sua empresa. Um administrador adiciona essa política wip por meio de Intune com os valores a seguir.

Nome: Webview2
Publicador: O=MICROSOFT CORPORATION, L=REDMOND, S=WASHINGTON, C=US
Nome do produto: MICROSOFT EDGE WEBVIEW2
Arquivo: MSEDGEWEBVIEW2.EXE
Versão Min: *
Versão máxima: *

Se a política WIP não tiver sido adicionada, o suplemento será padrão para um runtime mais antigo. Nas seções Versões perpétuas do Office nas versões de assinatura do Windows e do Microsoft 365 do Office no Windows anteriores neste artigo, substitua EdgeHTML (Versão Prévia do Microsoft Edge) pelo WebView2 (Microsoft Edge Chromium baseado) onde quer que este último apareça.

Para determinar se um documento está protegido por WIP, siga estas etapas.

Abra o arquivo.
Selecione a guia Arquivo na faixa de opções.
Selecione Informações.
Na seção superior da página Informações , logo abaixo do nome do arquivo, um documento habilitado para WIP terá um ícone de pasta seguido por Managed by Work (...).

Observação

O suporte para WebView2 em documentos habilitados para WIP foi adicionado com o build 16.0.16626.20132. Se você estiver em um build mais antigo, seu runtime será padrão para EdgeHTML (Versão Prévia do Microsoft Edge), independentemente da política.