Qt WebEngine Fonctionnalités

Qt WebEngine prend en charge les fonctionnalités suivantes :

Codecs audio et vidéo

Qt WebEngine Le format de fichier MPEG-4 Part 14 (MP4) n'est pris en charge par Qt que si les codecs audio et vidéo propriétaires requis, tels que H.264 et MPEG layer-3 (MP3), ont été activés. Les codecs propriétaires peuvent être activés en passant l'option suivante à l'outil configure lors de la configuration de Qt Tool :

-webengine-proprietary-codecs

Par exemple, l'option suivante peut être passée lors de la configuration de Qt pour le construire au niveau supérieur :

configure -webengine-proprietary-codecs

Pour plus d'informations, voir les options de configuration de Qt.

Lorsque l'on utilise cmake pour construire uniquement le module Qt WebEngine, la commande suivante peut être utilisée pour configurer et construire (dans cet exemple, le code source de Qt WebEngine est situé dans C:\qt\qtwebengine) :

qt-configure-module C:\qt\qtwebengine -webengine-proprietary-codecs
cmake --build . --parallel

Attention : Lorsque vous distribuez des bibliothèques de codecs propriétaires, vous devez en acquérir la licence.

FFmpeg est une solution multiplateforme pour enregistrer, convertir et diffuser de l'audio et de la vidéo. Il peut être configuré pour être utilisé avec plusieurs codecs, ce qui pose des problèmes de licence lors de la distribution avec les bibliothèques de codecs. Pour certains codecs, des implémentations open source, telles que OpenH264, sont disponibles.

Pilote WebEngineDriver

Avec WebEngineDriver, vous pouvez automatiser le test des sites web sur l'ensemble des navigateurs. WebEngineDriver est basé sur ChromeDriver et peut être utilisé de la même manière. Pour plus d'informations sur ChromeDriver et son utilisation, visitez le site utilisateur de ChromeDriver.

WebEngineDriver a subi de légères modifications par rapport à ChromeDriver pour pouvoir se connecter aux navigateurs basés sur Qt WebEngine. Il est compatible avec les exemples de navigateurs Qt WebEngine, tels que Simple Browser ou Nano Browser.

L'automatisation du navigateur est scriptée par l'intermédiaire d'un client WebDriver tel que Selenium WebDriver. Par exemple, WebEngineDriver peut être utilisé avec le langage Python de Selenium WebDriver :

from selenium import webdriver
from selenium.webdriver.chrome.service import Service

service = Service(executable_path='QTDIR/libexec/webenginedriver')
options = webdriver.ChromeOptions()
options.binary_location = 'path/to/browser_binary'

driver = webdriver.Chrome(service=service, options=options)
driver.get("http://www.google.com/")
driver.quit()

Dans cet exemple,

  • executable_path doit être défini comme le chemin binaire de WebEngineDriver
  • QTDIR est le répertoire dans lequel Qt est installé
  • options.binary_location doit être défini sur le chemin binaire du navigateur

Note : Sous Windows : executable_path='QTDIR/bin/webenginedriver.exe'

Avant d'exécuter le script, la variable d'environnement QTWEBENGINE_REMOTE_DEBUGGING doit être définie. Sa valeur est un numéro de port utilisé par le navigateur et le WebEngineDriver pour communiquer entre eux.

export QTWEBENGINE_REMOTE_DEBUGGING=12345

En s'exécutant, le script ouvre le navigateur web spécifié et charge le site web de Google.

WebEngineDriver peut également être attaché à un navigateur déjà en cours d'exécution s'il a été démarré avec le port de débogage à distance défini. options.debugger_address doit être défini comme l'adresse de débogage à distance dans le script :

options.debugger_address = 'localhost:12345'

Dans ce cas, options.binary_location ne doit pas être défini car le navigateur est déjà en cours d'exécution. La variable d'environnement QTWEBENGINE_REMOTE_DEBUGGING n'est pas utilisée par le WebEngineDriver si options.debugger_address est défini.

Remarque : le WebEngineDriver doit être construit avec la même version de Chromium que celle utilisée par Qt WebEngine.

Outils de développement de Chromium

Les DevTools de Chromium permettent d'inspecter et de déboguer les problèmes de mise en page et de performance de n'importe quel contenu web.

