Qt WebView

Qt WebView vous permet d'afficher du contenu web dans une application QML. Pour éviter d'inclure une pile complète de navigateurs web, Qt WebView utilise des API natives le cas échéant.

Cela est utile sur les plateformes mobiles, telles qu'Android et iOS. Sur iOS, les politiques imposent que tout le contenu web soit affiché à l'aide de la vue web du système d'exploitation.

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

Sous Linux, Qt WebView dépend du module Qt WebEngine pour rendre le contenu.

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

Conditions préalables

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

Utilisation du module

API QML

Les types QML du module sont disponibles via l'importation de QtWebView. Pour utiliser les types, ajoutez l'instruction d'importation suivante à votre fichier .qml :

import QtWebView

API C++

L'utilisation de l'API C++ d'un module Qt nécessite l'établissement d'un lien avec la bibliothèque du module, soit directement, soit par l'intermédiaire d'autres dépendances. Plusieurs outils de construction disposent d'un support dédié à cet effet, notamment CMake et qmake.

Construction avec CMake

Utilisez la commande find_package() pour localiser le composant de module nécessaire dans le paquetage Qt6:

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

Pour plus de détails, voir l'aperçu de la construction avec CMake.

Construction avec qmake

Pour configurer le module afin qu'il soit construit avec qmake, ajoutez le module comme valeur de la variable QT dans le fichier .pro du projet :

QT += webview

Limitations

En raison des limitations de la plate-forme, la superposition de WebView avec d'autres composants QML n'est pas prise en charge. Cela entraînera des résultats imprévisibles, qui peuvent varier d'une plate-forme à l'autre. Les applications ne peuvent pas non plus compter sur les événements du site WebView pour se propager dans le système de distribution d'événements de Qt. Par exemple, il n'est pas possible de "superposer" un élément invisible au-dessus de WebView pour gérer certains événements, ou pour gérer des événements que WebView ne traite pas dans un élément parent.

Exemples

Consultez les exemples deQt WebView pour voir comment les 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. En outre, il est disponible sous la licence GNU Lesser General Public License, version 3, ou la licence GNU General Public License, version 2. Voir Qt Licensing pour plus de détails.