Qt与QWebEngineView 交互完整示例参考
莫固执,朋友 2024-07-09 14:33:11 阅读 56
目录
1:Qt的Web 引擎与 WebView交互历史变更
2:示例展示
3:项目注意事项
最近刚好需要做一个Qt与Webview的交互,顺便写下整个的交互流程,给需要的各位参考学习。后面会补充,Qt上应用其他Web上的开源图标类的组件js库,例如EChart,vis.js等,通过 Qt+ +JavaScript+ QWebChannel +QWebEngineView 的组合,很多酷炫的效果都可以很方便的做出来。
1:Qt的Web 引擎与 WebView交互历史变更
Qt 5.6 引入了 Qt WebEngine 模块:
在过去,Qt 使用的是 Qt WebKit 作为其 Web 引擎。但自 Qt 5.6 版本开始,Qt 引入了基于 Chromium 的新的 Web 引擎,称为 Qt WebEngine。这个改变带来了更好的性能、更好的 HTML5 和 CSS3 支持以及更好的安全性。
QWebView 被 QWebEngineView 替代:
在使用 Qt WebKit 时,开发者使用 QWebView 类来显示 Web 内容。但是随着 Qt WebEngine 的引入,Qt 引入了 QWebEngineView 类来取代 QWebView。QWebEngineView 基于新的 Web 引擎,并提供了更现代化的 API 和功能。
引入了新的通信机制 - QWebChannel:
在 Qt WebEngine 中,引入了 QWebChannel 作为一种新的机制,用于在 C++ 代码和 JavaScript 代码之间进行通信。通过 QWebChannel,可以将 C++ 对象暴露给 JavaScript,使得它们可以相互调用和交互。
更好的扩展性和性能:
由于 Qt WebEngine 基于 Chromium,因此具有更好的性能和扩展性。它可以使用 Chromium 提供的各种功能和特性,包括先进的渲染引擎、多线程支持、GPU 加速等。
更新的 HTML5 和 CSS3 支持:
Qt WebEngine 提供了更现代化的 HTML5 和 CSS3 支持,使得开发者可以更轻松地创建丰富、交互性强的 Web 应用程序。
这些是 Qt 的 Web 引擎与 WebView 交互方面的一些主要变化。总的来说,随着 Qt WebEngine 的引入,Qt 在 Web 开发领域取得了重大进步,为开发者提供了更好的工具和功能来创建高性能的 Web 应用程序。
2:示例展示
示例是完整Qt代码和Html文件,可以直接测试,注释也写了一些
通过QWebChannel进行注册和调用:
这种方法是在Qt中注册QObject对象,使其可以在JavaScript中调用。使用QWebChannel类来建立Qt与JavaScript之间的通信桥梁。
在Qt代码中,通过registerObject方法将QObject对象注册到QWebChannel中,然后在JavaScript中使用该对象。可以定义槽函数和属性,这些槽函数和属性可以在JavaScript中直接调用和访问。在JavaScript中调用这些槽函数来执行特定的操作,或者读取和设置属性。
这种方法适用于在Web页面中需要与Qt代码进行交互的场景,需要从Web页面中触发特定操作,并且在Qt代码中执行相应的处理时,或者需要在Web页面中显示Qt代码中的数据时这样做很方便。
如果想要简单的Qt调用JavaScript函数的话,就使用runJavaScript方法就行
总的来说,如果需要频繁地进行 C++ 和 JavaScript 之间的通信,使用连接信号与槽会更加方便和高效。而如果只是偶尔需要执行一些 JavaScript 代码,使用 `runJavaScript` 也是一个不错的选择。
<code>#pragma once
#include <QWidget>
#include <QJsonObject>
class QWebEngineView;
class QWebChannel;
class frmgplot : public QWidget
{
Q_OBJECT
/*Q_PROPERTY 定义了一个名为 jsonData 的属性,
其类型为 QJsonObject,并将其与一个名为 qtjsonData 的成员变量关联起来。
当qtjsonData改变时,会自动触发qtdataChanged信号
要在类中声明好 信号(qtdataChanged) 和 成员(qtjsonData)
*/
Q_PROPERTY(QJsonObject jsonData MEMBER qtjsonData NOTIFY qtdataChanged)
public:
frmgplot(QWidget *parent);
~frmgplot();
void initfrm();
void setQtjsonData(const QJsonObject & jsonData);
public slots:
//js 调用qt函数,注意类型必须要是public slots:
void jscallQt(const QString &str);
private slots:
void onPageLoadFinished(bool success);
signals:
//当qtjsonData改变时,会自动触发qtdataChanged信号
void qtdataChanged(const QJsonObject &jsonData);
private:
QWebEngineView *m_webView;
QWebChannel *m_webChannel;
QJsonObject qtjsonData;
};
#include "frmgplot.h"
#include <QWebEngineView>
#include <QWebChannel>
#include <QFileInfo>
#include <QDir>
#include <QApplication>
#include <QVBoxLayout>
#include <qmessagebox.h>
#include <QTimer>
frmgplot::frmgplot(QWidget *parent)
: QWidget(parent)
{
//拿到示例后,别忘了在合适的时候 初始化initfrm
}
frmgplot::~frmgplot()
{
}
void frmgplot::initfrm()
{
QVBoxLayout *layout = new QVBoxLayout(this);
setLayout(layout);
// 创建 Web 视图
m_webView = new QWebEngineView(this);
layout->addWidget(m_webView);
// 创建 Web 通道
m_webChannel = new QWebChannel(this);
// 注册到 Web 页面,使 JavaScript 能够调用 Qt类里面的 槽函数
m_webChannel->registerObject("frmplot", this);
m_webView->page()->setWebChannel(m_webChannel);//设备交互通道
// 加载 HTML 页面
QString filePath = QFileInfo(QApplication::applicationDirPath() + "/web/gplot/js/index.html").absoluteFilePath();
m_webView->load(QUrl::fromLocalFile(filePath));
// 连接信号槽以在通道初始化后调用 JavaScript 函数
connect(m_webView, &QWebEngineView::loadFinished, this, &frmgplot::onPageLoadFinished);
}
void frmgplot::onPageLoadFinished(bool success)
{
if (success) {
// 页面加载完成后调用 JavaScript 函数
// 创建定时器,延迟3秒后执行
QTimer::singleShot(3000, this, [=]() {
// 页面加载完成后调用 JavaScript 函数
m_webView->page()->runJavaScript(QString("qtcalljsfunc('%1');").arg("qt call to js"));
});
}
}
void frmgplot::jscallQt(const QString &str)
{
QMessageBox::warning(this, QString::fromLocal8Bit("title"), str);
/*示例:
js 调用 qt 后,
qt再次设置
属性jsonData 的qtjsonData成员,
让其改变 然后 触发信号qtdataChanged,从而让web 捕捉到qtdataChanged信号*/
QJsonObject json;
json["obj1"] = 1;
json["obj2"] = 666.666;
json["obj3"] = "this objstr";
this->setProperty("jsonData", json);
setQtjsonData(json);
}
void frmgplot::setQtjsonData(const QJsonObject &jsonData)
{
//if (qtjsonData != jsonData)
{
qtjsonData = jsonData;//会自动触发qtdataChanged
}
}
<!doctype html>
<html>
<head>
<title>Network</title>
<script src="qwebchannel.js"></script> code>
<style type="text/css">code>
#mynetwork {
width: 80vw; /* 设置为全屏宽度的 80% */
height: 80vh; /* 设置为全屏高度的 80% */
border: 1px solid lightgray;
}
/* 设置 body 和 html 的宽度和高度为100%,以使 #mynetwork 占据整个屏幕 */
body, html {
width: 100%;
height: 100%;
margin: 0;
padding: 0;
}
</style>
</head>
<body>
<button id="jscallqtbutton">js call qt</button>code>
/*定义一个按钮*/
<p>
</p>
<div id="mynetwork"></div>code>
<script type="text/javascript">code>
//----------- webchannel qt js 交互
var updatejson=function(text){
// 使用JSON.stringify将QJsonObject转换为字符串,然后再输出
alert(JSON.stringify(text));
}
var webObject;
// Connect to the QWebChannel
new QWebChannel(qt.webChannelTransport, function(channel) {
webObject = channel.objects.frmplot;
window.foo = webObject;//对象赋值给了全局对象 window 的属性 foo
//qt信号{qtdataChanged}与js函数连接,就像 qt的信号槽一样
webObject.qtdataChanged.connect(updatejson);
// 1: web view -> qt :web上按钮(jscallqtbutton)按下后,调用qt函数jscallQt
document.getElementById("jscallqtbutton").onclick = function() {
webObject.jscallQt("jscall-qt");
alert("jscallQt");
};
//2:qt -> web js
// 示例:在页面上显示jsonData的内容
/* jsonDataDisplay = document.getElementById("jsonDataDisplay");
jsonDataDisplay.innerHTML = JSON.stringify(jsonData);*/
});
//--------
function qtcalljsfunc(text) {
alert((text));
}
</script>
</body>
</html>
3:项目注意事项
3.1 :Qt WebEngine locales directory not found at location 错误
这个警告是因为 Qt WebEngine 在运行时需要一些 ICU 数据文件,这些文件通常位于 Qt 的安装目录中。警告消息显示 Qt WebEngine 在指定的目录下找不到 ICU 数据文件,因此它会尝试从其他位置加载
在 Qt WebEngine 中,ICU 数据文件主要用于处理文字排版、文字渲染、国际化以及本地化等任务。因此,运行 Qt WebEngine 应用程序时,它会尝试加载这些 ICU 数据文件,以确保在不同地区和语言环境下能够正确地显示和处理文本。
icudtl.dat
是 Qt 框架使用的 ICU(International Components for Unicode)数据文件之一。
icudtl.dat
是在Qt的安装目录中的,在安装目录中搜索并且incudtl.dat和这些pak文件 复制到 执行文件相同层级目录下就可以了。*.pak
是 Qt WebEngine 中的资源文件,它们包含了用于支持开发者工具和其他功能所需的资源。注意拷贝时,要区分 对应版本 。
3.2 运行时 崩溃例如:m_webView->page()->setWebChannel(m_webChannel);或者其他地方莫名崩溃
<code> QtWebEngineProcess.exe 是 Qt WebEngine 模块的一个子进程,用于在 Qt 应用程序中执行 Web 页面的渲染和相关任务。通常情况下,QtWebEngineProcess.exe
被设计为与主应用程序(.exe 文件)放置在同一目录下,这是为了便于它与主应用程序之间共享资源和进行通信,否则会出现各种莫名崩溃问题
继续补充:
声明
本文内容仅代表作者观点,或转载于其他网站,本站不以此文作为商业用途
如有涉及侵权,请联系本站进行删除
转载本站原创文章,请注明来源及作者。