Partilhar via

WebView2 em aplicações WinUI 2 (UWP)

  • Artigo

As seguintes considerações aplicam-se ao WebView2 nas aplicações WinUI 2 (UWP). O controlo WebView2 WinUI 2 (UWP) está em desenvolvimento.

IU de Preenchimento Automático

A IU de preenchimento automático ainda não está implementada para WebView2 para aplicações UWP.

Veja também:

Imprimir em PDF requer que a aplicação tenha acesso a uma localização gravável no UWP, como uma pasta local. Para obter uma lista completa dos caminhos acessíveis para UWP, veja Permissões de acesso a ficheiros.

Veja também:

  • Imprimir na Descrição Geral das APIs webView2.

Impressão predefinida

A impressão predefinida está desativada para WebView2 para aplicações UWP. No entanto, pode capturar e imprimir a viewport atual ao chamar CapturePreview.

Veja também:

SmartScreen

O WebView2 envia URLs para os quais navegam na sua aplicação para o serviço SmartScreen , para garantir que os seus clientes se mantêm seguros. Se quiser desativar esta navegação, pode fazê-lo através de uma variável de ambiente:

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

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

A transferir ficheiros

Existem algumas limitações conhecidas para o comportamento de transferências atuais do WebView2 no UWP.

Salvar como

Guardar ficheiros através de Guardar Como está a funcionar e está ativado para WebView2 para aplicações UWP. Os ficheiros serão guardados na pasta que o utilizador selecionar.

Para que pasta os ficheiros são transferidos

Se o anfitrião não alterar o ResultFilePath ficheiro transferido, os ficheiros transferidos serão transferidos para uma subpasta com o nome do pacote de aplicação na Downloads pasta.

Se o anfitrião alterar o ResultFilePath do ficheiro transferido, o ficheiro só será transferido se a aplicação tiver acesso a esse caminho de ficheiro por predefinição. Se quiser utilizar uma localização de ficheiro à qual a aplicação não tem acesso por predefinição, tem de definir a capacidade correspondente. Veja Declarações de capacidade da aplicação na documentação do UWP.

Hub de Transferências

A abertura de ficheiros e pastas a partir do Hub de Transferências está desativada. Clicar no ícone de ficheiro ou pasta não abre o respetivo ficheiro/pasta.

Veja também:

Limitação de XAML

O suporte da Ilha XAML requer trabalho adicional e pode ser considerado para lançamentos futuros.

PredefinirBackgroundColor

No WinUI 2, a DefaultBackgroundColor propriedade não é exposta diretamente. Pode definir a cor de fundo predefinida ao definir uma variável de ambiente da seguinte forma:

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

Veja também:

Definir transparência

No WinUI 2, a transparência é obtida ao definir a cor como 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 – o cursor carregado a partir do URL não funciona.

Cursores CSS predefinidos

No WinUI 2 (UWP), alguns dos cursores de CSS predefinidos não são suportados. Pode utilizar 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
Automático ✔️
Padrão. ✔️
none ❌
Ligações & status
menu de contexto ✔️
Ajuda ✔️
ponteiro ✔️
progresso ❌
aguardar ✔️
Selection
célula ❌
mira ✔️
texto ✔️
texto vertical ❌
Arrastar & largar
alias ❌
copiar ❌
move ✔️
sem largar ✔️
não permitido ✔️
agarrar ❌
agarrar ❌
Redimensionar & deslocamento
todo o deslocamento ✔️
redimensionar em colunas ❌
redimensionar linha ❌
n-redimensionar ✔️
redimensionamento eletrónico ✔️
redimensionar s ✔️
w-redimensionar ✔️
ne-resize ✔️
nw-resize ✔️
redimensionar ✔️
redimensionar sw ✔️
ew-resize ✔️
ns-resize ✔️
nesw-resize ✔️
nwse-resize ✔️
A ampliar
ampliar ❌
reduzir ❌

Veja também:

  • Cursores CSS – a secção Valores descreve os valores palavra-chave acima.

Ferramentas de Programador do Microsoft Edge

No WinUI 2, não é possível iniciar o Microsoft Edge DevTools dentro de uma aplicação WebView2 WinUI 2 (UWP) assinada pela loja. No entanto, pode contornar este problema com a depuração remota. Veja Depuração remota de aplicações 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 na MDN.

Repositório WebView2Feedback: