WebView2 в приложениях WinUI 2 (UWP)
Следующие рекомендации относятся к WebView2 в приложениях WinUI 2 (UWP). Элемент управления WinUI 2 (UWP) WebView2 находится в разработке.
Пользовательский интерфейс автозаполнения
Пользовательский интерфейс автозаполнения еще не реализован для WebView2 для приложений UWP.
См. также:
- Автозаполнение в обзоре API WebView2.
Сохранить в формате PDF
Для печати в PDF требуется, чтобы у приложения был доступ к расположению, которое можно записывать в UWP, например к локальной папке. Полный список путей, доступных для UWP, см. в разделе Разрешения на доступ к файлам.
См. также:
- Печать в обзоре API WebView2.
Печать по умолчанию
Печать по умолчанию отключена для WebView2 для приложений UWP. Однако можно записать и распечатать текущее окно просмотра, вызвав .CapturePreview
См. также:
- Запись изображений в обзоре API WebView2.
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.
Центр загрузок
Открытие файлов и папок из Центра загрузок отключено. Щелкнув значок файла или папки, соответствующий файл или папку не откроется.
См. также:
- Загрузки в обзоре API WebView2.
Ограничение XAML
Поддержка XAML Island требует дополнительной работы и может рассматриваться для будущих выпусков.
Настройка DefaultBackgroundColor
В WinUI 2 DefaultBackgroundColor
свойство не предоставляется напрямую. Вы можете задать цвет фона по умолчанию, задав переменную среды следующим образом:
Environment.SetEnvironmentVariable("WEBVIEW2_DEFAULT_BACKGROUND_COLOR", "FF000000");
См. также:
- .NET: Свойство WebView2.DefaultBackgroundColor
- Win32: свойство ICoreWebView2Controller2::D efaultBackgroundColor (get, put)
Настройка прозрачности
В 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 WebView2.
- Печать в обзоре API WebView2.
- Запись изображений в обзоре API WebView2.
- Загрузки в обзоре API WebView2.
- Удаленная отладка приложений WebView2 WinUI 2 (UWP)
Справочник по API:
- .NET: Свойство WebView2.DefaultBackgroundColor
- Win32: ICoreWebView2Controller2::_getDefaultBackgroundColor
- Win32: ICoreWebView2Controller2::_putDefaultBackgroundColor
Документация По Windows:
- SmartScreen
- Свойство WebView2.Source
- Метод WebView2.EnsureCoreWebView2Async
- Объявления возможностей приложения
MDN:
- Значения в свойстве CSS курсора в MDN.
Репозиторий WebView2Feedback: