En esta página

Qt WebView

Qt WebView te permite mostrar contenido web dentro de una aplicación QML. Para evitar incluir una pila completa de navegador web, Qt WebView utiliza API nativas cuando es necesario.

Esto es útil en plataformas móviles, como Android e iOS. En iOS, las políticas dictan que todo el contenido web se muestre utilizando la vista web del sistema operativo.

En Windows, Qt WebView puede utilizar tanto Qt WebEngine como WebView2 para mostrar el contenido.

En Linux, Qt WebView depende del módulo Qt WebEngine para mostrar el contenido.

En macOS, la vista web del sistema se utiliza del mismo modo que en iOS.

Requisitos previos

Para que el módulo Qt WebView funcione correctamente en todas las plataformas, es necesario llamar a QtWebView::initialize() antes de crear la instancia QGuiApplication y antes de crear la ventana QPlatformOpenGLContext.

Uso del módulo

API QML

Los tipos QML del módulo están disponibles a través de la importación QtWebView. Para utilizar los tipos, añada la siguiente sentencia import a su archivo .qml:

import QtWebView

API C

Utilizar la API C++ de un módulo Qt requiere enlazar con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación tienen soporte dedicado para esto, incluyendo CMake y qmake.

Construcción con CMake

Utilice el comando find_package() para localizar el componente del módulo necesario en el paquete Qt6:

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

Para obtener más información, consulta la descripción general de la compilación con CMake.

Compilación con qmake

Para configurar el módulo para su compilación con qmake, añada el módulo como valor de la variable QT en el archivo .pro del proyecto:

QT += webview

Limitaciones

Debido a las limitaciones de la plataforma, no es posible superponer WebView con otros componentes QML. Hacer esto tendrá resultados impredecibles, que pueden diferir de una plataforma a otra. Las aplicaciones tampoco pueden confiar en que los eventos de WebView se propaguen al sistema de entrega de eventos de Qt. Por ejemplo, no es posible "superponer" un elemento invisible sobre WebView para gestionar determinados eventos, o gestionar eventos que WebView no procesa en un elemento padre.

Ejemplos

Consulte los Ejemplos deQt WebView para ver una demostración de cómo se pueden utilizar las API en las aplicaciones.

Referencia

Licencias

Qt WebView está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Ver Licencias Qt para más detalles.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.