Cette fonctionnalité peut être testée en lançant une application Qt WebEngine avec l'option de ligne de commande --remote-debugging-port=[your-port] ou en définissant la variable d'environnement QTWEBENGINE_REMOTE_DEBUGGING, puis en utilisant un navigateur basé sur Chromium (tel que Simple Browser ou Nano Browser) pour se connecter à http://localhost:[your-port].

Remarque : toute option de ligne de commande WebEngine doit être spécifiée après l'option --webEngineArgs, qui est utilisée pour séparer les options spécifiques à l'application de l'utilisateur de celles de WebEngine.

--webEngineArgs --remote-debugging-port=5000

Pour éviter les erreurs WebSocket lors du débogage à distance, ajoutez un argument de ligne de commande supplémentaire --remote-allow-origins=<origin>[,<origin>, ...], où <origin> fait référence à l'origine de la requête. Utilisez --remote-allow-origins=* pour autoriser les connexions de toutes les origines. Si rien n'est spécifié, Qt WebEngine ajoutera --remote-allow-origins=* aux arguments de la ligne de commande lorsque le débogage à distance est activé, autorisant ainsi les demandes de toutes les origines.

La page Chromium DevTools peut également être affichée dans l'application. Pour ce faire, vous pouvez appeler soit QWebEnginePage::setInspectedPage() vers la page à inspecter, ce qui charge implicitement les DevTools dans la page this, soit QWebEnginePage::setDevToolsPage() pour permettre à la page this d'être inspectée.

Les propriétés QML correspondantes sont WebEngineView.devToolsView et WebEngineView.inspectedView.

Pour plus d'informations, voir Qt WebEngine Debugging and Profiling.

Certificats des clients

Certains serveurs web, en particulier de nombreux sites intranet, exigent que le client s'authentifie à l'aide d'un certificat, appelé certificat client. Qt WebEngine lira les certificats clients installés dans les paramètres du système sous macOS et Windows, et sous Linux, ceux installés dans la base de données NSS. Les certificats peuvent être installés dans la base de données NSS à l'aide de l'outil pk12util.

Par défaut, Qt WebEngine ne propose aucun certificat client aux serveurs, car cela permet d'identifier l'utilisateur de manière unique et pourrait porter atteinte à la vie privée.

Pour activer la prise en charge des certificats clients, une application doit écouter les signaux QWebEnginePage::selectClientCertificate ou WebEngineView.selectClientCertificate et sélectionner l'un des certificats proposés. Pour les applications qui peuvent naviguer vers des sites web non fiables, il est recommandé de toujours laisser le choix à l'utilisateur avant de l'identifier de manière unique auprès d'un serveur distant.

En plus du certificat client stocké dans les paramètres du système, Qt WebEngine propose également le stockage en mémoire. L'instance QWebEngineClientCertificateStore peut être obtenue avec la méthode QWebEngineProfile::clientCertificateStore(). Une application peut utiliser cette classe pour ajouter un nouveau certificat avec un appel QWebEngineClientCertificateStore::add(). Notez que lors des appels à selectClientCertificate, Qt WebEngine répertorie les certificats des clients stockés dans le système et en mémoire.

Voir également l'exemple de certificat client pour plus de détails sur la mise en œuvre.

Schémas personnalisés

Qt WebEngine permet à l'application de définir ses propres schémas d'URL personnalisés avec des politiques de sécurité et des mécanismes de transport spécialisés.

Les schémas personnalisés peuvent être utilisés pour mettre en œuvre des protocoles réseau alternatifs avec toutes les politiques de sécurité web habituelles, des schémas internes privilégiés pour afficher des composants d'interface utilisateur ou des informations de débogage, des schémas en bac à sable avec des restrictions supplémentaires, et ainsi de suite.

Pour plus d'informations, voir QWebEngineUrlScheme et QWebEngineUrlSchemeHandler.

Glisser-déposer

Qt WebEngine prend en charge le glisser-déposer HTML5.

Cette fonctionnalité peut être testée en ouvrant une démo HTML5 de glisser-déposer, telle que HTML5 Demos - Drag and Drop, HTML5 Demos - Simple Drag and Drop , ou HTML5 Demos - Drag and Drop, Automatic Upload, dans Simple Browser ou Nano Browser.

