flet-webview-all

flet-webview-all is a Flet extension that embeds web content in a Flet application. It wraps webview_all, a Flutter WebView implementation with support for Android, iOS, Linux, macOS, Windows, and the web.

The control is a ft.LayoutControl, so it can use Flet layout properties such as expand, width, height, and visible.

Installation

Install the published package from PyPI:

pip install flet-webview-all

Or add it to your application's pyproject.toml:

[project]
dependencies = [
    "flet>=0.86.5",
    "flet-webview-all",
]

To install the latest unreleased version directly from GitHub instead, use:

[project]
dependencies = [
    "flet>=0.86.5",
    "flet-webview-all @ git+https://github.com/zaim-tech/flet-webview-all.git",
]

For a local checkout during development, add the package as a path dependency instead. See the included example application for a working configuration.

Usage

import flet as ft

from flet_webview_all import FletWebviewAll


def main(page: ft.Page):
    page.title = "WebView example"
    page.add(
        FletWebviewAll(
            url="https://flet.dev",
            expand=True,
        )
    )


ft.run(main)

Render HTML directly

Pass a complete HTML document using html. The control loads url when it is set; otherwise, it uses html.

page.add(
    FletWebviewAll(
        html="""
        <!doctype html>
        <html>
          <body><h1>Hello from Flet</h1></body>
        </html>
        """,
        expand=True,
    )
)

Control properties

Use page.update() after changing a control property at runtime:

webview.javascript_enabled = False
page.update()

Platform support

Support is supplied by the underlying webview_all package:

Platform WebView engines can differ in their capabilities. Test the settings your application relies on on each target platform.

Build the example

Flet extensions include Python and Flutter code. After changing the Flutter package, rebuild the example application; Python-only changes can be run without rebuilding once the extension has been built for the target platform.

cd examples/flet_webview_all_example
flet build windows -v

Replace windows with another supported Flet build target, such as macos, apk, ipa, or web. To run the example during Python development:

flet run

Development

The project follows Flet's extension structure:

src/flet_webview_all/                  Python control
src/flutter/flet_webview_all/          Flutter extension and webview_all dependency
examples/flet_webview_all_example/     Sample Flet application
docs/                                  Additional documentation

To add or update the Flutter dependency, work from the Flutter package directory:

cd src/flutter/flet_webview_all
flutter pub get

⚠️ Important Note

When running your app without building the extension using flet build ..., you will see an error box instead of the actual webview widget. To see the real widget, you must build the extension for your target platform.

References

• flet-webview-all repository
• webview_all package
• Creating a Flet extension

License

See LICENSE.