Qt WebView

Qt WebView vous permet d’afficher du contenu Web au sein d’une application QML. Afin d’éviter d’intégrer une pile complète de navigateur Web, Qt WebView utilise des API natives lorsque cela est possible.

Cela s’avère utile sur les plateformes mobiles, telles qu’Android et iOS. Sous iOS, les règles imposent que tout contenu Web soit affiché à l’aide de la vue Web du système d’exploitation.

Sous Windows, Qt WebView peut utiliser à la fois le Qt WebEngine module et de WebView2 pour afficher le contenu.

Sous Linux, Qt WebView s'appuie sur le Qt WebEngine module pour afficher le contenu.

Sous macOS, la vue Web système est utilisée de la même manière que sous iOS.

Prérequis

Pour que le module Qt WebView fonctionne correctement sur toutes les plateformes, il est nécessaire d’appeler la fonction QtWebView::initialize() avant de créer l’ QGuiApplication et avant que l’ QPlatformOpenGLContext de la fenêtre ne soit créée.

Utilisation du module

API QML

Les types QML du module sont accessibles via l’importation ` QtWebView `. Pour utiliser ces types, ajoutez la déclaration d’importation suivante à votre fichier .qml :

import QtWebView

API C++

L'utilisation de l'API C++ d'un module Qt nécessite une liaison avec la bibliothèque du module, soit directement, soit via d'autres dépendances. Plusieurs outils de compilation prennent cela en charge, notamment CMake et qmake.

Compilation avec CMake

Utilisez la commande « find_package() » pour localiser le composant de module requis dans le paquet « Qt6 » :

find_package(Qt6 REQUIRED COMPONENTS WebView)
target_link_libraries(mytarget PRIVATE Qt6::WebView)

Pour plus de détails, consultez la présentation « Compilation avec CMake ».

Compilation avec qmake

Pour configurer le module en vue d'une compilation avec qmake, ajoutez le module en tant que valeur de la variable ` QT ` dans le fichier `.pro` du projet :

QT += webview

Limitations

En raison des limitations de la plate-forme, le chevauchement de la variable ` WebView ` avec d'autres composants QML n'est pas pris en charge. Cela entraînerait des résultats imprévisibles, susceptibles de varier d'une plate-forme à l'autre. Les applications ne peuvent pas non plus compter sur la propagation des événements de l’ WebView vers le système de diffusion d’événements Qt. Par exemple, il n’est pas possible de « superposer » un élément invisible sur l’ WebView pour gérer certains événements, ni de gérer des événements que l’ WebView ne traite pas dans un élément parent.

Exemples

Consultez les exemples de l’Qt WebView pour découvrir comment ces API peuvent être utilisées dans des applications.

Référence

• Qt WebView QML Types
• Qt WebView C++ Classes and Namespaces

Licences

Qt WebView est disponible sous licence commerciale auprès de The Qt Company. Il est également disponible sous la licence GNU Lesser General Public License, version 3, ou la licence GNU General Public License, version 2. Consultez la page Licences Qt pour plus de détails.