WebView QML Type
Un componente para mostrar contenido web. Más...
| Import Statement: | import QtWebView |
Propiedades
- canGoBack : bool
- canGoForward : bool
- httpUserAgent : url
(since QtWebView 1.14) - loadProgress : int
- loading : bool
- settings : WebViewSettings
(since QtWebView 6.5) - title : string
- url : url
Señales
- cookieAdded(string domain, string name)
- cookieRemoved(string domain, string name)
- httpUserAgentChanged(string userAgent)
- loadProgressChanged(int loadProgress)
- loadingChanged(WebViewLoadRequest loadRequest)
- titleChanged(string title)
- urlChanged(url url)
Métodos
- void deleteAllCookies()
(since QtWebView 6.3) - void deleteCookie(string domain, string name)
(since QtWebView 6.3) - void goBack()
- void goForward()
- void loadHtml(string html, url baseUrl)
- void reload()
- void runJavaScript(string script, variant callback)
- void setCookie(string domain, string name, string value)
(since QtWebView 6.3) - void stop()
Descripción detallada
WebView es un componente para mostrar contenido web que se implementa mediante API nativas en las plataformas en las que están disponibles, por lo que no requiere necesariamente incluir una pila completa de navegador web como parte de la aplicación.
Para que el módulo « Qt WebView » funcione correctamente en todas las plataformas, es necesario llamar a ` QtWebView::initialize()` inmediatamente después de crear la instancia de ` QGuiApplication `.
Nota: Debido a limitaciones de la plataforma, no se admite la superposición de WebView con otros componentes QML.
Documentación de propiedades
canGoBack : bool [read-only]
Almacena el valor « true » si actualmente es posible retroceder en el historial web.
canGoForward : bool [read-only]
Almacena el valor « true » si actualmente es posible avanzar en el historial web.
httpUserAgent : url [since QtWebView 1.14]
El agente de usuario que se está utilizando.
Esta propiedad se introdujo en QtWebView 1.14.
loadProgress : int [read-only]
El progreso actual de la carga del contenido web, representado como un número entero comprendido entre 0 y 100.
loading : bool [read-only]
Devuelve « true » si el « WebView » está cargando contenido nuevo en ese momento; en caso contrario, devuelve « false ».
Véase también loadingChanged().
settings : WebViewSettings [read-only, since QtWebView 6.5]
Objeto de configuración para ` WebView`.
Esta propiedad se introdujo en QtWebView 6.5.
Véase también WebViewSettings.
title : string [read-only]
El título de la página web que se está cargando actualmente.
url : url
La URL de la página web cargada actualmente. Si se modifica, se cargará nuevo contenido.
La URL se utiliza tal cual. Las URL que provienen de la entrada del usuario deben analizarse con QUrl::fromUserInput().
Nota: La función ` WebView ` no admite la carga de contenido a través del sistema de recursos de Qt.
Documentación sobre señales
cookieAdded(string domain, string name)
Esta señal se emite cuando se añade una cookie.
Los parámetros proporcionan información sobre el domain y el name de la cookie añadida.
Nota: Cuando se utiliza el módulo Qt WebEngine como backend, la señal cookieAdded se emitirá para cualquier cookie añadida a la QWebEngineCookieStore subyacente, incluidas aquellas añadidas por sitios web. En los demás casos, la señal cookieAdded solo se emite para las cookies añadidas explícitamente con setCookie().
Nota: El controlador correspondiente es onCookieAdded.
cookieRemoved(string domain, string name)
Esta señal se emite cuando se elimina una cookie.
Los parámetros proporcionan información sobre el domain y el name de la cookie eliminada.
Nota: El controlador correspondiente es onCookieRemoved.
httpUserAgentChanged(string userAgent)
Esta señal se emite cada vez que cambia el ` userAgent ` de la vista.
Nota: El controlador correspondiente es onHttpUserAgentChanged.
Véase también httpUserAgent.
loadProgressChanged(int loadProgress)
Esta señal se emite de forma continua durante la carga de una página web. El parámetro « loadProgress » es un valor comprendido entre 0 y 100 que indica qué porcentaje de la página web se ha cargado. Su finalidad es mostrar una barra de progreso al usuario.
Nota: Algunos backends no admiten cambios fraccionarios en el progreso de la carga y solo emitirán esta señal al inicio y al final de una carga, con valores de 0 y 100, respectivamente.
Nota: El controlador correspondiente es onLoadProgressChanged.
Véase también loadingChanged.
loadingChanged(WebViewLoadRequest loadRequest)
Esta señal se emite cuando cambia el estado de la carga del contenido web. Al gestionar esta señal, es posible, por ejemplo, reaccionar ante errores en la carga de la página.
El parámetro loadRequest contiene la URL y el estado de la solicitud, así como un errorString con un mensaje de error en caso de que la solicitud haya fallado.
Nota: El controlador correspondiente es onLoadingChanged.
Véase también WebViewLoadRequest.
titleChanged(string title)
Esta señal se emite cada vez que cambia el ` title ` de la vista.
Nota: El controlador correspondiente es onTitleChanged.
Véase también title.
urlChanged(url url)
Esta señal se emite cada vez que cambia el url de la vista.
Nota: El controlador correspondiente es onUrlChanged.
Véase también url.
Documentación del método
[since QtWebView 6.3] void deleteAllCookies()
Elimina todas las cookies.
Este método se introdujo en QtWebView 6.3.
[since QtWebView 6.3] void deleteCookie(string domain, string name)
Elimina una cookie con los valores especificados para « domain » y « name ».
Se emitirá la señal « cookieRemoved » cuando se elimine la cookie.
Este método se introdujo en QtWebView 6.3.
void goBack()
Permite retroceder en el historial de navegación.
void goForward()
Avanza en el historial web.
void loadHtml(string html, url baseUrl)
Carga el contenido especificado en html en la vista web.
Este método ofrece una alternativa de nivel más bajo a la propiedad url, que hace referencia a páginas HTML a través de una URL.
Los objetos externos, como las hojas de estilo o las imágenes a las que se hace referencia en el documento HTML, deben estar ubicados de forma relativa respecto a ` baseUrl`. Por ejemplo, si se recupera html desde http://www.example.com/documents/overview.html, que es la URL base, entonces una imagen a la que se hace referencia con la URL relativa diagram.png debería encontrarse en http://www.example.com/documents/diagram.png.
Nota: El WebView no admite la carga de contenido a través del sistema de recursos de Qt.
Véase también url.
void reload()
Vuelve a cargar el archivo « url » actual.
void runJavaScript(string script, variant callback)
Ejecuta el código JavaScript especificado. En caso de que se proporcione una función ` callback `, esta se invocará una vez que haya finalizado la ejecución de ` script `.
runJavaScript("document.title", function(result) { console.log(result); });[since QtWebView 6.3] void setCookie(string domain, string name, string value)
Añade una cookie con los valores especificados: domain, name y value.
La señal cookieAdded se emitirá cuando se añada la cookie.
Este método se introdujo en QtWebView 6.3.
void stop()
Detiene la carga del archivo « url » actual.
© 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.