webEngineScript QML Value Type
Permet l'injection programmatique de scripts dans le moteur JavaScript. Plus d'informations...
| Import Statement: | import QtWebEngine |
| Since: | QtWebEngine 1.1 |
| In C++: | QWebEngineScript |
Propriétés
- injectionPoint : enumeration
- name : string
- runsOnSubFrames : bool
- sourceCode : string
- sourceUrl : url
- worldId : enumeration
Description détaillée
Le type de valeur webEngineScript permet l'injection programmatique de ce que l'on appelle des scripts d'utilisateur dans le moteur JavaScript à différents moments, déterminés par injectionPoint, pendant le chargement du contenu web.
Les scripts peuvent être exécutés soit dans le monde JavaScript principal, avec le reste du JavaScript provenant du contenu web, soit dans leur propre monde isolé. Alors que le DOM de la page est accessible depuis n'importe quel monde, les variables JavaScript d'une fonction définie dans un monde ne sont pas accessibles depuis un autre monde. La propriété worldId fournit des identifiants prédéfinis à cet effet.
Les attributs Greasemonkey suivants sont pris en charge : @exclude, @include, @name, @match, et @run-at.
Utilisez WebEngineScriptCollection pour accéder à une liste de scripts attachés à la vue web.
Documentation sur les propriétés
injectionPoint : enumeration
Point du processus de chargement où le script sera exécuté. La valeur par défaut est Deferred.
| Constante | Description de la constante |
|---|---|
WebEngineScript.DocumentCreation | Le script sera exécuté dès que le document sera créé. Ceci n'est pas approprié pour toute opération DOM. |
WebEngineScript.DocumentReady | Le script sera exécuté dès que le DOM sera prêt. Cela équivaut au déclenchement de l'événement DOMContentLoaded en JavaScript. |
WebEngineScript.Deferred | Le script sera exécuté à la fin du chargement de la page ou 500 ms après que le document est prêt, selon ce qui se produit en premier. |
name : string
Le nom du script. Peut être utile pour récupérer un script particulier à partir de la méthode WebEngineScriptCollection.find.
runsOnSubFrames : bool
Définissez cette propriété sur true si le script est exécuté sur chaque cadre de la page, ou sur false s'il n'est exécuté que pour le cadre principal. La valeur par défaut est false.
sourceCode : string
Cette propriété contient le code source JavaScript du script utilisateur.
Voir aussi sourceUrl.
sourceUrl : url
Cette propriété contient l'emplacement de la source distante du script utilisateur (le cas échéant).
Contrairement à sourceCode, cette propriété permet de faire référence à des scripts utilisateur qui ne sont pas déjà chargés en mémoire, par exemple lorsqu'ils sont stockés sur un disque.
La définition de cette propriété modifie l'adresse sourceCode du script.
Remarque : à l'heure actuelle, seules les sources basées sur des fichiers sont prises en charge.
Voir également sourceCode.
worldId : enumeration
L'ID du monde définissant le monde isolé dans lequel le script est exécuté.
| Constante | Description du monde |
|---|---|
WebEngineScript.MainWorld | Le monde utilisé par le contenu web de la page. Il peut être utile pour exposer des fonctionnalités personnalisées aux contenus web dans certains scénarios. |
WebEngineScript.ApplicationWorld | Le monde isolé par défaut utilisé pour les fonctionnalités au niveau de l'application mises en œuvre en JavaScript. |
WebEngineScript.UserWorld | Le premier monde isolé utilisé par les scripts définis par les utilisateurs si l'application n'utilise pas d'autres mondes. En règle générale, si cette fonctionnalité est exposée aux utilisateurs de l'application, chaque script individuel devrait probablement avoir son propre monde isolé. |
© 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.
