WebView2 em aplicativos WinUI 2 (UWP)

As considerações a seguir se aplicam ao WebView2 em aplicativos WinUI 2 (UWP). O controle WebView2 WinUI 2 (UWP) está em desenvolvimento.

Conteúdo detalhado:

IU de preenchimento automático

A interface do usuário de preenchimento automático ainda não foi implementada para o WebView2 para aplicativos UWP.

Veja também:

Imprimir em PDF exige que o aplicativo tenha acesso a um local gravável em UWP, como uma pasta local. Para obter uma lista completa de caminhos acessíveis pela UWP, consulte Permissões de acesso a arquivos.

Veja também:

  • Impressão em Visão geral das APIs do WebView2.

Impressão padrão

A impressão padrão está desabilitada para WebView2 para aplicativos UWP. No entanto, você pode capturar e imprimir o visor atual chamando CapturePreview.

Veja também:

SmartScreen

O WebView2 envia URLs que são acessadas em seu aplicativo para o serviço SmartScreen , para garantir que seus clientes permaneçam seguros. Se você quiser desabilitar essa navegação, poderá fazê-lo por meio de uma variável de ambiente:

  • Environment.SetEnvironmentVariable("WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS", "--disable-features=msSmartScreenProtection");

Essa variável de ambiente deve ser definida antes da criação, o CoreWebView2 que ocorre quando a propriedade WebView2.Source é definida inicialmente ou o método WebView2.EnsureCoreWebView2Async é chamado inicialmente.

Baixar arquivos

Há algumas limitações conhecidas para o comportamento de downloads atual do WebView2 na UWP.

Salvar como

Salvar arquivos por meio de Salvar como está funcionando e está habilitado para WebView2 para aplicativos UWP. Os arquivos serão salvos na pasta que o usuário selecionar.

Em qual pasta os arquivos são baixados

Se o host não alterar ResultFilePath o arquivo baixado, os arquivos baixados serão baixados para uma subpasta com o nome do pacote do Downloads aplicativo na pasta.

Se o host alterar ResultFilePath o arquivo baixado, o arquivo só será baixado se o aplicativo tiver acesso a esse caminho de arquivo por padrão. Se você quiser usar um local de arquivo ao qual o aplicativo não tem acesso por padrão, deverá definir a funcionalidade correspondente. Consulte Declarações de recursos do aplicativo na documentação da UWP.

Downloads Hub

A abertura de arquivos e pastas do Hub de Downloads está desabilitada. Clicar no ícone de arquivo ou pasta não abrirá o respectivo arquivo/pasta.

Veja também:

  • Downloads na visão geral das APIs do WebView2.

Limitação XAML

O suporte à Ilha XAML requer trabalho adicional e pode ser considerado para versões futuras.

Definindo DefaultBackgroundColor

No WinUI 2, a DefaultBackgroundColor propriedade não é exposta diretamente. Você pode definir a cor da tela de fundo padrão definindo uma variável de ambiente, da seguinte maneira:

Environment.SetEnvironmentVariable("WEBVIEW2_DEFAULT_BACKGROUND_COLOR", "FF000000");

Veja também:

Definindo a transparência

No WinUI 2, a transparência é obtida definindo a cor para 00FFFFFF.

Cursores CSS

No WinUI 2 (UWP), os cursores CSS têm as seguintes limitações.

URLs de imagem

O cursor CSS não pode ser um URL de imagem, como cursor: url(https://contoso.com/cursor.png), pointer;. Veja CSS - cursor carregado do URL não funciona.

Cursores CSS predefinidos

No WinUI 2 (UWP), alguns dos cursores CSS predefinidos não têm suporte. Você pode usar cursores CSS para alterar o cursor para alguns dos cursores predefinidos, como cursor: wait; ou cursor: crosshair;, mas não para outros, como cursor: progress ou cursor: none.

Palavra-chave Com suporte?
Geral:
auto ✔️ Sim
default ✔️ Sim
none Não ❌
Links e status:
context-menu ✔️ Sim
help ✔️ Sim
pointer ✔️ Sim
progress Não ❌
wait ✔️ Sim
Seleção:
cell Não ❌
crosshair ✔️ Sim
text ✔️ Sim
vertical-text Não ❌
Arrastar e soltar:
alias Não ❌
copy Não ❌
move ✔️ Sim
no-drop ✔️ Sim
not-allowed ✔️ Sim
grab Não ❌
grabbing Não ❌
Redimensionamento e rolagem:
all-scroll ✔️ Sim
col-resize Não ❌
row-resize Não ❌
n-resize ✔️ Sim
e-resize ✔️ Sim
s-resize ✔️ Sim
w-resize ✔️ Sim
ne-resize ✔️ Sim
nw-resize ✔️ Sim
se-resize ✔️ Sim
sw-resize ✔️ Sim
ew-resize ✔️ Sim
ns-resize ✔️ Sim
nesw-resize ✔️ Sim
nwse-resize ✔️ Sim
Zoom:
zoom-in Não ❌
zoom-out Não ❌

Veja também:

  • Cursores CSS - A seção Valores descreve os valores de palavra-chave acima.

Ferramentas de Desenvolvedor do Microsoft Edge

No WinUI 2, o DevTools do Microsoft Edge não pode ser iniciado dentro de um aplicativo WebView2 WinUI 2 (UWP) assinado pelo repositório. No entanto, você pode contornar isso usando a depuração remota. Consulte Depuração remota de aplicativos WebView2 WinUI 2 (UWP).

Limitações da API

As seguintes classes não estão acessíveis no WinUI 2:

  • CoreWebView2EnvironmentOptions
  • CoreWebView2ControllerOptions

Confira também

Referência da API:

Documentos do Windows:

MDN:

  • Valores na propriedade CSS do cursor no MDN.

Repositório WebView2Feedback:

  • Last updated on