SDK de pré-lançamento 1.0.3079-pré-lançamento, para Runtime 134 (24 de janeiro de 2025)

Notas de versão do SDK de pré-lançamento do Microsoft Edge WebView2, data de lançamento: 24 de janeiro de 2025.

Pacote NuGet para WebView2 SDK 1.0.3079-prerelease

Para compatibilidade total com a API, esta versão de pré-lançamento do SDK do WebView2 requer o WebView2 Runtime que vem com o Microsoft Edge versão 134.0.3079.0 ou posterior; consulte Runtime 134.0.3124.44 (10 de março de 2025).

Conteúdo detalhado:

APIs Experimentais (Fase 1: Experimental no Pré-lançamento)

As seguintes APIs experimentais foram adicionadas neste SDK de pré-lançamento.

Personalizar o comportamento de localização (API de Localização)

A API Find permite controlar programaticamente as operações Find e permite adicionar a seguinte funcionalidade ao seu aplicativo:

  • Personalize as opções de Localizar, incluindo Localizar Termo, Distinção entre maiúsculas e minúsculas, Correspondência de Word, Realce de correspondência e Supressão de interface do usuário padrão.
  • Localizar cadeias de caracteres de texto e navegar entre elas em um controle WebView2.
  • Inicie programaticamente operações de Localização e navegue pelos resultados de Localizar .
  • Suprimir a interface do usuário padrão do Finder .
  • Acompanhe o status das operações Localizar.

Há problemas conhecidos com a API Find para documentos PDF. Quando você exibe um documento PDF em um controle WebView2, o recurso Localizar atualmente fornece apenas o primeiro índice e o número de correspondências encontradas. Por exemplo, se a cadeia de caracteres ocorrer três vezes em um PDF, a interface do usuário dirá 1/3 e não dará suporte à chamada programática de Next ou Previous. Estamos investigando ativamente esses problemas e encorajamos você a relatar quaisquer problemas que encontrar, usando o repositório WebView2Feedback .

Personalizar o comportamento de arrastar e soltar (API DragStarting)

A DragStarting API substitui o comportamento padrão de arrastar e soltar ao executar no modo de hospedagem visual. O DragStarting evento notifica seu aplicativo quando o usuário inicia uma operação de arrastar no WebView2 e fornece o estado necessário para substituir a operação de arrastar WebView2 padrão por sua própria lógica.

  • Use DragStarting no ICoreWebView2ExperimentalCompositionController6 para adicionar um manipulador de eventos que é invocado quando a operação de arrastar está começando.
  • Use ICoreWebView2ExperimentalDragStartingEventArgs para iniciar sua própria operação de arrastar.
    • Use o GetDeferral método para executar qualquer lógica de arrastar assíncrona e chamar de volta para o WebView posteriormente.
    • Use a Handled propriedade para permitir que o WebView2 saiba se deve usar sua própria lógica de arrastar.

Acompanhar o histórico de navegação para iframes aninhados (API FrameCreatedEvent)

A API FrameCreatedEvent dá suporte a iframes aninhados, como registrar o histórico de navegação para um iframe de segundo nível. Sem essa API, o WebView2 rastreia apenas iframes de primeiro nível, que são os iframes filho diretos do quadro principal. Usando essa API, seu aplicativo pode assinar o evento de criação de iframe aninhado, dando ao aplicativo acesso a todas as propriedades, métodos e eventos do CoreWebView2Frame iframe aninhado.

Use essa API para gerenciar o rastreamento de iframe em uma página que contém vários níveis de iframes. Você pode optar por acompanhar qualquer um dos seguintes:

  • Apenas a página principal e os iframes de primeiro nível (o comportamento padrão).
  • Uma árvore de quadros WebView2 parcial com iframes específicos de interesse.
  • A árvore completa de quadros do WebView2.

Definir a cor da tela de fundo padrão na inicialização do WebView2 (API DefaultBackgroundColor)

A API DefaultBackgroundColor permite que os usuários definam a DefaultBackgroundColor propriedade na inicialização. Isso evita um flash branco perturbador durante o processo de carregamento do WebView2.

Promoções para a Fase 2 (Estável no Pré-lançamento)

As seguintes APIs foram promovidas da Fase 1: Experimental no Pré-lançamento, para a Fase 2: Estável no Pré-lançamento, e estão incluídas neste SDK de Pré-lançamento.

Mostrar elementos WPF na parte superior da camada WebView2 (WebView2CompositionControl)

Isso WebView2CompositionControl impede que o controle WebView2 seja a camada superior em um aplicativo WPF e obscureça qualquer elemento WPF. Microsoft.Web.WebView2.Wpf.WebView2CompositionControl é uma substituição imediata para o controle WPF WebView2 padrão. O controle WebView2 e implementa WebView2CompositionControl a Microsoft.Web.WebView2.Wpf.IWebView2 interface. Ambos derivam de FrameworkElement, da seguinte forma:

  • FrameworkElement ->HwndHost ->WebView2.
  • FrameworkElement ->Control ->WebView2CompositionControl.

Contexto: se você estiver criando um aplicativo WPF (Windows Presentation Foundation) e usando o controle WebView2, poderá descobrir que seu aplicativo enfrenta problemas de "espaço aéreo", em que o controle WebView2 é sempre exibido na parte superior, ocultando todos os elementos WPF no mesmo local, mesmo se você tentar especificar os elementos WPF para estarem acima do controle WebView2 (usando a ordem da árvore visual ou a propriedade z-index, por exemplo).

Esse problema ocorre porque o controle WPF usa o WPF HwndHost para hospedar o controle Win32 WebView2 e HwndHost tem um problema com o espaço aéreo.

A fase anterior não está nas notas de versão.

Veja também:

Correções de bugs

  • Correção de um problema no WPF WebView2CompositionControl em que ele não é exibido se ele é inicializado com tamanho (0,0), como quando é inicializado em um TabItem de a TabControl. (Problema #4941)

Confira também