WebEngineSettings QML Type

允许配置浏览器属性和属性。更多

Import Statement: import QtWebEngine
Since: QtWebEngine 1.1

属性

详细说明

WebEngineSettings 类型可用于配置浏览器属性和通用属性,如 JavaScript 支持、聚焦行为和远程内容访问。该类型不可创建,但可通过WebEngine.settings 属性访问所有网络引擎视图的默认设置。

每个网络引擎视图都可以有单独的设置,可通过WebEngineView.settings 属性访问。

属性文档

accelerated2dCanvasEnabled : bool [since QtWebEngine 1.3]

指定 HTML 5 2D 画布是否应为 OpenGL 帧缓冲区。这将加快许多绘制操作的速度,但会减慢像素访问速度。

如果可用,默认已启用。

此属性在 QtWebEngine 1.3 中引入。


allowGeolocationOnInsecureOrigins : bool [since QtWebEngine 1.5]

自 Qt 5.7 以来,只有 HTTPS 等安全来源才能请求地理位置功能。此属性提供了一个覆盖,允许非安全起源再次访问 Geolocation。

默认已禁用。

此属性在 QtWebEngine 1.5 中引入。


allowRunningInsecureContent : bool [since QtWebEngine 1.4]

默认情况下,HTTPS 页面无法从 HTTP URL 运行 JavaScript、CSS、插件或 web-sockets。这在以前是可以实现的,因此该属性提供了一个重载,以获得以前的行为。

默认禁用。

此属性在 QtWebEngine 1.4 中引入。


allowWindowActivationFromJavaScript : bool [since QtWebEngine 1.6]

允许使用 JavaScript 中的 window.focus() 方法。默认禁用。

该属性在 QtWebEngine 1.6 中引入。


autoLoadIconsForPage : bool [since QtWebEngine 1.3]

自动下载网页图标。

默认已启用。

该属性在 QtWebEngine 1.3 中引入。


autoLoadImages : bool

在网页上自动加载图像。

默认已启用。


defaultTextEncoding : string [since QtWebEngine 1.2]

设置默认编码。该值必须是描述编码的字符串,如 "utf-8 "或 "iso-8859-1"。

如果留空,将使用默认值。

此属性在 QtWebEngine 1.2 中引入。


dnsPrefetchEnabled : bool [since QtWebEngine 1.8]

在激活 HTML 链接之前,启用推测性预取 DNS 记录。

默认已禁用。

此属性在 QtWebEngine 1.8 中引入。


errorPageEnabled : bool

启用显示 Chromium 的内置错误页面。

默认已启用。


focusOnNavigationEnabled : bool [since QtWebEngine 1.4]

每当发生导航操作(加载、停止、重新加载、重新加载并绕过缓存、前进、后退、设置内容等)时,焦点会被赋予视图。

默认禁用。

该属性在 QtWebEngine 1.4 中引入。


forceDarkMode : bool [since QtWebEngine 6.7]

自动使用深色主题渲染所有网页内容。

默认已禁用。

该属性在 QtWebEngine 6.7 中引入。


fullscreenSupportEnabled : bool [since QtWebEngine 1.2]

告诉网络引擎此应用程序是否支持全屏。

默认已禁用。

该属性在 QtWebEngine 1.2 中引入。


hyperlinkAuditingEnabled : bool

启用对超链接的ping 属性的支持。

默认已禁用。


imageAnimationPolicy : enumeration [since QtWebEngine 6.8]

指定在渲染图像帧动画时应如何处理图像动画。

常量说明
WebEngineSettings.ImageAnimationPolicy.Allow在渲染图像帧时允许所有图像动画。
WebEngineSettings.ImageAnimationPolicy.AnimateOnce在渲染图像帧时为图像设置一次动画。
WebEngineSettings.ImageAnimationPolicy.Disallow渲染图像帧时禁止所有图像动画。

默认值是WebEngineSettings.ImageAnimationPolicy.Allow

该属性在 QtWebEngine 6.8 中引入。


javascriptCanAccessClipboard : bool

允许 JavaScript 程序将经过消毒的内容写入(复制)剪贴板。通过writewriteText JavaScript Clipboard API 调用进行消毒写入,且必须伴随用户操作。

未经校验的写入和从剪贴板读取则通过javascriptCanPaste 启用。

在 Chromium 版本 81 之前,该设置启用了所有剪贴板写入功能。

由于不受限制的剪贴板访问存在潜在的安全隐患,因此建议应用程序禁用此设置,并响应ClipboardReadWrite 功能的权限请求。

默认已禁用。


javascriptCanOpenWindows : bool

允许 JavaScript 程序在不与用户交互的情况下打开弹出窗口。

默认已启用。


javascriptCanPaste : bool [since QtWebEngine 1.7]

允许 JavaScript 程序从剪贴板读取(粘贴)和写入未经消毒的内容。经过消毒的写入是通过writewriteText JavaScript 剪贴板 API 调用完成的,必须伴随用户操作;未经消毒的写入是指不符合这些标准的任何写入。

要使该设置有效,还必须启用javascriptCanAccessClipboard

由于不受限制的剪贴板访问存在潜在的安全隐患,建议应用程序禁用此功能,并响应ClipboardReadWrite 功能的权限请求。

默认禁用。

此属性在 QtWebEngine 1.7 中引入。


