PyWebView项目使用指南：从基础到高级应用

PyWebView项目使用指南：从基础到高级应用

pywebview Build GUI for your Python program with JavaScript, HTML, and CSS 项目地址: https://gitcode.com/gh_mirrors/py/pywebview

概述

PyWebView是一个轻量级的Python库，它允许开发者使用原生GUI窗口来显示网页内容或HTML界面。本文将详细介绍PyWebView的核心功能和使用方法，帮助开发者快速掌握这一工具。

基础使用

创建第一个窗口

使用PyWebView创建窗口非常简单，只需几行代码：

import webview

# 创建窗口并指定标题和URL
window = webview.create_window('我的第一个PyWebView窗口', 'https://example.com')
# 启动GUI循环
webview.start()

这段代码会创建一个显示指定网页的窗口。create_window函数返回一个Window对象实例，而webview.start()则启动了GUI事件循环。

多窗口管理

PyWebView支持创建多个窗口，所有打开的窗口都存储在webview.windows列表中：

import webview

def print_window_info():
    print(f'当前窗口数量: {len(webview.windows)}')
    print(f'活动窗口标题: {webview.active_window().title}')

# 创建两个窗口
window1 = webview.create_window('窗口1', 'https://example.com')
window2 = webview.create_window('窗口2', 'https://example.org')
# 在窗口显示后打印信息
window2.events.shown += print_window_info
webview.start()

后端逻辑处理

由于webview.start()会阻塞后续代码执行，建议将后端逻辑放在单独的线程中运行：

import webview

def backend_logic(window):
    # 窗口显示后执行全屏
    window.toggle_fullscreen()
    # 执行JavaScript代码
    window.evaluate_js('alert("操作成功")')

window = webview.create_window('交互示例', html='<h1>欢迎使用PyWebView</h1>')
# 启动GUI并传入后台逻辑函数
webview.start(backend_logic, window)

窗口对象操作

Window对象提供了丰富的窗口控制方法：

# 加载新URL
window.load_url('https://new-url.com')

# 加载HTML内容
window.load_html('<h1>本地HTML内容</h1>')

# 执行JavaScript并获取返回值
result = window.evaluate_js('2 + 2')

# 窗口控制
window.toggle_fullscreen()  # 切换全屏
window.resize(800, 600)    # 调整大小
window.move(100, 100)      # 移动位置
window.minimize()          # 最小化
window.hide()              # 隐藏窗口
window.show()              # 显示窗口

事件处理

PyWebView提供了多种窗口事件，方便开发者响应用户操作：

def on_closing():
    print("窗口即将关闭")

def on_loaded():
    print("内容加载完成")

window = webview.create_window('事件示例', 'https://example.com')
window.events.closing += on_closing    # 订阅关闭事件
window.events.loaded += on_loaded      # 订阅加载完成事件
webview.start()

Python与JavaScript交互

PyWebView支持双向通信：

JavaScript调用Python

class Api:
    def show_message(self, msg):
        print(f"来自JS的消息: {msg}")

window = webview.create_window(
    "交互示例",
    html='<button onclick="pywebview.api.show_message(\'Hello Python!\')">点击</button>',
    js_api=Api()
)
webview.start()

Python调用JavaScript

window.evaluate_js('alert("这是来自Python的消息")')

HTTP服务器集成

PyWebView内置了对静态文件服务的支持：

# 自动启动HTTP服务器服务本地文件
webview.create_window('本地文件', 'src/index.html')
webview.start(ssl=True)  # 启用SSL

也可以集成外部WSGI服务器如Flask：

from flask import Flask
import webview

app = Flask(__name__)
webview.create_window('Flask应用', app)
webview.start()

高级特性

使用不同渲染引擎

PyWebView支持多种底层渲染引擎，可以通过gui参数指定：

# 使用CEF渲染引擎
webview.start(gui='cef')

DOM操作支持

PyWebView提供了基本的DOM操作能力，包括事件处理、元素遍历和修改等。

最佳实践

1. 对于复杂应用，建议使用外部HTTP服务器而非内置服务器
2. 跨域通信优先使用暴露API的方式而非REST
3. 长时间运行的后台逻辑应放在单独线程中
4. 生产环境建议启用SSL加密

通过本文介绍，您应该已经掌握了PyWebView的核心功能。这个库特别适合需要将Web技术嵌入到原生应用中的场景，或者希望快速构建基于HTML/JS的GUI应用。

pywebview Build GUI for your Python program with JavaScript, HTML, and CSS 项目地址: https://gitcode.com/gh_mirrors/py/pywebview