PyWebIO v1.8.1 使用手册

• 语言: 中文（简体）
• 格式: .epub
• 来源: pywebio.readthedocs.io

摘要

本文档为PyWebIO v1.8.1使用手册，主要内容包括：1. 基于线程的会话实现，涉及多个会话的启动与回调机制；2. 基于协程的会话实现，支持异步函数和协程管理；3. 会话的结束处理，包括Web页面关闭触发SessionClosed异常；4. 协程会话与Web框架集成，使用run_asyncio_coroutine函数；5. 并发协程会话的实现，通过多任务启动不同应用；6. 高级特性如使用start_server启动多应用，支持参数化任务名称。

AI总结

该文档是PyWebIO v1.8.1的使用手册，核心介绍了如何利用**回调函数**和**协程**两种方式实现交互式Web应用。

**核心概念与实现方式**

- **回调函数**：通过`put_`（输出）和`input_`（输入）系列函数，配合`onclick`等参数绑定处理函数。组件如按钮、输入框可通过`onclick`参数指定回调。
- **协程**：使用`async def`定义协程函数，并在其中使用`await`等待输入（如`await input()`）或`await asyncio.sleep()`。这能以同步代码的写法实现异步交互。

**关键功能组件**

- **输入/输出组件**：包括输入框、按钮、表格、滑块等。按钮可绑定点击回调，表格支持行插入和编辑。
- **会话管理**：提供了基于线程和基于协程的两种会话实现方式。协程会话依赖于`asyncio`，更加轻量。
- **页面跳转与JS执行**：支持通过`eval_js`执行JavaScript表达式，并可通过`redirect`跳转页面。
- **高级特性**：支持通过`start_server(applications=...)`参数启动多应用Web服务，为不同任务（Task）分配独立的页面和路由。

**注意事项**

- **协程中使用`await`**：必须等待一个可等待对象（awaitable），不支持的输入操作（如`pywebio.input.*`的同步版本）不能直接`await`。
- **并发处理**：当协程会话运行时，其内部的`asyncio`事件循环会阻塞线程。需要将耗时的同步操作放在另一个线程中执行，以免阻塞界面。
- **会话结束**：当会话因连接断开或服务器端`close_session`被调用而结束时，浏览器端会弹出“Session Closed”或“Session Not Found”的提示。