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 |
|---|---|
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 image de la page, ou sur false s'il n'est exécuté que pour l'image principale. La valeur par défaut est false.
sourceCode : string |
Cette propriété contient le code source JavaScript du script utilisateur.
Voir également 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'identifiant du monde définissant le monde isolé dans lequel le script est exécuté.
| Constante | Description |
|---|---|
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é. |
© 2025 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.