This article is part 8 of 8 in the series Python PySide/PyQt Tutorial

Last Updated: Thursday 12th December 2013

The QWebView is a highly useful control; it allows you to display web pages from URLs, arbitrary HTML, XML with XSLT stylesheets, web pages constructed as QWebPages, and other data whose MIME types it knows how to interpret. It uses the WebKit web browser engine. WebKit is an up-to-date, standards-compliant rendering engine used by Google's Chrome, Apple's Safari, and soon the Opera browser.

Creating and Filling a QWebView

Content from a QWebView's URL

You instantiate a QWebView like any othe QWidget, with an optional parent. There are a number of ways to put content into it, however. The simplest — and possibly the most obvious — is its load method, which takes a QUrl; the simplest way to construct a QUrl is with a unicode URL string:

That loads Python Central's main page in the QWebView control. Equivalent would be to use the setUrl method, like so:

Load Arbitrary HTML with QWebView

There are other interesting ways to load content into a QWebView. You can load generated HTML into it using the setHtml method. For example, you can do something like this:

The setHtml method can take an optional second argument, the base URL of the document - the URL based on which any relative links contained in the document are resolved.

Other QWebView Content Types

A QWebView's content does not have to be HTML; if you have other browser-viewable content, you can put it in a QWebView using its setContent method, which accepts the content and optionally its MIME type and a base URL. If the MIME type is omitted, it will be assumed that it is text/html; no autodetection of MIME types has been implemented yet, though it is at least tentatively planned. I've not managed to find a list of MIME types that can be handled by the QWebView, but here is an example that works with a PNG file:

Interacting QWebView with JavaScript

Presenting a user with web-style content is useful in itself, but that content can be made interactive with JavaScript, which can be initiated from Python code.

A QWebView contains a QWebFrame object, which is useful to us right now for its evaluateJavaScript method. That method accepts a string of JavaScript, evaluates it in the context of the QWebView's content, and returns its value.

What values can be returned? The PySide documentation for QWebFrame, like that for PyQt and Qt itself, is not clear on that point. In fact, that information doesn't appear to be available on the web at all, so I did some testing.

It appears that strings and booleans just plain work, and numbers, objects, undefined, and null work with caveats:

  • Because JavaScript lacks separate integer and floating-point datatypes, numbers are consistently converted to Python floats.
  • Objects are returned as Python dictionaries unless they are functions or arrays; functions are returned as useless empty dictionaries, and arrays become Python lists.
  • undefined becomes None, sensibly enough.
  • null becomes, less sensibly, ''. That's right — an empty string.

Note especially the behavior regarding null and functions, as both can cause code that looks right to behave wrong. I see no better option for functions, but null is especially confusing; the only way to detect a null value from evaluateJavaScript is to do the comparison val === null on the JavaScript side before you return it to Python. (It is at this point that we collectively grieve over JavaScript's ill-thought-out types.)

An important caution about evaluateJavaScript: it has all the security implications of JavaScript's built-in eval, and should be used with the discretion that is so seldom displayed by front-end JavaScript coders. It would be far too simple, for example, to allow the execution of arbitrary JavaScript by naïvely building a string and sending it to evaluateJavaScript. Be careful, validate user input, and block anything that looks too clever.

Example of Evaluating JavaScript in a QWebView

Now, let's throw caution to the wind and look at a simple example. It will show a form that allows the user to enter a first and last name. There will be a full name entry that is disabled; the user cannot edit it. There is a submit button, but it is hidden. (Don't do this in real life, okay? This form is a usability and cultural-sensitivity disaster, and would be almost insultingly dumb to show in public.) We'll supply a Qt button that fills out the full name entry, shows the submit button, and prints the full name to the console. Here's the source of the example:

Try running it. Fill out a first and last name and click the button. You should see a full name and a submit button appear. Looking at the console, you should see the full name printed there as well.

This was a very heavily contrived example, but we can do much more interesting things: in the next installment, we'll build a simple application that combines HTML in a QWebView and some other Qt widgets to usefully work with a web API.

To Practice: Try this interactive course on the basics of Lists, Functions, Packages and NumPy in Python.

  • Eko Suprapto Wibowo

    This article is part 9 of 8 … excess by 1! ‘)

    • Yeah, I know. I’m working on a new theme which’ll fix this ;-).

  • crash.smth

    Great tutorial for beginners. I went through the whole tutorial and it helped me a lot.

    I just want to know how do you highlight the dot members and the QT class names as you show in code snippets. Can any text editor or IDE do these? Or with some plugins? I have tried vim and pydev, neither of them work in that way.

  • Al

    What a fantastic tutorial series: thank you! Really clear, made the clouds part for a topic I’d been finding difficult.

    One thing to add is that I think it’s worth mentioning that you need :

    from PySide.QtWebKit import *

    in addition to the imports from previous parts of the tutorial in order to use the QWebView() method.

  • Eric

    Wonderful series, just read once very quickly, will now go through and do it slowly. Is there a part 9, as you wrote: “in the next installment, we’ll build a simple application that combines HTML in a QWebView and some other Qt widgets to usefully work with a web API”. Sounds pretty awesome!

  • Vishnu A Venu

    Jason please Help me how can i create chat box like we have in Facebook or Whatsapp in which Text area consist of Sender Image and text surrounded by Color! how u understood!

  • aeroaks

    Thanks for the article! I have used setContent(data, contentType) to set the modified (downloaded) HTML in the window. But the images (from image tag, src being external link) dont show up. Observing the requests shows that there is no request made after the HTML request which was modified and used with setContent. What am I missing here? Please help.

    • Are there any other non-image HTTP requests that do work, like CSS or JS files? And is the markup valid?

  • VolArt

    I want to use website icons as icons my Tab application. Can i get icon from loaded web page in webkit on pyqt4?