WebView QML Type

Un composant permettant d'afficher du contenu Web. En savoir plus...

• Liste de tous les membres, y compris les membres hérités

Propriétés

• canGoBack : bool
• canGoForward : bool
• httpUserAgent : url (since QtWebView 1.14)
• loadProgress : int
• loading : bool
• settings : WebViewSettings (since QtWebView 6.5)
• title : string
• url : url

Signaux

• 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éthodes

• 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()

Description détaillée

WebView est un composant permettant d'afficher du contenu web. Il est implémenté à l'aide d'API natives sur les plateformes où celles-ci sont disponibles ; il ne nécessite donc pas nécessairement l'intégration d'une pile complète de navigateur web au sein de l'application.

Pour que le module Qt WebView fonctionne correctement sur toutes les plateformes, il est nécessaire d'appeler la méthode QtWebView::initialize() immédiatement après la création de l'instance QGuiApplication.

Documentation des propriétés

canGoBack : bool [read-only]

Contient la valeur « true » s'il est actuellement possible de revenir en arrière dans l'historique de navigation.

canGoForward : bool [read-only]

Contient la valeur « true » s'il est actuellement possible de naviguer vers l'avant dans l'historique de navigation.

httpUserAgent : url [since QtWebView 1.14]

L'agent utilisateur utilisé.

Cette propriété a été introduite dans QtWebView 1.14.

loadProgress : int [read-only]

La progression actuelle du chargement du contenu Web, représentée par un nombre entier compris entre 0 et 100.

loading : bool [read-only]

Renvoie « true » si l’ WebView est en train de charger du nouveau contenu, « false » dans le cas contraire.

Voir également loadingChanged().

settings : WebViewSettings [read-only, since QtWebView 6.5]

Objet de paramètres pour l'WebView.

Cette propriété a été introduite dans QtWebView 6.5.

Voir également WebViewSettings.

title : string [read-only]

Le titre de la page Web actuellement affichée.

url : url

L'URL de la page Web actuellement chargée. La modification de cette valeur déclenchera le chargement d'un nouveau contenu.

L'URL est utilisée telle quelle. Les URL provenant d'une saisie utilisateur doivent être analysées à l'aide de la fonction ` QUrl::fromUserInput()`.

Documentation sur les signaux

cookieAdded(string domain, string name)

Ce signal est émis lorsqu'un cookie est ajouté.

Les paramètres fournissent des informations sur l'domain et l'name du cookie ajouté.

cookieRemoved(string domain, string name)

Ce signal est émis lorsqu'un cookie est supprimé.

Les paramètres fournissent des informations sur l'domain et l'name du cookie supprimé.

httpUserAgentChanged(string userAgent)

Ce signal est émis chaque fois que l'userAgent e de la vue change.

Voir également httpUserAgent.

loadProgressChanged(int loadProgress)

Ce signal est émis en continu pendant le chargement d'une page Web. Le paramètre « loadProgress » est une valeur comprise entre 0 et 100, indiquant le pourcentage de la page Web qui a été chargé. Il est destiné à permettre l'affichage d'une barre de progression à l'utilisateur.

Voir également loadingChanged.

loadingChanged(WebViewLoadRequest loadRequest)

Ce signal est émis lorsque l'état de chargement du contenu Web change. En gérant ce signal, il est possible, par exemple, de réagir aux erreurs de chargement de la page.

Le paramètre ` loadRequest ` contient l'URL et le statut de la requête, ainsi qu'une chaîne `errorString` renfermant un message d'erreur en cas d'échec de la requête.

Voir également WebViewLoadRequest.

titleChanged(string title)

Ce signal est émis chaque fois que l'title e de la vue change.

Voir également title.

urlChanged(url url)

Ce signal est émis chaque fois que l'url e de la vue change.

Voir également url.

Documentation des méthodes

[since QtWebView 6.3] void deleteAllCookies()

Supprime tous les cookies.

Cette méthode a été introduite dans QtWebView 6.3.

[since QtWebView 6.3] void deleteCookie(string domain, string name)

Supprime un cookie dont les valeurs « domain » et « name » sont celles spécifiées.

Le signal « cookieRemoved » sera émis lorsque le cookie sera supprimé.

Cette méthode a été introduite dans QtWebView 6.3.

void goBack()

Permet de revenir en arrière dans l'historique de navigation.

void goForward()

Permet d'avancer dans l'historique de navigation.

void loadHtml(string html, url baseUrl)

Charge le contenu spécifié dans ` html ` dans la vue Web.

Cette méthode offre une alternative de plus bas niveau à la propriété ` url `, qui référence des pages HTML via une URL.

Les objets externes tels que les feuilles de style ou les images référencées dans le document HTML doivent être situés par rapport à ` baseUrl`. Par exemple, si html est récupéré depuis http://www.example.com/documents/overview.html, qui est l'URL de base, alors une image référencée par l'URL relative diagram.png doit se trouver à l'adresse http://www.example.com/documents/diagram.png.

Voir également url.

void reload()

Recharge l'url.

void runJavaScript(string script, variant callback)

Exécute le code JavaScript spécifié. Si une fonction ` callback ` est fournie, elle sera appelée une fois l'exécution de ` script ` terminée.

runJavaScript("document.title", function(result) { console.log(result); });

[since QtWebView 6.3] void setCookie(string domain, string name, string value)

Ajoute un cookie contenant les valeurs spécifiées pour les paramètres « domain », « name » et « value ».

Le signal cookieAdded sera émis lorsque le cookie sera ajouté.

Cette méthode a été introduite dans QtWebView 6.3.

void stop()

Arrête le chargement de l'url.