PyWebIO v1.2.2 使用手册

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

摘要

PyWebIO 是一个 Python 库，允许开发者通过编写简单的代码在浏览器中创建交互式 Web 应用，提供了包括文本输入、下拉选择、复选框等多种输入函数。PyWebIO 支持通过 WebSocket 和 HTTP 通信协议与客户端交互，并可以与主流 Web 框架如 Flask、Django 等集成。该库还支持数据可视化，集成了第三方库如 Plotly 和 Bokeh。PyWebIO 1.2.2 版本新增了跨域支持、会话管理改进等功能，并支持将 Python 应用打包为独立可执行文件。

AI总结

《PyWebIO v1.2.2 使用手册》是一篇全面介绍PyWebIO特性和使用方法的文档，旨在帮助开发者通过最少代码实现与用户的交互，并提供良好的用户体验。以下是该手册的核心内容总结：

### 1. **特性概述**
PyWebIO是一个用于构建Web应用或基于浏览器的GUI应用的库，支持以下特性：
- **同步交互**：采用阻塞式输入方式，代码逻辑更自然。
- **简单布局**：非声明式布局，操作简便。
- **低侵入性**：旧脚本代码仅需修改输入输出逻辑即可改造成Web服务。
- **框架集成**：支持与Flask、Django、Tornado、aiohttp等框架集成。
- **并发模型**：同时支持基于线程和协程的执行模型。
- **数据可视化**：支持结合第三方库（如Plotly、PyECharts）实现数据可视化。

### 2. **输入与输出**
#### 输入功能
PyWebIO提供多种输入函数，用户可以通过表单获取输入：
- **基础输入**：如`input()`（支持文本、数字、密码等）、`select()`（下拉选择）、`checkbox()`（复选框）、`radio()`（单选）、`textarea()`（多行文本）、`file_upload()`（文件上传）等。
- **高级输入**：如`input_group()`（分组输入）和`actions()`（动态操作按钮）。

#### 输出功能
通过`put_text()`、`put_image()`、`put_table()`等函数，可以向浏览器输出内容。支持添加锚点、清除内容、定位滚动等功能。

### 3. **会话与事件**
- **会话控制**：提供`defer_call()`和`hold()`等函数，用于控制会话逻辑。
- **事件处理**：支持点击事件和自定义回调函数。

### 4. **布局与样式**
- **布局功能**：支持行布局、列布局和网格布局，通过`put_row()`、`put_col()`、`put_grid()`等函数实现。
- **样式与动画**：支持元素显示动画，提升UI体验。

### 5. **数据可视化与生态**
- **可视化支持**：支持Bokeh、Plotly、PyECharts等第三方库，实现交互式数据可视化。
- **独立应用打包**：可通过PyInstaller将PyWebIO应用打包为单独可执行文件。

### 6. **错误处理**
- 提供`error()`和`warning()`等函数，用于显示错误或警告信息。

### 7. **平台与集成**
- **框架集成**：支持与Flask、Django、Tornado、aiohttp等主流Web框架集成。
- **部署方式**：可以通过`path_deploy()`或`path_deploy_http()`从路径部署应用，支持WebSocket和HTTP通信。

### 8. **发行说明**
- **v1.2.2更新**：新增跨域支持、更彻底的Session清理、优化锚点和滚动控制等功能。
- **v0.2更新**：增加对Django和aiohttp框架的支持、动画效果、测试用例和CI工作流等。

### 总结
PyWebIO通过简洁的API和同步式交互模式，帮助开发者快速构建基于浏览器的GUI应用或Web服务，特别适合对UI要求不高但需要快速开发的场景。