PyWebIO v1.3.0 使用手册

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

摘要

文档介绍了PyWebIO的使用方法，包括输入、输出、布局和事件回调等功能。PyWebIO提供了命令式的交互函数，允许开发者通过编写Python代码在浏览器上获取用户输入和进行输出。文档详细说明了如何使用输入函数（如文本输入、输入组）和输出函数（如文本、表格、文件输出）来构建交互式应用，并介绍了如何通过事件回调实现用户点击按钮后的响应。此外，文档还提到了PyWebIO支持与主流Web框架集成，适合快速构建对UI要求不高的Web应用。

AI总结

### PyWebIO v1.3.0 使用手册总结

#### 1. **简介**
PyWebIO 是一个用于在浏览器上构建交互式 Web 应用的 Python 库，支持命令式编程方式，类似于控制台程序的编写逻辑。它提供了一系列交互函数，可以在浏览器上实现文本、图片、表格等输出，以及表单输入、按钮点击等交互功能。PyWebIO 适合快速开发对 UI 要求不高的 Web 应用。

#### 2. **核心特性**
- **命令式交互**：通过阻塞式输入函数和实时输出函数，简化交互逻辑。
- **非声明式布局**：支持灵活的布局方式，代码侵入性小。
- **与 Web 框架集成**：支持 Flask、Django、Tornado 等主流框架。
- **数据可视化支持**：可结合第三方库实现数据可视化。
- **事件回调**：支持绑定控件点击事件，执行回调函数。

#### 3. **输入功能**
- **基本输入**：支持文本输入、数字输入、文件上传等。
- **输入组**：通过 `input_group` 可以一次性获取多个输入，并返回字典形式的结果。
- **表单验证**：支持自定义校验函数，确保输入数据符合要求。

#### 4. **输出功能**
- **基本输出**：支持文本、表格、图片、文件等多种输出形式。
- **输出域（Scope）**：支持灵活划分输出区域，通过上下文管理器控制输出位置。
- **Markdown 和 HTML 支持**：可以直接输出 Markdown 格式文本或 HTML 内容。

#### 5. **事件回调与交互**
- **按钮点击**：支持绑定按钮点击事件，执行回调函数。
- **表格交互**：支持在表格中嵌入按钮，实现行级别的交互操作。
- **回调持久化**：会话结束后，事件回调仍然有效，直到用户关闭页面。

#### 6. **布局与样式**
- **非声明式布局**：通过简单的函数调用即可实现布局，代码简洁高效。
- **嵌套输出域**：支持输出域的嵌套，实现复杂界面的分层管理。

#### 7. **服务器模式与脚本模式**
- **服务器模式**：支持将 PyWebIO 应用部署为独立的 Web 服务。
- **脚本模式**：适合在交互式环境中（如 IPython 或 Jupyter Notebook）使用，需手动调用 `.show()` 方法显示输出。

#### 8. **与其他 Web 框架集成**
PyWebIO 可以方便地与以下框架集成：
- Flask
- Django
- Tornado
- aiohttp
- FastAPI (Starlette)

#### 9. **安装**
- **稳定版**：`pip3 install -U pywebio`
- **开发版**：`pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip`
- **系统要求**：Python 3.5.2 及以上版本。

#### 10. **示例**
- **Hello, World**：输出文本和表格。
- **BMI 计算器**：通过输入体重和身高，计算 BMI 指数。
- **交互表格**：支持行级别的编辑和删除操作。

#### 11. **文档资源**
- 提供 PDF 和 Epub 格式的离线文档。
- 在线 Demo 和示例代码可通过链接访问。

#### 12. **支持与反馈**
- **问题报告**：通过 GitHub Issues 提交问题。
- **讨论支持**：在 GitHub Discussions 中寻求帮助。

PyWebIO 通过简洁的 API 和灵活的交互方式，降低了 Web 开发的门槛，特别适合快速构建轻量级 Web 应用。