Allows configuration of browser properties and attributes. More...
| Import Statement: | import QtWebEngine |
| Since: | QtWebEngine 1.1 |
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 property.
Each web engine view can have individual settings that can be accessed by using the WebEngineView.settings property.
[since QtWebEngine 1.3] accelerated2dCanvasEnabled : bool
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.
This property was introduced in QtWebEngine 1.3.
[since QtWebEngine 1.5] allowGeolocationOnInsecureOrigins : bool
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.
[since QtWebEngine 1.4] allowRunningInsecureContent : bool
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.
[since QtWebEngine 1.6] allowWindowActivationFromJavaScript : bool
Allows the window.focus() method in JavaScript. Disallowed by default.
This property was introduced in QtWebEngine 1.6.
[since QtWebEngine 1.3] autoLoadIconsForPage : bool
Automatically downloads icons for web pages.
Enabled by default.
This property was introduced in QtWebEngine 1.3.
autoLoadImages : bool
Automatically loads images on web pages.
Enabled by default.
[since QtWebEngine 1.2] defaultTextEncoding : string
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.
[since QtWebEngine 1.8] dnsPrefetchEnabled : bool
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.
[since QtWebEngine 1.4] focusOnNavigationEnabled : bool
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.
[since QtWebEngine 1.2] fullscreenSupportEnabled : bool
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
Enables support for the 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.
[since QtWebEngine 1.7] javascriptCanPaste : bool
Enables JavaScript execCommand("paste"). This also requires enabling javascriptCanAccessClipboard.
Disabled by default.
This property was introduced in 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.
[since QtWebEngine 1.9] pdfViewerEnabled : bool
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.
[since QtWebEngine 1.7] playbackRequiresUserGesture : bool
Inhibits playback of media content until the user interacts with the page.
By default, Qt WebEngine uses Chromium settings, as described in Autoplay Policy Changes. To overwrite the default behavior, this property must be set to false.
Note: The behavior is similar to Chrome on Android when enabled, and similar to Chrome on desktops when disabled.
This property was introduced in QtWebEngine 1.7.
pluginsEnabled : bool
Enables support for Pepper plugins, such as the Flash player.
Disabled by default.
See also Pepper Plugin API.
[since QtWebEngine 1.4] printElementBackgrounds : bool
Turns on printing of CSS backgrounds when printing a web page.
Enabled by default.
This property was introduced in QtWebEngine 1.4.
[since QtWebEngine 1.3] screenCaptureEnabled : bool
Tells the web engine whether screen capture is supported in this application or not.
Disabled by default.
This property was introduced in QtWebEngine 1.3.
[since QtWebEngine 1.6] showScrollBars : bool
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.
[since QtWebEngine 1.3] touchIconsEnabled : bool
Enables support for touch icons and precomposed touch icons.
Disabled by default.
This property was introduced in QtWebEngine 1.3.
[since QtWebEngine 1.7] unknownUrlSchemePolicy : enumeration
Specifies how navigation requests to URLs with unknown schemes are handled.
| Constant | Description |
|---|---|
WebEngineSettings.DisallowUnknownUrlSchemes |
Disallows all navigation requests to URLs with unknown schemes. |
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.
This property was introduced in QtWebEngine 1.7.
[since QtWebEngine 1.3] webGLEnabled : bool
Enables support for HTML 5 WebGL.
Enabled by default if available.
This property was introduced in QtWebEngine 1.3.
[since QtWebEngine 1.7] webRTCPublicInterfacesOnly : bool
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.
This property was introduced in QtWebEngine 1.7.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qml-qtwebengine-webenginesettings.html