PyWebIO v1.6.1 使用手册

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

摘要

《PyWebIO v1.6.1 使用手册》介绍了PyWebIO的使用方法，包括基本用法、输入处理、高级特性如多应用启动和与Web框架的集成。文档详细说明了服务器-客户端通信协议，支持WebSocket和HTTP通信，并介绍了版本更新内容，如安全性支持、国际化、SEO优化等新功能。

AI总结

《PyWebIO v1.6.1 使用手册》主要介绍了PyWebIO的使用方法和功能特性，以下是文档的核心内容总结：

### 1. PyWebIO简介
PyWebIO是一种基于Python的Web开发工具，通过编写Python代码即可实现Web交互功能。与传统Web开发模式不同，PyWebIO将前后端逻辑统一在Python代码中实现，使用命令式API（如`put_text()`、`input()`等）完成浏览器上的输入输出交互。

### 2. 基本功能
- **输入函数**：通过`pywebio.input`模块实现，支持文本、数字、日期等多种输入类型，输入函数是阻塞式的，直到用户提交表单才会返回。
- **输出函数**：支持文本、图片、表格等输出形式，提供丰富的交互控件（如按钮、表单等）。
- **事件处理**：支持点击事件和表单提交事件，可通过回调函数实现动态交互。

### 3. 高级特性
- **多应用支持**：通过`start_server()`函数可以启动多个PyWebIO应用，应用之间可通过`go_app()`或`put_link()`实现跳转。
- **框架整合**：支持与主流Web框架（如Flask、Django、Tornado等）集成，方便将PyWebIO应用嵌入到现有项目中。
- **通信协议**：支持WebSocket和HTTP通信，具体协议取决于后端框架的选择。
- **数据可视化**：支持通过`pyg2plot`进行数据可视化。
- **静态文件托管**：可通过`static_dir`参数托管静态文件。
- **安全性**：新增防XSS攻击功能，`put_html()`和`put_markdown()`支持`sanitize`参数。

### 4. 更新日志
- **v1.6**：新增WebSocket重连功能，优化多任务支持，改进文档和示例。
- **v1.5**：新增`put_info()`、`put_error()`等提示消息函数，支持使用`pyinstaller`打包应用。
- **v1.4**：新增`put_loading()`、`put_processbar()`等动态反馈功能，优化布局支持。
- **v1.3**：新增`put_scrollable()`、`put_collapse()`等布局控件，支持国际化。
- **v1.2**：新增`put_link()`、`put_widget()`等函数，优化数据可视化支持。
- **v1.1**：新增安全性支持，优化与Web框架的集成，支持`reconnect_timeout`参数。
- **v1.0**：新增多任务支持、布局功能、自定义样式、`put_link()`等函数，重构输出模型。

### 5. 其他功能
- **会话管理**：支持通过`pywebio.session`模块管理会话状态。
- **浏览器支持**：支持主流浏览器，不支持IE浏览器。
- **部署工具**：提供`pywebio-path-deploy`命令用于从目录加载运行PyWebIO应用。

### 6. 使用建议
- 如果在开发过程中遇到设计问题，可以参考终端程序的交互方式。
- 对于复杂问题，可使用回调机制或`pin`模块进行处理。

### 7. 报告与支持
- 遇到问题可访问GitHub讨论区或issue页面寻求帮助。

通过以上功能，PyWebIO为开发者提供了一种简单高效的方式快速构建交互式Web应用，适用于教育、数据分析、轻量级Web项目等多种场景。