Sur cette page

WebEngineScriptCollection QML Type

Gère une collection de scripts utilisateur. Plus d'informations...

Import Statement: import QtWebEngine
Since: QtWebEngine 6.2

Propriétés

  • collection : list<webEngineScript> (since QtWebEngine 6.2)

Méthodes

  • void clear() (since QtWebEngine 6.2)
  • bool contains(webEngineScript script) (since QtWebEngine 6.2)
  • list<webEngineScript> find(string name) (since QtWebEngine 6.2)
  • void insert(list<webEngineScript> list) (since QtWebEngine 6.2)
  • void insert(webEngineScript script) (since QtWebEngine 6.2)
  • bool remove(webEngineScript script) (since QtWebEngine 6.2)

Description détaillée

WebEngineScriptCollection gère une collection de scripts utilisateur, qui est injectée dans le moteur JavaScript lors du chargement du contenu web.

Utilisez WebEgineView.userScripts et WebEngineProfile.userScripts pour accéder à la collection de scripts associés à une seule page ou à un certain nombre de pages partageant le même profil.

La collection d'objets de scripts utilisateur en QML peut être créée pour un ensemble d'objets de scripts utilisateur par simple affectation à la propriété WebEngineScriptCollection.collection ou par les méthodes WebEngineScriptCollection.

Remarque : le nouveau script utilisateur peut être instancié avec des dictionnaires JavaScript lors de l'utilisation de la propriété collection.

Les extraits de code suivants en démontrent l'utilisation :

  • propriété collection avec dictionnaires JavaScript
    var scriptFoo = { name: "Foo",
                    sourceUrl: Qt.resolvedUrl("foo.js"),
                    injectionPoint: WebEngineScript.DocumentReady }
    
    webEngineView.userScripts.collection = [ scriptFoo, scriptBar ];
  • propriété collection avec l'objet user script comme type de valeur
    var script = WebEngine.script()
    script.name = "FOO"
    webEngineView.userScripts.collection = [ script ]
  • la méthode d'insertion de collection du script utilisateur ne peut être utilisée qu'avec un type de valeur ou une liste de types de valeurs
    var script = WebEngine.script()
    script.name = "FOO"
    webEngineView.userScripts.insert(script)
    
    var list = [ script ]
    webEngineView.userScripts.insert(list)

Voir également webEngineScript et WebEngineScriptCollection.

Documentation sur les propriétés

collection : list<webEngineScript> [since QtWebEngine 6.2]

Cette propriété contient une liste QML de valeurs utilisateur webEngineScript. La liste peut prendre comme valeurs un type de valeur webEngineScript ou un dictionnaire JavaScript.

Cette propriété a été introduite dans QtWebEngine 6.2.

Documentation de la méthode

[since QtWebEngine 6.2] void clear()

Supprime tous les objets de script de cette collection.

Cette méthode a été introduite dans QtWebEngine 6.2.

[since QtWebEngine 6.2] bool contains(webEngineScript script)

Renvoie true si l'objet spécifié script se trouve dans la collection, false sinon.

Cette méthode a été introduite dans QtWebEngine 6.2.

Voir aussi find().

[since QtWebEngine 6.2] list<webEngineScript> find(string name)

Retourne une liste de tous les objets de scripts utilisateur avec l'adresse name.

Cette méthode a été introduite dans QtWebEngine 6.2.

Voir aussi contains().

[since QtWebEngine 6.2] void insert(list<webEngineScript> list)

Insère un list de valeurs webEngineScript dans la collection de scripts de l'utilisateur.

Cette méthode a été introduite dans QtWebEngine 6.2.

Voir aussi remove().

[since QtWebEngine 6.2] void insert(webEngineScript script)

Insère un seul script dans la collection.

Cette méthode a été introduite dans QtWebEngine 6.2.

Voir aussi remove().

[since QtWebEngine 6.2] bool remove(webEngineScript script)

Renvoie true si un script donné est supprimé de la collection.

Cette méthode a été introduite dans QtWebEngine 6.2.

Voir aussi insert().

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