Le module QtWebKit

Le module QtWebkit fournit un moteur de navigation Web comme des classes pour afficher et interagir avec le contenu Web.

Classes

QtWebKit fournit un moteur de navigateur Web qui rend facile l'int�gration de contenu du World Wide Web dans des applications Qt, contenu qui peut �tre enrichi avec des contr�les natifs.

QtWebKit fournit des fonctionnalit�s pour le rendu de documents HTML (HyperText Markup Language), XHTML (eXtended HyperText Markup Language) et SVG (Scalable Vector Graphics), stylis�s � l'aide de CSS (Cascading Style Sheets) et script�s avec JavaScript.

Un pont entre l'environnement d'ex�cution JavaScript et le mod�le objet de Qt rend possible le scriptage de QObject personnalis�s. Pour plus de d�tails, voir le pont QtWebKit. L'int�gration avec le module de r�seau de Qt permet aux pages un chargement transparent depuis les serveurs Web, le syst�me de fichiers local et m�me le syst�me de ressources de Qt.

En plus de fournir des fonctionnalit�s de rendu pur, les documents HTML peuvent �tre rendus compl�tement �ditables par l'utilisateur gr�ce � l'utilisation de l'attribut contenteditable sur des �l�ments HTML.

QtWebKit est bas� sur le moteur open-source WebKit. Pour plus d'informations sur WebKit, visitez le site Web du projet.

L'inclusion dans vos projets

Pour inclure les d�finitions des classes du module, utilisez la directive suivante :

#include <QtWebkit>

Pour lier une application � ce module, ajoutez cette ligne � votre fichier qmake .pro :

 QT += webkit

Notes

Note : la g�n�ration du module QtWebKit avec des symboles de d�bogage est probl�matique sur de nombreuses plateformes, � cause de la taille du moteur WebKit. Nous recommandons la g�n�ration du module uniquement en mode release pour les plateformes embarqu�es. Actuellement, QtWebKit sera toujours compil� sans symbole de d�bogage lors de l'utilisation de gcc. Si vous avez besoin de changer cela, regardez les derni�res lignes de src/3rdparty/webkit/WebCore/WebCore.pro.

Note : les ic�nes de sites Web, aussi connues sous le nom de « FavIcons », sont pour le moment non support�es sous Windows. Nous pr�voyons d'aborder le probl�me dans une sortie future.

Note : le WebKit a des besoins minimums qui doivent �tre combl�s sous les syst�mes Linux embarqu�s. Voir le document Les n�cessit�s de Qt pour Linux embarqu�s pour plus d'informations.

Architecture

La m�thode la plus simple pour afficher un contenu est de passer par le biais de la classe QWebView. En tant que widget, elle peut �tre embarqu�e � l'int�rieur de vos formulaires ou dans une vue graphique et elle fournit des fonctions de commodit� pour les t�l�chargements et les affichages de sites Web.

QWebView *view = new QWebView(parent);
     view->load(QUrl("http://qt.nokia.com/"));
     view->show();

QWebView est utilis�e pour voir les pages Web. Une instance de QWebView poss�de une QWebPage. QWebPage fournit un acc�s � la structure du document dans la page, d�crivant des caract�ristiques telles que des frames, l'historique de navigation, et les piles d'annulation/r�tablissement pour les contenus �ditables.

Les documents HTML peuvent �tre nich�s en utilisant des frames dans des ensembles de frames. Une frame individuelle en HTML est repr�sent�e en utilisant la classe QWebFrame. Cette classe inclut un pont vers l'objet de fen�tre JavaScript et peut �tre peinte en utilisant un QPainter. Chaque QWebPage d�tient un objet de QWebFrame en tant que frame principale et celle-ci peut contenir plusieurs frames filles.

Il est possible d'acc�der aux �l�ments individuels d'un document HTML par le biais d'interfaces JavaScript DOM depuis l'int�rieur d'une page Web. L'�quivalent de cette API dans QtWebKit est repr�sent� par QWebElement. Les objets de QWebElement sont obtenus en utilisant les fonctions findAllElements() et findFirstElement() de QWebFrame avec un s�lectionneur de requ�tes CSS.

Les caract�ristiques communes des navigateurs Web, les param�tres par d�faut et les autres propri�t�s peuvent �tre configur�s par le biais de la classe QWebSettings. Il est possible de fournir des valeurs par d�faut pour toutes les instances de QWebPage � travers les param�tres par d�faut. Les attributs individuels peuvent �tre outrepass�s par l'objet de r�glage, sp�cifique � la page.

Support du plug-in Netscape

Note : le support du plug-in Netscape est uniquement disponible sous les plateformes bureautiques.

Puisque le WebKit supporte l'API du plug-in Netscape, les applications Qt peuvent afficher des pages Web qui embarquent des plug-ins communs aux plateformes pour lesquelles ces plug-ins sont disponibles. Pour activer le support d'un plug-in, l'utilisateur doit avoir les fichiers binaires appropri�s install�s et l'attribut QWebSettings::PluginsEnabled autoris� pour l'application.

Les emplacements suivants sont consult�s pour trouver les plug-ins :

• .mozilla/plugins

  dans le r�pertoire home de l'utilisateur ;
• .netscape/plugins dans le r�pertoire home de l'utilisateur ;
• emplacements syst�me, tels que :
  • /usr/lib/browser/plugins,
  • /usr/local/lib/mozilla/plugins,
  • /usr/lib/firefox/plugins,
  • /usr/lib64/browser-plugins,
  • /usr/lib/browser-plugins,
  • /usr/lib/mozilla/plugins,
  • /usr/local/netscape/plugins,
  • /opt/mozilla/plugins,
  • /opt/mozilla/lib/plugins,
  • /opt/netscape/plugins,
  • /opt/netscape/communicator/plugins,
  • /usr/lib/netscape/plugins,
  • /usr/lib/netscape/plugins-libc5,
  • /usr/lib/netscape/plugins-libc6,
  • /usr/lib64/netscape/plugins,
  • /usr/lib64/mozilla/plugins ;
• emplacements sp�cifi�s par les variables d'environnement : $MOZILLA_HOME/plugins, $MOZ_PLUGIN_PATH, $QTWEBKIT_PLUGIN_PATH.

Windows

• le r�pertoire des plug-ins de l'utilisateur, Application Data\Mozilla\plugins ;
• les emplacements syst�me standards des plug-ins pour Quicktime, Flash, etc.

Mac OS X

• Library/Internet Plug-Ins dans le r�pertoire home de l'utilisateur ;
• le r�pertoire syst�me /Library/Internet Plug-Ins.

Informations de licence

Ceci est un snapshot du port Qt de WebKit. Les informations exactes de version peuvent �tre trouv�es dans le fichier src/3rdparty/webkit/VERSION fourni avec Qt.

Les utilisateurs des �ditions commerciales de Qt qui souhaitent distribuer des applications qui utilisent le module QtWebkit doivent prendre connaissance de leurs obligations sous la GNU Library General Public License (LGPL).

Les d�veloppeurs utilisant l'�dition Open Source de Qt peuvent choisir de redistribuer le module sous la version appropri�e de la GNU LGPL.

WebKit is licensed under the GNU Library General Public License. Individual contributor names and copyright dates can be found inline in the code.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2 of the License or (at your option) any later version.

This library is distributed in the hope that it will be useful but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details.

You should have received a copy of the GNU Library General Public License along with this library; see the file COPYING.LIB. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

Remerciements

Merci � Thibaut Cuvelier et Louis du Verdier pour la traduction ainsi qu'� Jonathan Courtois et Maxime Gault pour leur relecture !