Поделиться через


WebView2 в приложениях WinUI 2 (UWP)

Следующие рекомендации относятся к WebView2 в приложениях WinUI 2 (UWP). Элемент управления WinUI 2 (UWP) WebView2 находится в разработке.

Пользовательский интерфейс автозаполнения

Пользовательский интерфейс автозаполнения еще не реализован для WebView2 для приложений UWP.

См. также:

Для печати в PDF требуется, чтобы у приложения был доступ к расположению, которое можно записывать в UWP, например к локальной папке. Полный список путей, доступных для UWP, см. в разделе Разрешения на доступ к файлам.

См. также:

Печать по умолчанию

Печать по умолчанию отключена для WebView2 для приложений UWP. Однако можно записать и распечатать текущее окно просмотра, вызвав .CapturePreview

См. также:

SmartScreen

WebView2 отправляет URL-адреса, по которым осуществляется переход в приложении, в службу SmartScreen , чтобы обеспечить безопасность клиентов. Если вы хотите отключить эту навигацию, это можно сделать с помощью переменной среды:

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

Эта переменная среды должна быть задана перед CoreWebView2 созданием, которое происходит при первоначальном задании свойства WebView2.Source или вызове метода WebView2.EnsureCoreWebView2Async .

Скачивание файлов

Существует несколько известных ограничений для текущего поведения загрузки для WebView2 в UWP.

Сохранить как

Сохранение файлов с помощью функции "Сохранить как " работает и включено для WebView2 для приложений UWP. Файлы будут сохранены в папке, которую выберет пользователь.

Папка, в которую загружаются файлы

Если узел не изменяет ResultFilePath значение загруженного файла, скачанные файлы будут загружены во вложенную папку с именем пакета приложения в папке Downloads .

Если узел изменяет ResultFilePath значение скачаемого файла, файл будет скачан только в том случае, если приложение имеет доступ к нему по умолчанию. Если вы хотите использовать расположение файла, к которому приложение по умолчанию не имеет доступа, необходимо задать соответствующую возможность. См . статью Объявления возможностей приложений в документации по UWP.

Центр загрузок

Открытие файлов и папок из Центра загрузок отключено. Щелкнув значок файла или папки, соответствующий файл или папку не откроется.

См. также:

Ограничение XAML

Поддержка XAML Island требует дополнительной работы и может рассматриваться для будущих выпусков.

Настройка DefaultBackgroundColor

В WinUI 2 DefaultBackgroundColor свойство не предоставляется напрямую. Вы можете задать цвет фона по умолчанию, задав переменную среды следующим образом:

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

См. также:

Настройка прозрачности

В WinUI 2 прозрачность достигается путем установки цвета в .00FFFFFF

Курсоры CSS

В WinUI 2 (UWP) курсоры CSS имеют следующие ограничения.

URL-адреса изображений

Курсор CSS не может быть URL-адресом изображения, например cursor: url(https://contoso.com/cursor.png), pointer;. См . статью CSS — курсор, загруженный из URL-адреса, не работает.

Предопределенные курсоры CSS

В WinUI 2 (UWP) некоторые предопределенные курсоры CSS не поддерживаются. Курсоры CSS можно использовать для изменения курсора на некоторые из предопределенных курсоров, например cursor: wait; или cursor: crosshair;, но не на другие, например cursor: progress или cursor: none.

Ключевое слово Поддержка
Общие
Авто ✔️
default ✔️
none
Состояние & ссылок
контекстное меню ✔️
Справка ✔️
указатель ✔️
progress
ждать ✔️
Selection
ячейка
Перекрестие ✔️
текст ✔️
вертикальный текст
Перетаскивание &
псевдоним
копировать
move ✔️
no-drop ✔️
Запрещено ✔️
хватать
Захвата
Изменение размера & прокрутки
all-scroll ✔️
col-resize
изменение размера строки
n-изменение размера ✔️
e-resize ✔️
S-изменение размера ✔️
w-изменение размера ✔️
ne-resize ✔️
nw-resize ✔️
se-resize ✔️
sw-resize ✔️
ew-resize ✔️
ns-resize ✔️
nesw-resize ✔️
nwse-resize ✔️
Масштабирование
увеличение масштаба
Уменьшение масштаба

См. также:

  • Курсоры CSS— в разделе Значения описаны приведенные выше ключевое слово значения.

Средства разработчика Microsoft Edge

В WinUI 2 средства разработки Microsoft Edge нельзя запустить в приложении WebView2 WinUI 2 (UWP) с подписью магазина. Однако эту проблему можно обойти с помощью удаленной отладки. См. раздел Удаленная отладка приложений WebView2 WinUI 2 (UWP).

Ограничения API

Следующие классы недоступны в WinUI 2:

  • CoreWebView2EnvironmentOptions
  • CoreWebView2ControllerOptions

См. также

Справочник по API:

Документация По Windows:

MDN:

Репозиторий WebView2Feedback: