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

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

Подробное содержание:

• Пользовательский интерфейс автозаполнения
• Функция "Сохранить в формате PDF"
• Печать по умолчанию
• Фильтр SmartScreen
• Загрузка файлов
  • Сохранить как
  • папка, в которую скачиваются файлы;
  • Центр загрузок
• Ограничение XAML
• Настройка DefaultBackgroundColor
• Настройка прозрачности
• Курсоры CSS
  • URL-адреса изображений
  • Предопределенные курсоры CSS
• Средства разработчика Microsoft Edge
• Ограничения API
• См. также

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

Пользовательский интерфейс автозаполнения еще не реализован для 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 property (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: crosshair;, но не на другие, такие как cursor: wait;cursor: progress или .cursor: none

Ключевое слово	Поддержка
Общая информация:
auto	✔️ Нет
default	✔️ Нет
none	Нет ❌
Ссылки и состояние:
context-menu	✔️ Нет
help	✔️ Нет
pointer	✔️ Нет
progress	Нет ❌
wait	✔️ Нет
Выбор:
cell	Нет ❌
crosshair	✔️ Нет
text	✔️ Нет
vertical-text	Нет ❌
Перетащите нужные элементы.
alias	Нет ❌
copy	Нет ❌
move	✔️ Нет
no-drop	✔️ Нет
not-allowed	✔️ Нет
grab	Нет ❌
grabbing	Нет ❌
Изменение размера и прокрутка:
all-scroll	✔️ Нет
col-resize	Нет ❌
row-resize	Нет ❌
n-resize	✔️ Нет
e-resize	✔️ Нет
s-resize	✔️ Нет
w-resize	✔️ Нет
ne-resize	✔️ Нет
nw-resize	✔️ Нет
se-resize	✔️ Нет
sw-resize	✔️ Нет
ew-resize	✔️ Нет
ns-resize	✔️ Нет
nesw-resize	✔️ Нет
nwse-resize	✔️ Нет
Масштабирование:
zoom-in	Нет ❌
zoom-out	Нет ❌

См. также:

• Курсоры 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
• Объявление возможностей приложения

МДН:

• Значения в свойстве CSS курсора в MDN.

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

• CSS - курсор, загруженный с URL-адреса, не работает