WebEngineSettings QML Type

Allows configuration of browser properties and attributes. 更多...

import 语句：	import QtWebEngine
Since:	QtWebEngine 1.1

所有成员列表，包括继承成员

特性

accelerated2dCanvasEnabled : bool (since QtWebEngine 1.3)
allowGeolocationOnInsecureOrigins : bool (since QtWebEngine 1.5)
allowRunningInsecureContent : bool (since QtWebEngine 1.4)
allowWindowActivationFromJavaScript : bool (since QtWebEngine 1.6)
autoLoadIconsForPage : bool (since QtWebEngine 1.3)
autoLoadImages : bool
defaultTextEncoding : string (since QtWebEngine 1.2)
dnsPrefetchEnabled : bool (since QtWebEngine 1.8)
errorPageEnabled : bool
focusOnNavigationEnabled : bool (since QtWebEngine 1.4)
forceDarkMode : bool (since QtWebEngine 6.7)
fullscreenSupportEnabled : bool (since QtWebEngine 1.2)
hyperlinkAuditingEnabled : bool
javascriptCanAccessClipboard : bool
javascriptCanOpenWindows : bool
javascriptCanPaste : bool (since QtWebEngine 1.7)
javascriptEnabled : bool
linksIncludedInFocusChain : bool
localContentCanAccessFileUrls : bool
localContentCanAccessRemoteUrls : bool
localStorageEnabled : bool
navigateOnDropEnabled : bool (since QtWebEngine 6.4)
pdfViewerEnabled : bool (since QtWebEngine 1.9)
playbackRequiresUserGesture : bool (since QtWebEngine 1.7)
pluginsEnabled : bool
printElementBackgrounds : bool (since QtWebEngine 1.4)
readingFromCanvasEnabled : bool (since QtWebEngine 6.6)
screenCaptureEnabled : bool (since QtWebEngine 1.3)
showScrollBars : bool (since QtWebEngine 1.6)
spatialNavigationEnabled : bool
touchIconsEnabled : bool (since QtWebEngine 1.3)
unknownUrlSchemePolicy : enumeration (since QtWebEngine 1.7)
webGLEnabled : bool (since QtWebEngine 1.3)
webRTCPublicInterfacesOnly : bool (since QtWebEngine 1.7)

详细描述

The WebEngineSettings type can be used to configure browser properties and generic attributes, such as JavaScript support, focus behavior, and access to remote content. This type is uncreatable, but the default settings for all web engine views can be accessed by using the WebEngine.settings 特性。

Each web engine view can have individual settings that can be accessed by using the WebEngineView.settings 特性。

特性文档编制

accelerated2dCanvasEnabled : bool [since QtWebEngine 1.3]

Specifies whether the HTML 5 2D canvas should be an OpenGL framebuffer. This makes many painting operations faster, but slows down pixel access.

Enabled by default if available.

该特性在 QtWebEngine 1.3 引入。

allowGeolocationOnInsecureOrigins : bool [since QtWebEngine 1.5]

Since Qt 5.7, only secure origins such as HTTPS have been able to request Geolocation features. This provides an override to allow non secure origins to access Geolocation again.

Disabled by default.

This property was introduced in QtWebEngine 1.5.

allowRunningInsecureContent : bool [since QtWebEngine 1.4]

By default, HTTPS pages cannot run JavaScript, CSS, plugins or web-sockets from HTTP URLs. This used to be possible and this provides an override to get the old behavior.

Disabled by default.

This property was introduced in QtWebEngine 1.4.

allowWindowActivationFromJavaScript : bool [since QtWebEngine 1.6]

Allows the window.focus() method in JavaScript. Disallowed by default.

This property was introduced in QtWebEngine 1.6.

autoLoadIconsForPage : bool [since QtWebEngine 1.3]

Automatically downloads icons for web pages.

Enabled by default.

该特性在 QtWebEngine 1.3 引入。

autoLoadImages : bool

Automatically loads images on web pages.

Enabled by default.

defaultTextEncoding : string [since QtWebEngine 1.2]

Sets the default encoding. The value must be a string describing an encoding such as "utf-8" or "iso-8859-1".

If left empty, a default value will be used.

This property was introduced in QtWebEngine 1.2.

dnsPrefetchEnabled : bool [since QtWebEngine 1.8]

Enables speculative prefetching of DNS records for HTML links before they are activated.

Disabled by default.

This property was introduced in QtWebEngine 1.8.

errorPageEnabled : bool

Enables displaying the built-in error pages of Chromium.

Enabled by default.

focusOnNavigationEnabled : bool [since QtWebEngine 1.4]

Focus is given to the view whenever a navigation operation occurs (load, stop, reload, reload and bypass cache, forward, backward, set content, and so on).

Disabled by default.

This property was introduced in QtWebEngine 1.4.

forceDarkMode : bool [since QtWebEngine 6.7]

Automatically render all web contents using a dark theme.

Disabled by default.

This property was introduced in QtWebEngine 6.7.