Le glissement de fichiers dans le navigateur ne fait pas partie du HTML5, mais il est pris en charge. Il peut être testé en ouvrant HTML5 Demos - File API.

La prise en charge de cette fonctionnalité a été ajoutée dans Qt 5.7.0.

Favicon

Qt WebEngine prend en charge l'icône de l'URL du site web, favicon. Chaque icône est stockée dans la base de données interne pour chaque QWebEngineProfile et peut être accédée en utilisant un appel QWebEnginePage::icon() ou une propriété WebEngineView.icon pour le contenu actuellement chargé.

En outre, Qt WebEngine fournit une API permettant d'accéder aux icônes déjà stockées dans la base de données interne du profil.

Remarque : la base de données d'icônes n'est pas disponible pour les profils non enregistrés.

Gestion du Favicon QML

Pour accéder aux icônes, un site QQuickImageProvider est enregistré. Ce fournisseur est accessible par une URL spéciale où le schéma est "image :" et l'hôte "favicon".

Image {
    source: "image://favicon/url"
}

L'adresse url peut être l'URL du favicon :

Image {
    source: "image://favicon/https://www.qt.io/hubfs/2016_Qt_Logo/qt_logo_green_rgb_16x16.png"
}

Le url peut également être l'URL d'une page pour accéder à son icône :

Image {
    source: "image://favicon/https://www.qt.io/"
}

Si plusieurs icônes sont disponibles, la propriété Image::sourceSize peut être spécifiée pour choisir l'icône de la taille souhaitée. Si la propriété Image::sourceSize n'est pas spécifiée ou si elle est égale à 0, c'est la plus grande icône disponible qui sera choisie.

Le fournisseur d'images recherche l'icône demandée dans les instances WebEngineView existantes. Il tente d'abord de trouver une correspondance avec les icônes actuellement affichées. Si aucune correspondance n'est trouvée, il demande l'icône dans la base de données. Chaque profil possède sa propre base de données d'icônes, qui est stockée dans la mémoire permanente, de sorte que les icônes stockées sont également accessibles sans connexion réseau. L'icône doit avoir été chargée au préalable pour être stockée dans la base de données.

Gestion des icônes C++

Un utilisateur peut demander une icône à partir du contenu précédemment chargé pour chaque QWebEngineProfile en utilisant les appels QWebEngineProfile::requestIconForPageURL() ou QWebEngineProfile::requestIconForIconURL(). Notez que la base de données du profil est stockée dans la mémoire persistante et peut être consultée sans connexion réseau.

Plein écran

Qt WebEngine prend en charge l'affichage du contenu web en mode plein écran. Pour plus d'informations, voir WebEngineSettings.fullscreenSupportEnabled, WebEngineView.fullScreenRequested, QWebEngineSettings::FullScreenSupportEnabled, et QWebEnginePage::fullScreenRequested.

Cette fonctionnalité peut être testée en lisant une vidéo de YouTube dans Video Player ou Nano Browser, et en cliquant sur l'icône plein écran pour passer en mode plein écran.

La prise en charge de cette fonctionnalité a été ajoutée dans Qt 5.6.0.

Accélération matérielle

QtWebEngine tente d'utiliser l'accélération matérielle pour le rendu du contenu. Elle utilise les API OpenGL ou OpenGLES pour exécuter les appels de rendu sur le GPU. En guise de solution de repli, le rendu logiciel est utilisé lorsque le matériel ne répond pas à l'ensemble des fonctionnalités OpenGL requises. Un utilisateur peut vérifier l'état actuel de l'accélération matérielle en chargeant la page interne chrome://gpu. De plus, l'accélération peut être explicitement désactivée avec QTWEBENGINE_CHROMIUM_FLAGS en utilisant le commutateur disable-gpu. Par exemple sous Linux :

export QTWEBENGINE_CHROMIUM_FLAGS=--disable-gpu

HTML5 DRM

