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.

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:

• Preenchimento automático na Visão geral das APIs do WebView2.

Imprimir para PDF

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:

• Captura de imagem em Visão geral das APIs do WebView2.

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:

• .NET: Propriedade WebView2.DefaultBackgroundColor
• Win32: Propriedade ICoreWebView2Controller2::D efaultBackgroundColor (get, put)

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.

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

• Preenchimento automático na Visão geral das APIs do WebView2.
• Impressão em Visão geral das APIs do WebView2.
• Captura de imagem em Visão geral das APIs do WebView2.
• Downloads na visão geral das APIs do WebView2.
• Depuração remota de aplicativos WebView2 WinUI 2 (UWP)

Referência da API:

• .NET: Propriedade WebView2.DefaultBackgroundColor
• Win32: ICoreWebView2Controller2::_getDefaultBackgroundColor
• Win32: ICoreWebView2Controller2::_putDefaultBackgroundColor

Documentos do Windows:

• SmartScreen
• Propriedade WebView2.Source
• Método WebView2.EnsureCoreWebView2Async
• Declarações de funcionalidade do aplicativo

MDN:

• Valores na propriedade CSS do cursor no MDN.

Repositório WebView2Feedback:

• CSS - o cursor carregado da URL não funciona