PyWebIO v1.3.1 使用手册

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

摘要

《PyWebIO v1.3.1 使用手册》介绍了PyWebIO的使用方法，包括输入输出函数的实现、部署方式以及新功能。PyWebIO通过命令式API实现交互，支持文本、图片、表格等多种输出形式，并提供输入表单功能。文档还介绍了如何将PyWebIO应用部署到现有Web框架，支持远程访问和静态文件托管。新版本增加了安全性支持、国际化和SEO优化等功能，同时提供了更灵活的部署选项。

AI总结

《PyWebIO v1.3.1 使用手册》总结如下：

1. **核心特性**：
- **极简交互开发**：PyWebIO通过命令式API，让用户可以用类似编写控制台程序的方式开发Web应用，所有交互逻辑均在Python代码中实现。
- **丰富的输入输出支持**：提供多种输入类型（文本、密码、下拉选择、复选框、单选按钮、文件上传）和输出形式（文本、表格、Markdown、文件下载、弹窗等）。
- **良好的用户体验**：支持点击事件、布局管理，可轻松实现交互功能并提供良好的用户界面。

2. **主要模块**：
- **输入模块（pywebio.input）**：
- 提供多种输入方式，如`input()`、`select()`、`checkbox()`、`radio()`、`textarea()`、`file_upload()`等。
- 输入函数为阻塞式，需在会话结束前完成输入。
- **输出模块（pywebio.output）**：
- 支持输出文本、表格、Markdown、文件等，主要函数包括`put_text()`、`put_table()`、`put_file()`、`popup()`等。
- 支持可折叠内容（`put_collapse()`）和标签栏（`put_tabs()`）。
- **会话管理（pywebio.session）**：
- 提供会话相关功能，如状态存储和管理。
- **应用部署（pywebio.platform）**：
- 支持Server模式和Script模式，可将应用部署为独立服务或集成到现有Web框架。
- 提供`start_server()`函数，支持指定端口和静态文件托管。

3. **新增功能与优化**：
- **安全性增强**：`put_html()`和`put_markdown()`支持防XSS攻击。
- **国际化与SEO支持**：支持UI国际化和SEO信息设置。
- **性能提升**：优化通信协议，减少延迟。
- **部署灵活性**：支持通过`path_deploy()`从指定路径加载应用，并支持文件热重载。

4. **使用场景**：
- 快速开发交互式Web应用，尤其适合数据可视化、在线表单、实时交互等场景。
- 支持与第三方库（如数据可视化库）集成，扩展功能。

5. **注意事项**：
- 在Server模式下，输入输出函数仅能在任务函数上下文中调用。
- Script模式下，交互函数可在任何位置调用，但需注意会话管理。

总结：PyWebIO通过简洁的API和强大的功能，极大简化了Web应用的开发流程，特别适合需要快速实现交互式功能的场景。