Qt WebEngine permet de visionner des vidéos protégées par DRM si le plugin Widevine CDM a été installé. Le plugin CDM remplace les plugins basés sur Flash pour afficher les contenus protégés par DRM. Il n'existe qu'en format binaire, ce qui permet de cacher les détails de la mise en œuvre du décryptage des DRM. Il peut être obtenu auprès d'une tierce partie ou à partir d'une installation de Google Chrome.

Qt WebEngine on startup recherche le plugin Widevine CDM dans des emplacements bien connus, comme le répertoire d'installation par défaut de Google Chrome ou les chemins spécifiques aux distributions Linux. Cependant, l'emplacement du plugin peut également être transmis avec QTWEBENGINE_CHROMIUM_FLAGS en utilisant widevine-path.

Sous Windows :

set QTWEBENGINE_CHROMIUM_FLAGS=--widevine-path="C:/some path/widevinecdm.dll"

Sous Linux :

export QTWEBENGINE_CHROMIUM_FLAGS=--widevine-path="/some path/libwidevinecdm.so"

Sous macOS :

export QTWEBENGINE_CHROMIUM_FLAGS=--widevine-path="/some path/libwidevinecdm.dylib"

Le format vidéo le plus couramment utilisé par les services DRM, H.264, nécessite des codecs audio et vidéo propriétaires. Pour plus d'informations sur l'activation des codecs, voir Codecs audio et vidéo.

Cette fonctionnalité peut être testée en lisant une vidéo dans Simple Browser ou Nano Browser de castLabs, Swank Motion Pictures, Inc. ou Bitmovin Player.

La prise en charge de cette fonctionnalité a été ajoutée dans Qt 5.7.0.

Géolocalisation HTML5

Qt WebEngine prend en charge l'API de géolocalisation JavaScript avec Qt Positioning comme backend. La géolocalisation HTML5 est désactivée par défaut. Pour l'autoriser explicitement, l'application doit écouter QWebEnginePage::permissionRequested. Lorsqu'une demande de permission de type QWebEnginePermission::PermissionType::Geolocation est reçue, vous pouvez appeler QWebEnginePermission::grant() sur l'objet reçu pour accorder la permission requise.

Si Qt WebEngine a été construit avec le support de Qt Positioning, cette fonctionnalité peut être testée en utilisant Maps et en lui permettant de trouver la position actuelle de l'utilisateur.

Remarque : sous Windows 11, activez les paramètres pour permettre à l'exemple de cartes d'accéder aux services de localisation de Windows. Dans l'application Paramètres, sous Privacy & Security > Location, activez Location services, Let apps access your location et Let desktop apps access your location.

Voir Qt Positioning pour une configuration possible du backend comme le GPS ou le positionnement basé sur l'IP.

La prise en charge de cette fonctionnalité a été ajoutée dans Qt 5.5.0.

HTML5 WebSockets

Qt WebEngine prend en charge l'API JavaScript WebSocket pour communiquer avec les serveurs WebSocket à l'aide des protocoles ws:// ou wss://. De plus, l'intégration avec Qt WebChannel et Qt WebSockets permet la communication entre JavaScript et le côté natif de l'application.

Le module Qt WebChannel présente un excellent exemple de serveur de chat et de son client de chat basé sur le web. Le client fonctionne d'emblée dans les exemples de navigateurs de Qt WebEngine (tels que Simple Browser ou Nano Browser).

Protocole HTTP/2

Qt WebEngine supporte l'implémentation Chromium du protocole HTTP/2.

Cette fonctionnalité peut être testée en ouvrant une démo HTTP/2, telle que la démo HTTP/2 d'Akamai, dans Simple Browser ou Nano Browser.

Stockage local

Qt WebEngine prend en charge l'enregistrement de paires clé-valeur dans un site Local Storage sans date d'expiration. Il s'agit d'une partie de l'API de stockage web, où un utilisateur peut accéder à un objet Storage pour les domaines donnés à l'aide de la propriété JavaScript Window.localStorage. Les données stockées persistent même après la fermeture de la page ou de l'application du navigateur.

Notez que le stockage Local peut également être désactivé à l'aide d'un paramètre QWebEngineSettings::LocalStorageEnabled. En outre, le chemin de stockage peut être modifié par un appel à QWebEngineProfile::setPersistentStoragePath.

