WebView QML Type

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

Import Statement: import QtWebView

Propriétés

Signaux

Méthodes

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.

Note : En raison des limitations de la plate-forme, le chevauchement du WebView et d'autres composants QML n'est pas pris en charge.

Propriété Documentation

canGoBack : bool [read-only]

Contient true s'il est actuellement possible de naviguer en arrière dans l'historique Web.


canGoForward : bool [read-only]

Contient true s'il est actuellement possible de naviguer vers l'avant dans l'historique du web.


httpUserAgent : url [since QtWebView 1.14]

L'agent utilisateur utilisé.

Note : sur WinRT, cette propriété affecte tous les WebViews de l'application.

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 entre 0 et 100.


loading : bool [read-only]

Tient true si WebView est en cours de chargement d'un nouveau contenu, false dans le cas contraire.

Voir également loadingChanged().


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

Objet de paramètres pour 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 chargée.


url : url

L'URL de la page web actuellement chargée. La modification de cette propriété 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().

Remarque : WebView ne prend pas en charge le chargement de contenu via le système de ressources Qt.


Documentation du 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é.

Remarque : lorsque le module Qt WebEngine est utilisé comme backend, le signal cookieAdded est émis pour tout cookie ajouté au module sous-jacent QWebEngineCookieStore, y compris ceux ajoutés par les sites web. Dans les autres cas, le signal cookieAdded n'est émis que pour les cookies explicitement ajoutés avec setCookie().

Remarque : le gestionnaire correspondant est onCookieAdded.


cookieRemoved(string domain, string name)

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

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

Remarque : Le gestionnaire correspondant est onCookieRemoved.


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.

Remarque : le gestionnaire correspondant est onLoadingChanged.

Voir également WebViewLoadRequest.


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 adresses domain et name 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()

Navigue vers l'arrière dans l'historique de la page web.


void goForward()

Navigue vers l'avant dans l'historique 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 fait référence aux 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.

Remarque : WebView ne prend pas en charge le chargement de contenu par l'intermédiaire du système de ressources Qt.

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 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ête le chargement de la page courante url.


© 2025 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.