wxGTKWebKit

Here is a recipe to embed webkit in a wxPython app. It works with wxPython 2.6 and wxPython 2.8 - wxGTK port only

See code comments - and of couse the code itself - for more details

   1 import wx
   2 
   3 import gobject
   4 gobject.threads_init()
   5 
   6 import pygtk
   7 pygtk.require('2.0')
   8 import gtk, gtk.gdk
   9 
  10 # pywebkitgtk (http://code.google.com/p/pywebkitgtk/)
  11 import webkit
  12 
  13 '''
  14 As far as I know (I may be wrong), a wx.Panel is "composed" by a GtkPizza
  15 as a child of GtkScrolledWindow. GtkPizza is a custom widget created for
  16 wxGTK.
  17 
  18 WebKitGTK+ - the webkit port for GTK+ that as a python bind - wants a
  19 GtkScrolledWindow as parent 
  20 
  21 So all we need to embed a webkit in wxGTK is find the wx.Panel's
  22 GtkScrolledWindow.
  23 This is acomplished using pygtk that is present in major distro's by
  24 default, at least those that use gnome as it's main desktop environment.
  25 
  26 A last note is that for get a handle of a window in X, the window must be
  27 "realized" first, in other words, must already exists. So we must Show
  28 the wx.Frame before use this WKHtmlWindow class.
  29 
  30 '''
  31 class WKHtmlWindow(wx.Panel):
  32     def __init__(self, *args, **kwargs):
  33         wx.Panel.__init__(self, *args, **kwargs)
  34 
  35         # Here is where we do the "magic" to embed webkit into wxGTK.
  36         whdl = self.GetHandle()
  37         window = gtk.gdk.window_lookup(whdl)
  38 
  39         # We must keep a reference of "pizza". Otherwise we get a crash.
  40         self.pizza = pizza = window.get_user_data()
  41 
  42         self.scrolled_window = scrolled_window = pizza.parent
  43 
  44         # Removing pizza to put a webview in it's place
  45         scrolled_window.remove(pizza)
  46 
  47         self.ctrl = ctrl = webkit.WebView()
  48         scrolled_window.add(ctrl)
  49 
  50         scrolled_window.show_all()
  51 
  52     # Some basic usefull methods
  53     def SetEditable(self, editable=True):
  54         self.ctrl.set_editable(editable)
  55 
  56     def LoadUrl(self, url):
  57         self.ctrl.load_uri(url)
  58 
  59     def HistoryBack(self):
  60         self.ctrl.go_back()
  61 
  62     def HistoryForward(self):
  63         self.ctrl.go_forward()
  64 
  65     def StopLoading(self):
  66         self.ctrl.stop_loading()

And the demo...

#python

import wxversion
#wxversion.select("2.6")
wxversion.select("2.8")

import wx

from webkit_gtk import WKHtmlWindow as HtmlWindow

class TestWKPanel(wx.Panel):
    def __init__(self, parent):
        wx.Panel.__init__(self, parent)

        self.html = HtmlWindow(self)
        self.html.SetEditable(True)

        self.box = wx.BoxSizer(wx.VERTICAL)
        self.box.Add(self.html, 1, wx.EXPAND)

        subbox = wx.BoxSizer(wx.HORIZONTAL)

        btn = wx.Button(self, -1, "Load File")
        self.Bind(wx.EVT_BUTTON, self.OnLoadFile, btn)
        subbox.Add(btn, 1, wx.EXPAND | wx.ALL, 2)

        btn = wx.Button(self, -1, "Load URL")
        self.Bind(wx.EVT_BUTTON, self.OnLoadURL, btn)
        subbox.Add(btn, 1, wx.EXPAND | wx.ALL, 2)

        btn = wx.Button(self, -1, "Back")
        self.Bind(wx.EVT_BUTTON, self.OnBack, btn)
        subbox.Add(btn, 1, wx.EXPAND | wx.ALL, 2)

        btn = wx.Button(self, -1, "Forward")
        self.Bind(wx.EVT_BUTTON, self.OnForward, btn)
        subbox.Add(btn, 1, wx.EXPAND | wx.ALL, 2)

        self.box.Add(subbox, 0, wx.EXPAND)
        self.SetSizer(self.box)
        self.Layout()

    def OnLoadFile(self, event):
        dlg = wx.FileDialog(self, wildcard = '*.htm*', style=wx.OPEN)

        if dlg.ShowModal() == wx.ID_OK:
            path = dlg.GetPath()
            self.html.LoadUrl("file://%s" % path)

        dlg.Destroy()

    def OnLoadURL(self, event):
        dlg = wx.TextEntryDialog(self, "Enter a URL", defaultValue="http://")

        if dlg.ShowModal() == wx.ID_OK:
            url = dlg.GetValue()
            if not url.startswith('http://'):
                url = "http://%s" % url
            self.html.LoadUrl(url)

        dlg.Destroy()

    def OnBack(self, event):
        self.html.HistoryBack()

    def OnForward(self, event):
        self.html.HistoryForward()


class Frame(wx.Frame):
    def __init__(self):
        wx.Frame.__init__(self, None)
        self.Show()

        TestWKPanel(self)

        # This is need it for wxPython2.8,
        # for 2.6 doesnt hurt
        self.SendSizeEvent()


if __name__ == '__main__':
    app = wx.App()
    f = Frame()
    app.MainLoop()