QWebEngineProfile profile("MyProfile");
profile.settings()->setAttribute(QWebEngineSettings::LocalStorageEnabled, isEnabled);
profile.setPersistentStoragePath("/path/to/storage");

Qt WebEngine Le siteQt WebEngine Developer Tools offre également un moyen facile d'examiner le contenu de Local Storage en visitant le panneau Application et en développant le menu Local Storage.

Dialogues natifs

Une page web peut demander des boîtes de dialogue pour les fonctions suivantes :

  • saisie des informations d'identification de l'utilisateur pour l'authentification HTTP et proxy
  • Affichage d'alertes JavaScript, de boîtes de dialogue de confirmation et d'invites
  • Choix des couleurs
  • Sélection de fichiers
  • Affichage des messages de validation des formulaires

Qt WebEngine fournit des boîtes de dialogue standard pour ces fonctions. Dans les applications basées sur des widgets, les boîtes de dialogue standard sont basées sur QDialog, tandis que dans les applications Qt Quick, elles peuvent être basées sur Qt Quick Controls 1 ou Qt Quick Controls 2 (depuis Qt 5.8). Ces dernières ne sont utilisées que sur les plates-formes eglfs.

Pour forcer explicitement l'utilisation de boîtes de dialogue basées sur Qt Quick Controls 1 ou Qt Quick Controls 2, définissez la variable d'environnement QTWEBENGINE_DIALOG_SET à QtQuickControls1 ou QtQuickControls2.

Qt WebEngine Les boîtes de dialogue des widgets peuvent être personnalisées en réimplémentant les fonctions QWebEnginePage::chooseFiles(), QWebEnginePage::javaScriptAlert(), QWebEnginePage::javaScriptConfirm() et QWebEnginePage::javaScriptPrompt().

Depuis Qt 5.8, les boîtes de dialogue Qt Quick peuvent être personnalisées en se connectant aux signaux WebEngineView::authenticationDialogRequested(), WebEngineView::javaScriptDialogRequested(), WebEngineView::colorDialogRequested(), WebEngineView::fileDialogRequested() et WebEngineView::formValidationMessageRequested().

Visualisation de fichiers PDF

Qt WebEngine permet de visualiser des documents PDF en y naviguant. Cette fonctionnalité utilise l'API d'extensions de Chromium et le plugin de visualisation PDF pour afficher les documents PDF. Elle peut être testée dans Simple Browser ou Nano Browser.

Le chargement des plugins doit être activé à l'aide de QWebEngineSettings::PluginsEnabled ou WebEngineSettings::pluginsEnabled afin d'utiliser cette fonctionnalité.

Cette fonctionnalité peut être activée (par défaut) ou désactivée via les paramètres QWebEngineSettings::PdfViewerEnabled ou WebEngineSettings::pdfViewerEnabled.

La prise en charge de cette fonctionnalité a été ajoutée dans Qt 5.13.0.

API de cycle de vie des pages

Qt WebEngine prend en charge la spécification Page Lifecycle API, une extension en cours de la norme HTML permettant aux agents utilisateurs de réduire leur consommation de ressources en gelant ou en supprimant les pages d'arrière-plan. Cette fonctionnalité est exposée à la fois dans les API Widgets et QML.

Pour un exemple d'utilisation de l'API QML, voir l'exemple de cycle de vie WebEngine.

La prise en charge de cette fonctionnalité a été ajoutée dans Qt 5.14.0.

Aperçu des états du cycle de vie

Chaque élément WebEngineView (ou objet QWebEnginePage ) peut se trouver dans l'un des trois états de cycle de vie suivants : actif, gelé ou supprimé. Ces états, comme les états de veille d'un processeur, contrôlent l'utilisation des ressources des vues Web.

L'état actif est l'état normal, sans restriction, d'une vue web. Toutes les vues Web visibles sont toujours dans l'état actif, de même que toutes les vues Web dont le chargement n'est pas encore terminé. Seules les vues Web invisibles et inactives peuvent passer à d'autres états du cycle de vie.

L'état gelé est un état de faible utilisation du processeur. Dans cet état, la plupart des sources de tâches HTML sont suspendues (gelées) et, par conséquent, la plupart des traitements d'événements DOM et l'exécution JavaScript sont également suspendus. La vue web doit être invisible pour être gelée, car le rendu n'est pas possible dans cet état.

