WinUI 2 中的 WebView2 (UWP) 应用

以下注意事项适用于 WinUI 2 (UWP) 应用中的 WebView2。 WebView2 WinUI 2 (UWP) 控件正在开发中。

详细内容:

自动填充 UI

尚未为适用于 UWP 应用的 WebView2 实现自动填充 UI。

另请参阅:

打印到 PDF 要求应用有权访问 UWP 中的可写位置,例如本地文件夹。 有关 UWP 可访问路径的完整列表,请参阅 文件访问权限。

另请参阅:

默认打印

对于 UWP 应用,WebView2 已禁用默认打印。 但是,可以通过调用 CapturePreview来捕获和打印当前视区。

另请参阅:

SmartScreen

WebView2 将应用程序中导航到的 URL 发送到 SmartScreen 服务,以确保客户保持安全。 如果要禁用此导航,可以通过环境变量执行此操作:

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

必须在创建之前 CoreWebView2 设置此环境变量,这在最初设置 WebView2.Source 属性 或最初调用 WebView2.EnsureCoreWebView2Async 方法 时发生。

下载文件

UWP 中 WebView2 的当前下载行为存在一些已知限制。

另存为

通过 另存为 保存文件正常工作,并且已为 UWP 应用的 WebView2 启用。 文件将保存在用户选择的文件夹中。

文件下载到哪个文件夹

如果主机不更改 ResultFilePath 已下载文件,则下载的文件将下载到具有 Downloads 该文件夹中应用程序包名称的子文件夹。

如果主机更改 ResultFilePath 已下载文件,则仅当应用默认有权访问该文件路径时,才会下载该文件。 如果要使用默认情况下应用无权访问的文件位置,则必须设置相应的功能。 请参阅 UWP 文档中的 应用功能声明 。

下载中心

禁止从下载中心打开文件和文件夹。 单击文件或文件夹图标不会打开相应的文件/文件夹。

另请参阅:

  • WebView2 API 概述中的下载。

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; OR cursor: crosshair;,但不能更改为其他光标,如 cursor: progress OR 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 光标 - “值”部分描述了上述关键字 (keyword) 值。

Microsoft Edge 开发人员工具

在 WinUI 2 上,无法在应用商店签名的 WebView2 WinUI 2 (UWP) 应用中启动 Microsoft Edge 开发工具。 但是,可以通过使用远程调试来解决此问题。 请参阅 远程调试 WebView2 WinUI 2 (UWP) 应用。

API 限制

以下类在 WinUI 2 中不可访问:

  • CoreWebView2EnvironmentOptions
  • CoreWebView2ControllerOptions

另请参阅

API 参考:

Windows 文档:

MDN:

  • MDN 的光标 CSS 属性中的值。

WebView2Feedback 存储库: