WebView QML 类型

用于显示网页内容的一个组件。更多...

导入语句	import QtWebView

成员列表，包括继承成员

属性

canGoBack : bool
canGoForward : bool
httpUserAgent : url (自 QtWebView 1.14)
loadProgress : int
loading : bool
settings : WebViewSettings (自 QtWebView 6.5)
title : string
url : url

信号

cookieAdded(string domain, string name)
cookieRemoved(string domain, string name)
loadingChanged(WebViewLoadRequest loadRequest)

方法

void deleteAllCookies() (自 QtWebView 6.3)
void deleteCookie(string domain, string name) (自 QtWebView 6.3)
void goBack()
void goForward()
void loadHtml(string html, url baseUrl)
void reload()
void runJavaScript(string script, variant callback)
void setCookie(string domain, string name, string value) (自 QtWebView 6.3)
void stop()

详细说明

WebView 是一个用于显示网页内容的组件，它使用原生 API 在支持这些 API 的平台上实现，因此不需要在应用程序中包含完整的网页浏览器堆栈。

为了使 Qt WebView 模块跨所有平台正确工作，必须在创建 QGuiApplication 实例后立即调用 QtWebView::initialize()。

注意：由于平台限制，WebView 与其他 QML 组件的重叠不支持。

属性文档

canGoBack : bool [只读]

当当前可以回到网页的历史记录时，保留为 true。

canGoForward : bool [只读]

当当前可以向前在网页的历史记录导航时，保留为 true。

httpUserAgent : url [始于 QtWebView 1.14]

正在使用的用户代理。

注意：在 WinRT 上，此属性影响应用程序中的所有 WebView。

此属性在 QtWebView 1.14 中引入。

loadProgress : int [只读]

表示为介于 0 和 100 之间的整数的当前网页内容的加载进度。

loading : bool [只读]

如果 WebView 当前正加载新内容，则为 true，否则为 false。

另请参阅加载状态改变。

settings : WebViewSettings [只读，始于 QtWebView 6.5]

WebView 的设置对象。

此属性在 QtWebView 6.5 中引入。

另请参阅WebViewSettings.

title : string [只读]

当前加载网页的标题。

url : url

当前加载网页的 URL。更改此 URL 将触发加载新内容。

URL 会原样使用。来自用户输入的 URL 应使用 QUrl::fromUserInput 解析。

注意：WebView 不支持通过 Qt 资源系统加载内容。

信号文档

cookieAdded(string domain, string name)

当添加 cookie 时发出此信号。

参数提供了有关添加的 cookie 的域和名称的信息。

注意：当使用 Qt WebEngine 模块作为后端时，cookieAdded 信号会为加入到底层 QWebEngineCookieStore 的任何 cookie 发出，包括网站添加的 cookie。在其他情况下，cookieAdded 信号只会为使用 setCookie() 明确添加的 cookie 发出。

注意：相应处理程序是 onCookieAdded。

cookieRemoved(string domain, string name)

当删除cookie时发出此信号。

参数提供了有关被删除的 cookie 的域和名称的信息。

注意：相应处理程序是 onCookieRemoved。

loadingChanged(WebViewLoadRequest loadRequest)

当加载网页内容的状态发生改变时发出此信号。处理此信号可以使你，例如，对页面加载错误做出反应。

loadRequest 参数包含请求的 url 和 status，以及一个包含失败请求的错误信息的 errorString。

注意：相应的处理程序是 onLoadingChanged。

另请参阅WebViewLoadRequest。

方法文档

[自 QtWebView 6.3 开始] void deleteAllCookies()

删除所有cookie。

此方法是在 QtWebView 6.3 中引入的。

[自 QtWebView 6.3 开始] void deleteCookie(string domain, string name)

删除具有指定 domain 和 name 的cookie。

当cookie被删除时，将触发cookieRemoved 信号。

此方法是在 QtWebView 6.3 中引入的。

void goBack()

在网页历史记录中后退。

void goForward()

在网页历史记录中前进。

void loadHtml(string html, url baseUrl)

将指定的 html 内容加载到网页视图中。

此方法提供了对url属性的底层替代，该属性通过URL引用HTML页面。

HTML文档中引用的外部对象，例如样式表或图像，应位于baseUrl的相对位置。例如，如果html是从http://www.example.com/documents/overview.html获取的，这是一个基本URL，那么使用相对URL引用的图像（例如diagram.png），应位于http://www.example.com/documents/diagram.png。

注意：WebView 不支持通过 Qt 资源系统加载内容。

另请参阅url。

void reload()

重新加载当前url。

void runJavaScript(string script, variant callback)

运行指定的JavaScript。如果提供了一个 callback 函数，则该函数将在script执行完毕后调用。

runJavaScript("document.title", function(result) { console.log(result); });

[自 QtWebView 6.3 开始] void setCookie(string domain, string name, string value)

添加一个具有指定domain、name和value的cookie。

当添加cookie时，将触发cookieAdded信号。

此方法是在 QtWebView 6.3 中引入的。

void stop()

停止加载当前url。