L'état "jeté" est un état d'économie de ressources extrême. Dans cet état, le contexte de navigation de la vue web est supprimé et le sous-processus de rendu correspondant est arrêté. L'utilisation de l'unité centrale et de la mémoire dans cet état est pratiquement réduite à zéro. Lorsque l'on quitte cet état, la page web est automatiquement rechargée. Le processus d'entrée et de sortie de l'état d'abandon est similaire à la sérialisation de l'historique de navigation de la vue web et à la destruction de la vue, puis à la création d'une nouvelle vue et à la restauration de son historique.

Voir également WebEngineView::LifecycleState. L'équivalent dans l'API Widgets est QWebEnginePage::LifecycleState.

Propriétés lifecycleState et recommendedState

La propriété lifecycleState du type WebEngineView est une propriété en lecture-écriture qui contrôle l'état actuel du cycle de vie de la vue Web. Cette propriété est conçue pour imposer le moins de restrictions possible sur les états vers lesquels il est possible de passer. Par exemple, il est permis de geler une vue web qui joue actuellement de la musique en arrière-plan, en arrêtant la musique. Pour mettre en œuvre une stratégie d'économie de ressources moins agressive qui évite d'interrompre l'activité d'arrière-plan visible par l'utilisateur, la propriété recommendedState doit être utilisée.

La propriété recommendedState du type WebEngineView est une propriété en lecture seule qui calcule une limite sûre pour la propriété lifecycleState, en tenant compte de l'activité actuelle de la vue web. Ainsi, dans l'exemple d'une vue web jouant de la musique en arrière-plan, l'état recommandé sera Active car un état plus agressif arrêterait la musique. Si l'application veut éviter d'interrompre l'activité en arrière-plan, elle doit éviter de placer la vue web dans un état de cycle de vie d'économie de ressources plus agressif que celui donné par recommendedState.

Voir également WebEngineView::lifecycleState et WebEngineView::recommendedState. Les équivalents dans l'API Widgets sont QWebEnginePage::lifecycleState et QWebEnginePage::recommendedState.

Les extensions DOM

La propriété lifecycleState est liée à la spécification de l'API Page Lifecycle, qui spécifie deux nouveaux événements DOM, freeze et resume, et ajoute une nouvelle propriété booléenne Document.wasDiscarded. Les événements freeze et resume sont déclenchés lors de la transition de Active à Frozen state et vice-versa. La propriété Document.wasDiscarded est définie sur true lors de la transition de l'état Discarded à l'état Active.

Qt WebEngine permet d'imprimer une page web dans un fichier PDF. Pour plus d'informations, voir QWebEnginePage::printToPdf() et WebEngineView.printToPdf.

Cette fonctionnalité peut être testée à l'aide de Html2Pdf.

La prise en charge de cette fonctionnalité a été ajoutée dans Qt 5.7.0.

Modèles de processus

Qt WebEngine Qt utilise plusieurs processus du système d'exploitation pour isoler les sites web les uns des autres et de l'application cliente, ce qui améliore la sécurité et la robustesse. Les modèles de processus suivants, ou les façons de diviser les sites web entre les processus du système d'exploitation, sont pris en charge :

Processus par instance de site

Il s'agit du modèle par défaut. Les pages de sites distincts sont placées dans des processus distincts et les visites d'un même site sont également isolées.

Deux pages web sont considérées comme appartenant au même site si elles proviennent du même nom de domaine enregistré (par exemple, wikipedia.org) et du même schéma (par exemple, https). Cette politique est similaire à celle de la même origine, mais les sous-domaines sont ignorés. Par exemple, https://en.wikipedia.org/ et https://de.wikipedia.org/ appartiendraient tous deux au même site.

Une instance de site est un ensemble de pages web appartenant au même site. Lorsque l'application charge explicitement une URL dans Qt WebEngine (via QWebEnginePage::setUrl, par exemple), une nouvelle instance de site est créée pour la page. Toutefois, lorsque l'utilisateur clique sur des liens de même site sur la page, l'instance de site existante est simplement étendue à d'autres pages.

