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 adecuado.

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

En Windows, Qt WebView puede utilizar tanto el Qt WebEngine el módulo como WebView2 para renderizar el contenido.

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

En macOS, la vista web del sistema se utiliza de la misma manera 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 QGuiApplication instancia y antes de que se cree el « QPlatformOpenGLContext » de la ventana.

Uso del módulo

API de QML

Los tipos QML del módulo están disponibles a través de la importación QtWebView. Para utilizar estos tipos, añade la siguiente instrucción de importación a tu archivo .qml:

import QtWebView

API de C++

Para utilizar la API de C++ de un módulo de Qt es necesario vincularse a la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación ofrecen soporte específico para ello, entre ellas CMake y qmake.

Compilación con CMake

Utiliza 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 detalles, consulta la descripción general de «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 limitaciones de la plataforma, no se admite la superposición de WebView con otros componentes QML. Hacerlo dará lugar a resultados impredecibles, que pueden variar de una plataforma a otra. Las aplicaciones tampoco pueden confiar en que los eventos del WebView se propaguen al sistema de entrega de eventos de Qt. Por ejemplo, no es posible «superponer» un elemento invisible sobre el WebView para gestionar determinados eventos, ni gestionar eventos que el WebView no procese en un elemento padre.

Ejemplos

Consulta 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. Consulte Licencias de Qt para obtener 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.