javascriptEnabled : bool

启用 JavaScript 程序的运行。

默认已启用。


linksIncludedInFocusChain : bool

在键盘焦点链中包含超链接。

默认已启用。


localContentCanAccessFileUrls : bool

允许本地加载的文档访问其他本地 URL。

默认已启用。


localContentCanAccessRemoteUrls : bool

允许本地加载的文档访问远程 URL。

默认已禁用。


localStorageEnabled : bool

启用对 HTML 5 本地存储功能的支持。

默认已启用。


指定可通过在视图上拖放 URL 来触发导航。

默认已启用。

该属性在 QtWebEngine 6.4 中引入。


pdfViewerEnabled : bool [since QtWebEngine 1.9]

指定 PDF 文档将在内部 PDF 查看器中打开,而不是下载。

默认已启用。

该属性在 QtWebEngine 1.9 中引入。


playbackRequiresUserGesture : bool [since QtWebEngine 1.7]

在用户与页面交互之前禁止播放媒体内容。

默认情况下,QtWebEngine 使用 Chromium 设置,如自动播放策略更改中所述。要覆盖默认行为,必须将此属性设置为false

注: 启用时,行为类似于 Android 上的 Chrome 浏览器;禁用时,类似于台式机上的 Chrome 浏览器。

此属性在 QtWebEngine 1.7 中引入。


pluginsEnabled : bool

启用对 Pepper 插件(如 Flash 播放器)的支持。

默认已禁用。


preferCSSMarginsForPrinting : bool [since QtWebEngine 6.9]

在打印网页时,开启 CSS 边距优于默认 (0, 0, 0, 0) 大小。

默认已禁用。

此属性在 QtWebEngine 6.9 中引入。


printElementBackgrounds : bool [since QtWebEngine 1.4]

打印网页时打开 CSS 背景打印。

默认已启用。

此属性在 QtWebEngine 1.4 中引入。


printHeaderAndFooter : bool [since QtWebEngine 6.9]

指定打印结果将在页眉和页脚区域包含基本页面信息(URL、标题、日期、页码)。嵌入者有责任通过设置适当的上下边距为这些文本提供足够的空间。

默认禁用。

此属性在 QtWebEngine 6.9 中引入。


readingFromCanvasEnabled : bool [since QtWebEngine 6.6]

指定启用从所有画布元素读取数据。

此设置将影响所有 HTML5 画布元素,无论其来源如何,禁用此设置可防止画布指纹。

默认已启用。

此属性在 QtWebEngine 6.6 中引入。


screenCaptureEnabled : bool [since QtWebEngine 1.3]

告诉网络引擎此应用程序是否支持屏幕捕捉。

默认已禁用。

该属性在 QtWebEngine 1.3 中引入。


scrollAnimatorEnabled : bool [since QtWebEngine 6.8]

启用动画滚动。

默认已禁用。

该属性在 QtWebEngine 6.8 中引入。


showScrollBars : bool [since QtWebEngine 1.6]

显示滚动条。默认已启用。

该属性在 QtWebEngine 1.6 中引入。


spatialNavigationEnabled : bool

启用空间导航功能,即通过使用左、右、上、下方向键在网页上的可聚焦元素(如超链接和表单控件)之间导航。

举例来说,如果用户按下右键,启发式导航功能会判断他们是否想在右边找到某个元素,以及他们可能想要哪个元素。

默认已禁用。


touchEventsApiEnabled : bool [since QtWebEngine 6.9]

启用对 JavaScript 触摸事件 API 的支持,这意味着ontouchstartontouchendontouchmove 处理程序将出现在document.window 对象中。

请注意,有些网站使用此 API 来决定是在移动设备上运行还是在台式机上运行,并以此为基础进行设计。这可能会在触摸屏笔记本电脑或其他模拟假触摸设备的设置上造成不必要的结果。

如果系统检测到触摸设备,则默认启用,否则禁用。

此属性在 QtWebEngine 6.9 中引入。


touchIconsEnabled : bool [since QtWebEngine 1.3]

启用对触摸图标和预合成触摸图标的支持。

默认情况下禁用。

此属性在 QtWebEngine 1.3 中引入。


unknownUrlSchemePolicy : enumeration [since QtWebEngine 1.7]

指定如何处理对未知方案的 URL 的导航请求。

常量说明
WebEngineSettings.DisallowUnknownUrlSchemes禁止所有指向未知方案 URL 的导航请求。
WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction允许通过用户交互(如鼠标点击)向未知方案的 URL 发送导航请求,而抑制其他导航请求(如 JavaScript)。
WebEngineSettings.AllowAllUnknownUrlSchemes允许对未知方案 URL 的所有导航请求。

默认值为WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction

该属性在 QtWebEngine 1.7 中引入。


webGLEnabled : bool [since QtWebEngine 1.3]

启用对 HTML 5 WebGL 的支持。

如果可用,默认已启用。

此属性在 QtWebEngine 1.3 中引入。


webRTCPublicInterfacesOnly : bool [since QtWebEngine 1.7]

将 WebRTC 仅限于公共 IP 地址。禁用时,WebRTC 也可以使用本地网络 IP 地址,但远程主机也可以看到您的本地网络 IP 地址。

默认已禁用。

此属性在 QtWebEngine 1.7 中引入。


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.