Ainsi, dans l'exemple du navigateur simple, lorsqu'un utilisateur ouvre deux onglets et saisit explicitement https://en.wikipedia.org/ dans les barres d'URL, les deux onglets auront leurs propres processus OS distincts (car la saisie explicite d'une URL crée une nouvelle instance de site). Cependant, lorsque l'utilisateur clique ensuite sur des liens du même site pour ouvrir d'autres onglets, ces nouveaux onglets partageront le même processus de système d'exploitation (parce que l'interaction de l'utilisateur étend l'instance de site existante).

Processus par site

Les pages de sites distincts sont placées dans des processus distincts. Contrairement au processus par instance de site, toutes les visites d'un même site partagent un processus de système d'exploitation.

L'avantage de ce modèle est de réduire la consommation de mémoire, car un plus grand nombre de pages web partageront des processus. Les inconvénients sont une réduction de la sécurité, de la robustesse et de la réactivité.

Pour activer ce modèle, utilisez l'argument de ligne de commande --process-per-site. Voir Utilisation des arguments de la ligne de commande.

Processus unique

À des fins de débogage uniquement, un mode de processus unique peut être activé à l'aide de l'argument de ligne de commande --single-process. Voir Utilisation des arguments de la ligne de commande et Qt WebEngine Débogage et profilage.

Vérification de l'orthographe

Qt WebEngine prend en charge l'intégration de la vérification orthographique dans les formulaires HTML afin de permettre aux utilisateurs de soumettre des messages dont l'orthographe a été vérifiée. Lorsque l'utilisateur clique sur un mot mal orthographié souligné, le menu contextuel par défaut affiche jusqu'à quatre suggestions. La sélection de l'une d'entre elles remplacera le mot mal orthographié.

Pour pouvoir vérifier l'orthographe, le correcteur orthographique a besoin de dictionnaires. Il prend en charge les dictionnaires du projet Hunspell, mais ils doivent être compilés dans un format binaire spécial. Un dictionnaire Hunspell se compose de deux fichiers :

  • un fichier .dic qui est un dictionnaire contenant les mots de la langue
  • Un fichier .aff qui définit la signification de drapeaux spéciaux dans le dictionnaire.

Ces deux fichiers peuvent être convertis au format bdic à l'aide de l'outil qwebengine_convert_dict fourni avec Qt XML. Lorsque le correcteur orthographique Qt WebEngine s'initialise, il essaie de charger les dictionnaires bdict et de vérifier leur cohérence.

Pour CMake, vous pouvez utiliser la commande qt_add_webengine_dictionary pour convertir les fichiers Hunspell .dic au format binaire .bdic. La commande crée une cible qtwebengine_dictionaries, dont votre projet peut utiliser une dépendance.

Si QTWEBENGINE_DICTIONARIES_PATH est défini, le correcteur orthographique utilise les dictionnaires du répertoire spécifié sans chercher ailleurs. Sinon, il utilise le répertoire qtwebengine_dictionaries relatif à l'exécutable s'il existe. S'il n'existe pas, il cherchera dans QT_INSTALL_PREFIX/qtwebengine_dictionaries.