fullscreenSupportEnabled : bool [since QtWebEngine 1.2]

Tells the web engine whether fullscreen is supported in this application or not.

Disabled by default.

This property was introduced in QtWebEngine 1.2.

hyperlinkAuditingEnabled : bool

启用支持 ping attribute for hyperlinks.

Disabled by default.

javascriptCanAccessClipboard : bool

Allows JavaScript programs to read from or write to the clipboard. Writing to the clipboard is always allowed if it is specifically requested by the user.

To enable also the pasting of clipboard content from JavaScript, use javascriptCanPaste .

Disabled by default.

javascriptCanOpenWindows : bool

Allows JavaScript programs to open popup windows without user interaction.

Enabled by default.

javascriptCanPaste : bool [since QtWebEngine 1.7]

启用 JavaScript execCommand("paste") . This also requires enabling javascriptCanAccessClipboard .

Disabled by default.

该特性在 QtWebEngine 1.7 引入。

javascriptEnabled : bool

Enables the running of JavaScript programs.

Enabled by default.

linksIncludedInFocusChain : bool

Includes hyperlinks in the keyboard focus chain.

Enabled by default.

localContentCanAccessFileUrls : bool

Allows locally loaded documents to access other local URLs.

Enabled by default.

localContentCanAccessRemoteUrls : bool

Allows locally loaded documents to access remote URLs.

Disabled by default.

localStorageEnabled : bool

Enables support for the HTML 5 local storage feature.

Enabled by default.

navigateOnDropEnabled : bool [since QtWebEngine 6.4]

Specifies that navigations can be triggered by dropping URLs on the view.

Enabled by default.

This property was introduced in QtWebEngine 6.4.

pdfViewerEnabled : bool [since QtWebEngine 1.9]

Specifies that PDF documents will be opened in the internal PDF viewer instead of being downloaded.

Enabled by default.

This property was introduced in QtWebEngine 1.9.

playbackRequiresUserGesture : bool [since QtWebEngine 1.7]

Inhibits playback of media content until the user interacts with the page.

By default, Qt WebEngine 使用 Chromium 设置，作为描述在自动播放策略变化 . To overwrite the default behavior, this property must be set to false .

注意： The behavior is similar to Chrome on Android when enabled, and similar to Chrome on desktops when disabled.

该特性在 QtWebEngine 1.7 引入。

pluginsEnabled : bool

Enables support for Pepper plugins, such as the Flash player.

Disabled by default.

另请参阅 Pepper 插件 API .

printElementBackgrounds : bool [since QtWebEngine 1.4]

Turns on printing of CSS backgrounds when printing a web page.

Enabled by default.

This property was introduced in QtWebEngine 1.4.

readingFromCanvasEnabled : bool [since QtWebEngine 6.6]

Specifies that reading from all canvas elements is enabled.

This setting will have impact on all HTML5 canvas elements irrespective of origin, and can be disabled to prevent canvas fingerprinting.

Enabled by default.

This property was introduced in QtWebEngine 6.6.

screenCaptureEnabled : bool [since QtWebEngine 1.3]

Tells the web engine whether screen capture is supported in this application or not.

Disabled by default.

该特性在 QtWebEngine 1.3 引入。

showScrollBars : bool [since QtWebEngine 1.6]

Shows scroll bars. Enabled by default.

This property was introduced in QtWebEngine 1.6.

spatialNavigationEnabled : bool

Enables the Spatial Navigation feature, which means the ability to navigate between focusable elements, such as hyperlinks and form controls, on a web page by using the Left, Right, Up and Down arrow keys.

For example, if a user presses the Right key, heuristics determine whether there is an element they might be trying to reach towards the right and which element they probably want.

Disabled by default.

touchIconsEnabled : bool [since QtWebEngine 1.3]

Enables support for touch icons and precomposed touch icons.

Disabled by default.

该特性在 QtWebEngine 1.3 引入。

unknownUrlSchemePolicy : enumeration [since QtWebEngine 1.7]

Specifies how navigation requests to URLs with unknown schemes are handled.

常量	描述
`WebEngineSettings.DisallowUnknownUrlSchemes`	禁止所有具有未知方案的 URL 导航请求。
`WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction`	Allows navigation requests to URLs with unknown schemes that are issued from user-interaction (like a mouse-click), whereas other navigation requests (for example from JavaScript) are suppressed.
`WebEngineSettings.AllowAllUnknownUrlSchemes`	Allows all navigation requests to URLs with unknown schemes.

Default value is WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction .

该特性在 QtWebEngine 1.7 引入。

webGLEnabled : bool [since QtWebEngine 1.3]

Enables support for HTML 5 WebGL.

Enabled by default if available.

该特性在 QtWebEngine 1.3 引入。

webRTCPublicInterfacesOnly : bool [since QtWebEngine 1.7]

Limits WebRTC to public IP addresses only. When disabled WebRTC may also use local network IP addresses, but remote hosts can also see your local network IP address.

Disabled by default.

该特性在 QtWebEngine 1.7 引入。