WebEngineSettings QML Type | Qt WebEngine 5.9

Qt 5.9 | Qt WebEngine | QML Types | WebEngineSettings QML Type

Qt 5.9.9 Reference Documentation

# WebEngineSettings QML Type

Allows configuration of browser properties and attributes. More...

Import Statement: | import QtWebEngine 1.5
Since: | QtWebEngine 1.1

- List of all members, including inherited members

## Properties

- accelerated2dCanvasEnabled : bool
- allowGeolocationOnInsecureOrigins : bool
- allowRunningInsecureContent : bool
- autoLoadIconsForPage : bool
- autoLoadImages : bool
- defaultTextEncoding : string
- errorPageEnabled : bool
- focusOnNavigationEnabled : bool
- fullscreenSupportEnabled : bool
- hyperlinkAuditingEnabled : bool
- javascriptCanAccessClipboard : bool
- javascriptCanOpenWindows : bool
- javascriptEnabled : bool
- linksIncludedInFocusChain : bool
- localContentCanAccessFileUrls : bool
- localContentCanAccessRemoteUrls : bool
- localStorageEnabled : bool
- pluginsEnabled : bool
- printElementBackgrounds : bool
- screenCaptureEnabled : bool
- spatialNavigationEnabled : bool
- touchIconsEnabled : bool
- webGLEnabled : bool

## Detailed Description

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.

## Property Documentation

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 QML property was introduced in QtWebEngine 1.3.

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 QML property was introduced in QtWebEngine 1.5.

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 QML property was introduced in QtWebEngine 1.4.

autoLoadIconsForPage : bool

Automatically downloads icons for web pages.

Enabled by default.

This QML property was introduced in QtWebEngine 1.3.

autoLoadImages : bool

Automatically loads images on web pages.

Enabled by default.

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 QML property was introduced in QtWebEngine 1.2.

errorPageEnabled : bool

Enables displaying the built-in error pages of Chromium.

Enabled by default.

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).

Enabled by default. See WebEngine Recipe Browser for an example where this property is disabled.

This QML property was introduced in QtWebEngine 1.4.

fullscreenSupportEnabled : bool

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

Enabled by default.

This QML 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.

Disabled by default.

javascriptCanOpenWindows : bool

Allows JavaScript programs to open popup windows without user interaction.

Enabled by default.

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.

pluginsEnabled : bool

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

Disabled by default.

See also Pepper Plugin API.

printElementBackgrounds : bool

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

Enabled by default.

This QML property was introduced in QtWebEngine 1.4.

screenCaptureEnabled : bool

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

Disabled by default.

This QML property was introduced in QtWebEngine 1.3.

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

Enables support for touch icons and precomposed touch icons.

Disabled by default.

This QML property was introduced in QtWebEngine 1.3.

webGLEnabled : bool

Enables support for HTML 5 WebGL.

Enabled by default if available.

This QML property was introduced in QtWebEngine 1.3.