Sur macOS, en fonction de la configuration de Qt WebEngine au moment de la compilation, il existe deux possibilités pour trouver les données de vérification orthographique :

  • Dictionnaires Hunspell (par défaut) - les dictionnaires .bdic sont utilisés, comme sur les autres plateformes.
  • Dictionnaires natifs - les API de vérification orthographique de macOS sont utilisées (ce qui signifie que les résultats dépendront des dictionnaires installés dans le système d'exploitation).

Ainsi, dans le cas de macOS Hunspell, Qt WebEngine cherchera dans le sous-répertoire qtwebengine_dictionaries situé dans le répertoire Resources du bundle d'applications, ainsi que dans le répertoire Resources situé dans le bundle du framework Qt.

En résumé, en cas d'utilisation de Hunspell, les chemins suivants sont pris en compte :

La vérification orthographique est désactivée par défaut et peut être activée par profil en utilisant la méthode QWebEngineProfile::setSpellCheckEnabled() dans les applications basées sur des widgets et la propriété WebEngineProfile.spellCheckEnabled dans les applications Qt Quick.

La langue courante utilisée pour la vérification orthographique est définie par profil et peut être définie à l'aide de la méthode QWebEngineProfile::setSpellCheckLanguages() ou de la propriété WebEngineProfile.spellCheckLanguages.

Cette fonctionnalité peut être testée en construisant et en exécutant l'exemple de correcteur orthographique.

Qt WebEngine peut également être compilé sans la prise en charge du correcteur orthographique en utilisant le commutateur webengine-spellchecker configure.

qt-configure-module path\to\qtwebengine\sources -no-webengine-spellchecker

Pour plus d'informations, voir Qt Configure Options.

La prise en charge de cette fonctionnalité a été ajoutée dans Qt 5.8.0.

Toucher

Qt WebEngine prend en charge les dispositifs tactiles pour la navigation et l'interaction avec les pages web.

La prise en charge des événements tactiles dans l'API JavaScript dépend de la présence d'un écran tactile (c'est-à-dire que ontouchstart et les gestionnaires correspondants seront présents dans l'objet document.window si un appareil tactile capable est connecté au système).

Certains sites web utilisent cette API pour décider s'ils fonctionnent sur un appareil mobile ou sur un ordinateur de bureau et basent leur conception sur cette décision. Cela peut entraîner des résultats indésirables sur les ordinateurs portables à écran tactile ou sur d'autres configurations qui émulent un faux périphérique tactile.

Les applications peuvent définir explicitement cette fonctionnalité à l'aide de QWebEngineSettings::TouchEventsApiEnabled.

Notez que les événements tactiles seront toujours transmis aux pages web même si l'API est désactivée. L'envoi d'événements tactiles aux pages web peut être interdit en installant un objet de filtrage d'événements à l'aide de QObject::installEventFilter sur l'objet proxy de focalisation de la vue WebEngine, et en filtrant tous les événements tactiles.

Voir la source

Qt WebEngine permet de visualiser la source HTML d'une page web.

Cette fonction peut être utilisée à partir de menus personnalisés ou assignée à des événements personnalisés. Pour plus d'informations, voir WebEngineView::WebAction, et QWebEnginePage::WebAction.

Cette fonctionnalité peut être testée en ouvrant une page web dans Simple Browser ou Nano Browser, puis en sélectionnant Page Source dans le menu contextuel. L'entrée du menu contextuel Page Source ouvre la vue de la source dans un nouvel onglet.

Pour ouvrir la vue source dans l'onglet actuel, les URL avec le schéma URI vue-source sont également pris en charge. Par exemple, vous pouvez taper l'URL suivante dans la barre d'URL pour afficher la source HTML de la page web qt.io :

view-source:https://www.qt.io/

L'auto-complétion des URLs incomplètes avec le schéma URI view-source rend l'utilisation de cette fonctionnalité plus confortable. Par exemple, l'URL incomplète suivante charge également la vue source de la page web qt.io :

view-source:qt.io

La prise en charge de cette fonctionnalité a été ajoutée dans Qt 5.8.0.

Notifications Web

Qt WebEngine prend en charge l'API JavaScript de notifications Web. L'application doit explicitement autoriser cette fonctionnalité en utilisant QWebEnginePage::Notifications ou WebEngineView.Notifications.

La prise en charge de cette fonctionnalité a été ajoutée dans Qt 5.13.0.

WebGL

Qt WebEngine supporte WebGL pour certaines configurations de piles graphiques. Un utilisateur peut visiter la page chrome://gpu en utilisant l'application QtWebEngine. La vue d'ensemble de l'état des fonctionnalités graphiques indique si WebGL est pris en charge pour la configuration actuelle de la plateforme. L'utilisateur peut également consulter le rapport WebGL.

La prise en charge de WebGL est activée par défaut. Vous pouvez la désactiver à l'aide du paramètre QWebEngineSettings::WebGLEnabled.

WebRTC

WebRTC fournit aux navigateurs des capacités de communication en temps réel (RTC) via des API simples. Pour plus d'informations, voir WebEngineView.Feature, et QWebEnginePage::Feature.

Cette fonctionnalité peut être testée en installant une webcam ou un microphone, puis en ouvrant https://test.webrtc.org/ dans Simple Browser ou Nano Browser.

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