WebEngineSettings QML Type
Permet de configurer les propriétés et les attributs du navigateur. Plus d'informations...
| Import Statement: | import QtWebEngine |
| Since: | QtWebEngine 1.1 |
Propriétés
- 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
- backForwardCacheEnabled : bool
(since QtWebEngine 6.10) - 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
- imageAnimationPolicy : enumeration
(since QtWebEngine 6.8) - 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
- preferCSSMarginsForPrinting : bool
(since QtWebEngine 6.9) - printElementBackgrounds : bool
(since QtWebEngine 1.4) - printHeaderAndFooter : bool
(since QtWebEngine 6.9) - readingFromCanvasEnabled : bool
(since QtWebEngine 6.6) - screenCaptureEnabled : bool
(since QtWebEngine 1.3) - scrollAnimatorEnabled : bool
(since QtWebEngine 6.8) - showScrollBars : bool
(since QtWebEngine 1.6) - spatialNavigationEnabled : bool
- touchEventsApiEnabled : bool
(since QtWebEngine 6.9) - touchIconsEnabled : bool
(since QtWebEngine 1.3) - trimAccessibilityIdentifiers : bool
(since QtWebEngine 6.11) - unknownUrlSchemePolicy : enumeration
(since QtWebEngine 1.7) - webGLEnabled : bool
(since QtWebEngine 1.3) - webRTCPublicInterfacesOnly : bool
(since QtWebEngine 1.7)
Description détaillée
Le type WebEngineSettings peut être utilisé pour configurer les propriétés du navigateur et les attributs génériques, tels que la prise en charge de JavaScript, le comportement de la mise au point et l'accès au contenu distant. Ce type n'est pas créable, mais les paramètres par défaut de toutes les vues du moteur web sont accessibles à l'aide de la propriété WebEngine.settings.
Chaque vue du moteur web peut avoir des paramètres individuels accessibles à l'aide de la propriété WebEngineView.settings.
Documentation sur les propriétés
accelerated2dCanvasEnabled : bool [since QtWebEngine 1.3]
Spécifie si le canevas 2D HTML 5 doit être un framebuffer OpenGL. Cela permet d'accélérer de nombreuses opérations de peinture, mais ralentit l'accès aux pixels.
Activé par défaut s'il est disponible.
Cette propriété a été introduite dans QtWebEngine 1.3.
allowGeolocationOnInsecureOrigins : bool [since QtWebEngine 1.5]
Seules les origines sécurisées telles que HTTPS sont en mesure de demander des fonctions de géolocalisation. Cette option permet d'autoriser les origines non sécurisées à accéder à nouveau à la géolocalisation.
Désactivé par défaut.
Cette propriété a été introduite dans QtWebEngine 1.5.
allowRunningInsecureContent : bool [since QtWebEngine 1.4]
Par défaut, les pages HTTPS ne peuvent pas exécuter de JavaScript, CSS, plugins ou web-sockets à partir d'URL HTTP. Cela était possible auparavant et cette option permet de revenir à l'ancien comportement.
Désactivé par défaut.
Cette propriété a été introduite dans QtWebEngine 1.4.
allowWindowActivationFromJavaScript : bool [since QtWebEngine 1.6]
Permet d'utiliser la méthode window.focus() en JavaScript. Désactivée par défaut.
Cette propriété a été introduite dans QtWebEngine 1.6.
autoLoadIconsForPage : bool [since QtWebEngine 1.3]
Télécharge automatiquement les icônes des pages web.
Activé par défaut.
Cette propriété a été introduite dans QtWebEngine 1.3.
autoLoadImages : bool
Charge automatiquement les images sur les pages web.
Activé par défaut.
backForwardCacheEnabled : bool [since QtWebEngine 6.10]
Active la prise en charge du cache arrière/avant (ou bfcache) pour accélérer la navigation arrière et avant.
Désactivé par défaut.
Cette propriété a été introduite dans QtWebEngine 6.10.
defaultTextEncoding : string [since QtWebEngine 1.2]
Définit l'encodage par défaut. La valeur doit être une chaîne décrivant un encodage tel que "utf-8" ou "iso-8859-1".
Si elle est laissée vide, une valeur par défaut sera utilisée.
Cette propriété a été introduite dans QtWebEngine 1.2.
dnsPrefetchEnabled : bool [since QtWebEngine 1.8]
Active la recherche spéculative des enregistrements DNS pour les liens HTML avant qu'ils ne soient activés.
Désactivé par défaut.
Cette propriété a été introduite dans QtWebEngine 1.8.
errorPageEnabled : bool
Permet d'afficher les pages d'erreur intégrées de Chromium.
Activé par défaut.
focusOnNavigationEnabled : bool [since QtWebEngine 1.4]
L'accent est mis sur la vue chaque fois qu'une opération de navigation se produit (chargement, arrêt, rechargement, rechargement et contournement du cache, avance, recul, définition du contenu, etc.)
Désactivé par défaut.
Cette propriété a été introduite dans QtWebEngine 1.4.
forceDarkMode : bool [since QtWebEngine 6.7]
Rendre automatiquement tous les contenus web à l'aide d'un thème sombre.
Désactivé par défaut.
Cette propriété a été introduite dans QtWebEngine 6.7.
fullscreenSupportEnabled : bool [since QtWebEngine 1.2]
Indique au moteur web si le plein écran est pris en charge dans cette application ou non.
Désactivé par défaut.
Cette propriété a été introduite dans QtWebEngine 1.2.
hyperlinkAuditingEnabled : bool
Active la prise en charge de l'attribut ping pour les hyperliens.
Désactivé par défaut.
imageAnimationPolicy : enumeration [since QtWebEngine 6.8]
Spécifie comment une animation d'image doit être gérée lorsque les images sont rendues pour l'animation.
| Constante | Description |
|---|---|
WebEngineSettings.ImageAnimationPolicy.Allow | Autorise toutes les animations d'image lors du rendu des images. |
WebEngineSettings.ImageAnimationPolicy.AnimateOnce | Anime l'image une seule fois lors du rendu des images. |
WebEngineSettings.ImageAnimationPolicy.Disallow | Désactive toutes les animations d'images lors du rendu des images. |
La valeur par défaut est WebEngineSettings.ImageAnimationPolicy.Allow.
Cette propriété a été introduite dans QtWebEngine 6.8.
javascriptCanAccessClipboard : bool
Permet aux programmes JavaScript d'écrire (copier) un contenu assaini dans le presse-papiers. L'écriture aseptisée s'effectue à l'aide des appels de l'API JavaScript Clipboard write et writeText et doit être accompagnée d'une action de l'utilisateur.
Les écritures non assainies et la lecture du presse-papiers sont activées par javascriptCanPaste.
Avant la version 81 de Chromium, ce paramètre activait toutes les écritures dans le presse-papiers.
L'accès illimité au presse-papiers pouvant poser des problèmes de sécurité, il est recommandé aux applications de laisser ce paramètre désactivé et de répondre plutôt aux demandes d'autorisation de la fonctionnalité ClipboardReadWrite.
Désactivé par défaut.
javascriptCanOpenWindows : bool
Permet aux programmes JavaScript d'ouvrir des fenêtres contextuelles sans interaction de l'utilisateur.
Activé par défaut.
javascriptCanPaste : bool [since QtWebEngine 1.7]
Permet aux programmes JavaScript de lire (coller) dans le presse-papiers et d'écrire du contenu non aseptisé. Une écriture assainie est effectuée à l'aide des appels de l'API JavaScript du presse-papiers write et writeText et doit être accompagnée d'une action de l'utilisateur ; les écritures non assainies sont toutes les écritures qui ne répondent pas à ces critères.
Pour que ce paramètre ait un effet, javascriptCanAccessClipboard doit également être activé.
L'accès illimité au presse-papiers pouvant poser des problèmes de sécurité, il est recommandé aux applications de laisser ce paramètre désactivé et de répondre plutôt aux demandes d'autorisation de la fonctionnalité ClipboardReadWrite.
Désactivé par défaut.
Cette propriété a été introduite dans QtWebEngine 1.7.
javascriptEnabled : bool
Permet l'exécution de programmes JavaScript.
Activé par défaut.
linksIncludedInFocusChain : bool
Inclut les hyperliens dans la chaîne de focalisation du clavier.
Activé par défaut.
localContentCanAccessFileUrls : bool
Permet aux documents chargés localement d'accéder à d'autres URL locales.
Activé par défaut.
localContentCanAccessRemoteUrls : bool
Permet aux documents chargés localement d'accéder à des URL distants.
Désactivé par défaut.
localStorageEnabled : bool
Active la prise en charge de la fonction de stockage local de HTML 5.
Activé par défaut.
navigateOnDropEnabled : bool [since QtWebEngine 6.4]
Spécifie que les navigations peuvent être déclenchées en déposant des URL sur la vue.
Activé par défaut.
Cette propriété a été introduite dans QtWebEngine 6.4.
pdfViewerEnabled : bool [since QtWebEngine 1.9]
Spécifie que les documents PDF seront ouverts dans la visionneuse PDF interne au lieu d'être téléchargés.
Activé par défaut.
Cette propriété a été introduite dans QtWebEngine 1.9.
playbackRequiresUserGesture : bool [since QtWebEngine 1.7]
Inhibe la lecture du contenu multimédia jusqu'à ce que l'utilisateur interagisse avec la page.
Par défaut, Qt WebEngine utilise les paramètres de Chromium, comme décrit dans Modifications de la politique de lecture automatique. Pour remplacer le comportement par défaut, cette propriété doit être définie sur false.
Remarque : le comportement est similaire à celui de Chrome sur Android lorsqu'il est activé, et similaire à celui de Chrome sur les ordinateurs de bureau lorsqu'il est désactivé.
Cette propriété a été introduite dans QtWebEngine 1.7.
pluginsEnabled : bool
Active la prise en charge des plugins Pepper, tels que le lecteur Flash.
Désactivé par défaut.
preferCSSMarginsForPrinting : bool [since QtWebEngine 6.9]
Active la préférence des marges CSS par rapport aux tailles par défaut (0, 0, 0, 0) lors de l'impression d'une page web.
Désactivé par défaut.
Cette propriété a été introduite dans QtWebEngine 6.9.
printElementBackgrounds : bool [since QtWebEngine 1.4]
Active l'impression des arrière-plans CSS lors de l'impression d'une page web.
Activé par défaut.
Cette propriété a été introduite dans QtWebEngine 1.4.
printHeaderAndFooter : bool [since QtWebEngine 6.9]
Spécifie que les résultats de l'impression contiendront des informations de base sur la page (URL, titre, date, numéro de page) dans la zone d'en-tête et de pied de page. Il incombe à l'intégrateur de prévoir suffisamment d'espace pour ces textes en définissant des marges supérieures et inférieures adéquates.
Désactivé par défaut.
Cette propriété a été introduite dans QtWebEngine 6.9.
readingFromCanvasEnabled : bool [since QtWebEngine 6.6]
Spécifie que la lecture de tous les éléments du canevas est activée.
Ce paramètre aura un impact sur tous les éléments HTML5 canvas, quelle que soit leur origine, et peut être désactivé pour éviter l'empreinte digitale du canvas.
Activé par défaut.
Cette propriété a été introduite dans QtWebEngine 6.6.
screenCaptureEnabled : bool [since QtWebEngine 1.3]
Indique au moteur web si la capture d'écran est prise en charge dans cette application ou non.
Désactivée par défaut.
Cette propriété a été introduite dans QtWebEngine 1.3.
scrollAnimatorEnabled : bool [since QtWebEngine 6.8]
Active le défilement animé.
Désactivé par défaut.
Cette propriété a été introduite dans QtWebEngine 6.8.
showScrollBars : bool [since QtWebEngine 1.6]
Affiche les barres de défilement. Activé par défaut.
Cette propriété a été introduite dans QtWebEngine 1.6.
spatialNavigationEnabled : bool
Active la fonction de navigation spatiale, c'est-à-dire la possibilité de naviguer entre les éléments focalisables, tels que les hyperliens et les contrôles de formulaire, sur une page web en utilisant les touches fléchées gauche, droite, haut et bas.
Par exemple, si un utilisateur appuie sur la touche Droite, l'heuristique détermine s'il y a un élément qu'il pourrait essayer d'atteindre vers la droite et quel est l'élément qu'il veut probablement atteindre.
Désactivé par défaut.
touchEventsApiEnabled : bool [since QtWebEngine 6.9]
Active la prise en charge de l'API des événements tactiles JavaScript, ce qui signifie que les gestionnaires ontouchstart, ontouchend et ontouchmove seront présents dans l'objet document.window.
Notez que certains sites web utilisent cette API pour décider s'ils fonctionnent sur un appareil mobile ou sur un ordinateur de bureau et basent leur conception sur cette décision. Cela peut entraîner des résultats indésirables sur les ordinateurs portables à écran tactile ou sur d'autres configurations qui émulent un faux périphérique tactile.
Activée par défaut si un appareil tactile est détecté par le système et désactivée dans le cas contraire.
Cette propriété a été introduite dans QtWebEngine 6.9.
touchIconsEnabled : bool [since QtWebEngine 1.3]
Active la prise en charge des icônes tactiles et des icônes tactiles précomposées.
Désactivé par défaut.
Cette propriété a été introduite dans QtWebEngine 1.3.
trimAccessibilityIdentifiers : bool [since QtWebEngine 6.11]
Force l'attribut HTML "id" à être utilisé comme identifiant de l'automatisation (QAccessible::Identifier) sans modification. Lorsqu'il est désactivé, Qt ajoute à l'identifiant l'ensemble de la hiérarchie de l'objet.
Désactivé par défaut.
Cette propriété a été introduite dans QtWebEngine 6.11.
unknownUrlSchemePolicy : enumeration [since QtWebEngine 1.7]
Spécifie comment sont traitées les demandes de navigation vers des URL dont le schéma est inconnu.
| Constante | Description |
|---|---|
WebEngineSettings.DisallowUnknownUrlSchemes | Interdit toutes les demandes de navigation vers des URL dont le schéma est inconnu. |
WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction | Autorise les demandes de navigation vers des URL dont le schéma est inconnu et qui proviennent d'une interaction de l'utilisateur (comme un clic de souris), tandis que les autres demandes de navigation (par exemple, celles provenant de JavaScript) sont supprimées. |
WebEngineSettings.AllowAllUnknownUrlSchemes | Autorise toutes les demandes de navigation vers des URL dont le schéma est inconnu. |
La valeur par défaut est WebEngineSettings.AllowUnknownUrlSchemesFromUserInteraction.
Cette propriété a été introduite dans QtWebEngine 1.7.
webGLEnabled : bool [since QtWebEngine 1.3]
Active la prise en charge de HTML 5 WebGL.
Activé par défaut s'il est disponible.
Cette propriété a été introduite dans QtWebEngine 1.3.
webRTCPublicInterfacesOnly : bool [since QtWebEngine 1.7]
Limite WebRTC aux adresses IP publiques uniquement. Lorsqu'il est désactivé, WebRTC peut également utiliser les adresses IP du réseau local, mais les hôtes distants peuvent également voir l'adresse IP de votre réseau local.
Désactivé par défaut.
Cette propriété a été introduite dans QtWebEngine 1.7.
© 2026 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.
