WebEngineScriptCollection QML Type

ユーザースクリプトのコレクションを管理する。詳細...

Import Statement: import QtWebEngine
Since: QtWebEngine 6.2

プロパティ

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

方法

  • 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(WebEngineScript script) (since QtWebEngine 6.2)
  • void insert(list<WebEngineScript> list) (since QtWebEngine 6.2)
  • bool remove(WebEngineScript script) (since QtWebEngine 6.2)

詳細説明

WebEngineScriptCollection は、ウェブコンテンツのロード中に JavaScript エンジンに注入されるユーザースクリプトのコレクションを処理します。

WebEgineView.userScriptsWebEngineProfile.userScripts を使用して、1 つのページまたは同じプロファイルを共有する複数のページに関連するスクリプトのコレクションにアクセスします。

QML におけるユーザースクリプトオブジェクトのコレクションは、WebEngineScriptCollection.collection プロパティへの単純な代入、または WebEngineScriptCollection メソッドによって、ユーザースクリプトオブジェクトのセットに対して作成することができます。

注意: collectionプロパティを使用する場合、新しいユーザスクリプトを JavaScript 辞書でインスタンス化することができます。

次のコード・スニペットで使い方を説明します:

  • コレクションプロパティと JavaScript 辞書
    var scriptFoo = { name: "Foo",
                    sourceUrl: Qt.resolvedUrl("foo.js"),
                    injectionPoint: WebEngineScript.DocumentReady }
    
    webEngineView.userScripts.collection = [ scriptFoo, scriptBar ];
  • ユーザースクリプトオブジェクトを値型とするコレクションプロパティ
    var script = WebEngine.script()
    script.name = "FOO"
    webEngineView.userScripts.collection = [ script ]
  • ユーザースクリプトのコレクション挿入メソッドは、値型または値型のリストでのみ使用できます。
    var script = WebEngine.script()
    script.name = "FOO"
    webEngineView.userScripts.insert(script)
    
    var list = [ script ]
    webEngineView.userScripts.insert(list)

WebEngineScript およびWebEngineScriptCollectionも参照してください

プロパティの説明

collection : list<WebEngineScript> [since QtWebEngine 6.2]

このプロパティは、ユーザースクリプトオブジェクトの JavaScript 配列を保持します。この配列は、値としてWebEngineScript 基本型または JavaScript 辞書を取ることができます。

このプロパティは QtWebEngine 6.2 で導入されました。


メソッド・ドキュメント

[since QtWebEngine 6.2] void clear()

このコレクションからすべてのスクリプトオブジェクトを削除します。

このメソッドは QtWebEngine 6.2 で導入されました。


[since QtWebEngine 6.2] bool contains(WebEngineScript script)

指定されたscript がコレクション内にある場合はtrue を、そうでない場合はfalse を返します。

このメソッドは QtWebEngine 6.2 で導入されました。

find()も参照してください


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

与えられたname を持つすべてのユーザースクリプトオブジェクトのリストを返します。

このメソッドは QtWebEngine 6.2 で導入されました。

contains()も参照してください


[since QtWebEngine 6.2] void insert(WebEngineScript script)

コレクションにscript を 1 つ挿入します。

このメソッドは QtWebEngine 6.2 で導入されました。

remove()も参照してください


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

WebEngineScriptlist の値をユーザースクリプトコレクションに挿入します。

このメソッドは QtWebEngine 6.2 で導入されました。

remove()も参照してください


[since QtWebEngine 6.2] bool remove(WebEngineScript script)

与えられたscript がコレクションから削除された場合、true を返します。

このメソッドは QtWebEngine 6.2 で導入されました。

insert()も参照してください


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