WebEngineScriptCollection QML 类型

管理用户脚本集合。 更多...

导入声明import QtWebEngine
从QtWebEngine 6.2

属性

  • collection : 列表<WebEngineScript> (since QtWebEngine 6.2)

方法

  • void clear() (since QtWebEngine 6.2)
  • void contains(WebEngineScript script) (since QtWebEngine 6.2)
  • 列表<WebEngineScript> find(字符串 name) (since QtWebEngine 6.2)
  • void insert(WebEngineScript script) (since QtWebEngine 6.2)
  • void insert(列表<WebEngineScript> list)
  • bool remove(WebEngineScript script) (since QtWebEngine 6.2)

详细说明

WebEngineScriptCollection 处理用户脚本集合，在加载网页内容时会将该集合注入到 JavaScript 引擎中。

使用 WebEgineView.userScripts 和 WebEngineProfile.userScripts 访问与单个页面或具有相同配置文件的多个页面关联的脚本集合。

在 QML 中，可以通过将用户脚本对象简单分配给 WebEngineScriptCollection.collection 属性或通过 WebEngineScriptCollection 方法来创建特定用户脚本对象集合。

注意：当使用 collection 属性时，可以使用 JavaScript 字典实例化新用户脚本。

以下代码示例展示了用法

  • 带有 JavaScript 字典的 collection 属性
    var scriptFoo = { name: "Foo",
                sourceUrl: Qt.resolvedUrl("foo.js"),
                injectionPoint: WebEngineScript.DocumentReady }

webEngineView.userScripts.collection = [ scriptFoo, scriptBar ];
  • 带有用户脚本对象作为值的 collection 属性
    var script = WebEngine.script()
script.name = "FOO"
webEngineView.userScripts.collection = [ script ]
  • 只能使用值类型或值类型列表来使用用户脚本集合的 insert 方法
    var script = WebEngine.script()
script.name = "FOO"
webEngineView.userScripts.insert(script)

var list = [ script ]
webEngineView.userScripts.insert(list)

另请参阅 WebEngineScript 和 WebEngineScriptCollection.

属性文档

collection : 列表<WebEngineScript> [since QtWebEngine 6.2]

该属性包含一个用户脚本对象的JavaScript数组。数组可以接受 WebEngineScript 基本类型或JavaScript字典作为值。

该属性是在QtWebEngine 6.2中引入的。


方法文档

[自QtWebEngine 6.2起] void clear()

从该集合中删除所有脚本对象。

此方法是在QtWebEngine 6.2中引入的。


[自QtWebEngine 6.2起] void contains(WebEngineScript script)

检查指定的 script 是否在集合中。

此方法是在QtWebEngine 6.2中引入的。

另请参见 find().


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

返回所有给定 name 的用户脚本对象的列表。

此方法是在QtWebEngine 6.2中引入的。

另请参见 find().


[自QtWebEngine 6.2起] void insert(WebEngineScript script)

将单个 script 插入集合中。

此方法是在QtWebEngine 6.2中引入的。

另请参见 find().


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

将多个 WebEngineScript 值插入到用户脚本集合中。

此方法是在QtWebEngine 6.2中引入的。

另请参见 find().


[自QtWebEngine 6.2起] bool remove(WebEngineScript script)

如果给定 script 从集合中删除，则返回 true。

此方法是在QtWebEngine 6.2中引入的。

另请参见 insert().


© 2024 Qt Company Ltd. 本文档中包含的文档贡献是各自所有者的版权。本文档是在免费软件基金会发布的帮助下，按照 GNU自由文档许可证版本1.3 的条款提供的。Qt以及相应的标志是芬兰的Qt Company Ltd.和/或全球其他国家的商标。所有其他商标均为其各自所有者的财产。