WebView QML Type

Composant permettant d'afficher du contenu web. Plus d'informations...

• 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 qui est mis en œuvre à l'aide d'API natives sur les plates-formes où elles sont disponibles. Il n'est donc pas nécessairement nécessaire d'inclure une pile complète de navigateurs web dans l'application.

Pour que le module Qt WebView fonctionne correctement sur toutes les plateformes, il est nécessaire d'appeler QtWebView::initialize() juste après avoir créé l'instance QGuiApplication.

Documentation sur les propriétés

canGoBack : bool [read-only]

Tient true s'il est actuellement possible de naviguer en arrière dans l'historique du site web.

canGoForward : bool [read-only]

Tient true s'il est actuellement possible de naviguer vers l'avant dans l'historique Web.

httpUserAgent : url [since QtWebView 1.14]

L'agent utilisateur utilisé.

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

loadProgress : int [read-only]

L'état d'avancement du chargement du contenu web, représenté par un nombre entier compris entre 0 et 100.

loading : bool [read-only]

Contient true si le site WebView est en train de charger un nouveau contenu, false dans le cas contraire.

Voir aussi loadingChanged().

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

Objet de paramétrage pour le site WebView.

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

Voir aussi WebViewSettings.

title : string [read-only]

Le titre de la page web actuellement chargée.

url : url

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

L'URL est utilisée telle quelle. Les URL qui proviennent d'une entrée utilisateur doivent être analysées avec QUrl::fromUserInput().

Documentation sur le signal

cookieAdded(string domain, string name)

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

Les paramètres fournissent des informations sur domain et 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 domain et name du cookie supprimé.

httpUserAgentChanged(string userAgent)

Ce signal est émis lorsque le site userAgent 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ée. L'utilisation prévue est l'affichage d'une barre de progression à l'intention de l'utilisateur.

Voir aussi loadingChanged.

loadingChanged(WebViewLoadRequest loadRequest)

Ce signal est émis lorsque l'état de chargement du contenu web change. En traitant 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 l'état de la demande, ainsi qu'une chaîne d'erreur (errorString ) contenant un message d'erreur en cas d'échec de la demande.

Voir aussi WebViewLoadRequest.

titleChanged(string title)

Ce signal est émis lorsque le site title de la vue change.

Voir également title.

urlChanged(url url)

Ce signal est émis lorsque le site url de la vue change.

Voir également url.

Documentation de la méthode

[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 avec les valeurs spécifiées domain et name.

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 du site web.

void goForward()

Navigue vers l'avant dans l'historique du site web.

void loadHtml(string html, url baseUrl)

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

Cette méthode offre une alternative de niveau inférieur à la propriété url, qui référence les pages HTML via l'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é à partir de http://www.example.com/documents/overview.html, qui est l'URL de base, une image référencée avec l'URL relative, diagram.png, doit se trouver à http://www.example.com/documents/diagram.png.

Voir aussi url.

void reload()

Recharge le site actuel url.

void runJavaScript(string script, variant callback)

Exécute le JavaScript spécifié. Si une fonction callback est fournie, elle sera invoquée une fois que la fonction script aura fini de s'exécuter.

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

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

Ajoute un cookie avec les valeurs spécifiées 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êt du chargement du site actuel url.