PyWebIO v1.1.0 使用手册

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

摘要

PyWebIO 是一个用于快速构建基于浏览器的交互式 Web 应用的 Python 库，提供了一系列命令式的交互函数来在浏览器上获取用户输入和进行输出。文档详细介绍了 PyWebIO 的基本使用方法，包括输入、输出、会话管理、与 Web 框架的集成以及第三方库生态等内容。新版本（v1.1.0）增加了对多任务函数的支持，提供了新的输出函数和布局支持，并改进了与现有 Web 框架的兼容性。

AI总结

《PyWebIO v1.1.0 使用手册》总结：

1. **核心特性**
PyWebIO 是一个用于快速开发基于浏览器交互的应用的 Python 库，提供命令式 API，支持输入、输出、布局和用户交互功能。开发者可以像编写终端程序一样开发 Web 应用，无需 HTML 和 JS 知识。

2. **主要功能模块**
- **输入模块 (`pywebio.input`)**：支持多种输入形式，如文本、密码、下拉选择、复选框、单选框、多行文本和文件上传。
- **输出模块 (`pywebio.output`)**：支持文本、图片、表格、弹窗、气泡提示等多种输出形式，并提供布局支持（如 `put_grid()`、`put_row()`）。
- **会话管理 (`pywebio.session`)**：支持基于线程和协程的会话模式，协程会话适合高并发场景。
- **Web 框架集成 (`pywebio.platform`)**：支持与 Django、aiohttp 等 Web 框架集成，提供 WebSocket 通信能力。

3. **更新亮点**
- 新增基于 `Scope` 的输出控制模型，替代了旧的锚点模型。
- 增加布局支持（`put_grid()`、`put_row()`）和自定义样式功能。
- 支持更多输出函数（如 `toast()`、`popup()`、`put_widget()`）和 JS 执行功能（`run_js()`）。
- 优化 UI：输入框变为浮动式，异常处理改为前端日志记录。

4. **示例应用**
- **BMI 计算器**：演示基本输入输出和计算功能。
- **输入演示**：展示多种输入控件的使用。
- **输出演示**：展示多种输出形式（文本、图片、表格等）。
- **聊天室**：基于协程的会话实现多人实时聊天功能。

5. **注意事项**
- PyWebIO 默认使用 CDN 托管静态资源，离线部署需手动托管静态文件。
- 使用 aiohttp 时需配置反向代理支持 WebSocket。
- 更新日志中移除了部分旧 API，如 `pywebio.output.set_title()` 和 `pywebio.output.set_auto_scroll_bottom()`，改用 `pywebio.session.set_env()` 控制。

6. **文档资源**
- 提供 PDF 和 Epub 格式的离线文档。
- 示例代码旁附有在线 Demo 链接，便于查看运行效果。

总结：PyWebIO 通过简洁的代码实现丰富的交互功能，适合快速开发轻量级 Web 应用，尤其适合需要简单用户界面的场景。