1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
|
# Web engine
The following renderers are used on each platform
| Platform | Code | Renderer | Provider | Browser compatibility |
|----------|----------|----------|---------------------------------------------------|-----------------------|
| GTK | gtk | WebKit | WebKit2 | |
| macOS | | WebKit | WebKit.WKWebView (bundled with OS) | |
| QT | qt | WebKit | QtWebEngine / QtWebKit | |
| Windows | mshtml | MSHTML | MSHTML via .NET / System.Windows.Forms.WebBrowser | IE11 (Windows 10/8/7) |
| Windows | | EdgeHTML | > .NET Framework 4.6.2 and Windows 10 build 17110 | |
| Windows | cef | CEF | CEF Python | Chrome 66 |
To change a default renderer set either `PYWEBVIEW_GUI` environment variable or `webview.gui` value in the code. Check for available values in the Code column.
For example to use CEF on Windows
``` bash
PYWEBVIEW_GUI=cef
```
or
``` python
import webview
webview.start(gui='cef')
```
If you wish to pass custom settings to CEF, refer to [this example](/examples/cef.html)
To force QT on Linux systems
``` bash
PYWEBVIEW_GUI=qt
```
or
``` python
import webview
webview.start(gui='qt')
```
# Known issues and limitations
## GTK WebKit2
* Versions of WebKit2 older than 2.2 has a limitation of 1000 characters of the Javascript result returned by `evaluate_js`. `get_elements` is not supported for this reason.
## QtWebKit
* Debugging is not supported
## EdgeHTML
* `file://` URLs are not fully supported. While such URLs can be loaded, associated resources such as images or stylesheets cannot.
* Destroying a window via `window.destroy()` and starting a new instance will crash the program.
* Running the program under elevated privileges will throw an exception.
* Access to localhost URLs is restricted by default. To overcome this the LoopbackExempt settings are modified on _pywebview_ launch, which triggers a UAC prompt. This only happens once and only if LoopbackExempt setting is not set. You can manually set this setting beforehand to avoid UAC: `checknetisolation LoopbackExempt -a -n="Microsoft.Win32WebViewHost_cw5n1h2txyewy"` (must be run as an admin).
|
