WebView QML Type

Un componente para mostrar contenido web. Más...

• Lista de todos los miembros, incluidos los heredados

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 utilizando APIs nativas en las plataformas en las que esto está disponible, 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() justo después de crear la instancia QGuiApplication.

Documentación de propiedades

canGoBack : bool [read-only]

Holds true si actualmente es posible navegar hacia atrás en el historial web.

canGoForward : bool [read-only]

Holds true si actualmente es posible navegar hacia adelante en el historial web.

httpUserAgent : url [since QtWebView 1.14]

El agente de usuario en uso.

Esta propiedad se introdujo en QtWebView 1.14.

loadProgress : int [read-only]

El progreso de carga actual del contenido web, representado como un número entero entre 0 y 100.

loading : bool [read-only]

Mantiene true si WebView está en proceso de cargar nuevo contenido, false en caso contrario.

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 cargada actualmente.

url : url

La URL de la página web cargada actualmente. Si se cambia, se cargará un nuevo contenido.

La URL se utiliza tal cual. Las URLs que se originan de la entrada del usuario deben ser analizadas con QUrl::fromUserInput().

Documentación de 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 domain y name de la cookie añadida.

cookieRemoved(string domain, string name)

Esta señal se emite cuando se borra una cookie.

Los parámetros proporcionan información sobre domain y name de la cookie eliminada.

httpUserAgentChanged(string userAgent)

Esta señal se emite cada vez que cambia la dirección userAgent de la vista.

Véase también httpUserAgent.

loadProgressChanged(int loadProgress)

Esta señal se emite continuamente durante la carga de una página web. El parámetro loadProgress es un valor entre 0 y 100, que indica qué porcentaje de la página web se ha cargado. El uso previsto para esto es mostrar una barra de progreso al usuario.

Véase también loadingChanged.

loadingChanged(WebViewLoadRequest loadRequest)

Esta señal se emite cuando cambia el estado de carga del contenido web. Manejando esta señal es posible, por ejemplo, reaccionar ante errores de carga de la página.

El parámetro loadRequest contiene la url y el estado de la petición, así como un errorString que contiene un mensaje de error para una petición fallida.

Véase también WebViewLoadRequest.

titleChanged(string title)

Esta señal se emite cada vez que cambia la dirección title de la vista.

Véase también title.

urlChanged(url url)

Esta señal se emite cada vez que cambia la dirección url de la vista.

Véase también url.

Documentación del método

[since QtWebView 6.3] void deleteAllCookies()

Borra 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 las direcciones domain y name especificadas.

La señal cookieRemoved será emitida cuando la cookie sea eliminada.

Este método se introdujo en QtWebView 6.3.

void goBack()

Navega hacia atrás en el historial de la web.

void goForward()

Navega hacia adelante en el historial de la web.

void loadHtml(string html, url baseUrl)

Carga el contenido especificado de html en la vista web.

Este método ofrece una alternativa de nivel inferior a la propiedad url, que hace referencia a páginas HTML mediante URL.

Los objetos externos, como las hojas de estilo o las imágenes a las que se hace referencia en el documento HTML, deben ubicarse en relación con baseUrl. Por ejemplo, si html se recupera de http://www.example.com/documents/overview.html, que es la URL base, entonces una imagen referenciada con la url relativa, diagram.png, debería estar en http://www.example.com/documents/diagram.png.

Véase también url.

void reload()

Vuelve a cargar la página url.

void runJavaScript(string script, variant callback)

Ejecuta el JavaScript especificado. En caso de que se proporcione una función callback, se invocará después de que script termine de ejecutarse.

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 las direcciones domain, name y value especificadas.

La señal cookieAdded será emitida cuando la cookie sea añadida.

Este método se introdujo en QtWebView 6.3.

void stop()

Detiene la carga de la página url.