PyWebIO v1.8.1 使用手册

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

摘要

文档详细介绍了PyWebIO v1.8.1的使用方法及其功能特性。PyWebIO是一款允许开发者通过编写Python代码直接在浏览器中进行交互式Web应用开发的工具，无需HTML和JavaScript知识。它通过命令式API提供了丰富的功能，包括输出文本、图像、表格以及接受用户输入。PyWebIO支持与多种主流Web框架（如Flask、Django等）集成，并能够方便地结合第三方库进行数据可视化。文档还介绍了如何将PyWebIO应用打包部署，以及其他高级特性和版本更新内容。

AI总结

《PyWebIO v1.8.1 使用手册》主要介绍了PyWebIO的功能、使用方法及相关高级特性，以下是文档的核心内容总结：

### 1. **PyWebIO 概述**
PyWebIO 是一个通过命令式 API 在浏览器上实现用户交互的库，允许开发者像编写终端脚本一样快速构建 Web 应用或基于浏览器的 GUI 应用。其核心特点包括：
- 使用同步逻辑获取用户输入，代码编写更自然。
- 支持与 Flask、Django、Tornado 等主流 Web 框架集成。
- 提供数据可视化（如 Bokeh、Plotly）、布局、会话控制等功能。
- 支持将 Python 应用打包为独立可执行文件。

---

### 2. **核心功能**
- **命令式 API**：通过 `put_text()`、`put_image()`、`put_table()` 等输出内容，通过 `input()`、`select()`、`file_upload()` 接收用户输入。
- **布局与交互**：支持点击事件、动画效果、内容滚动、元素显示/隐藏等，提升用户体验。
- **数据可视化**：整合第三方库（如 Bokeh、Plotly、pyecharts）实现交互式可视化。
- **会话控制**：支持会话管理、内容动态更新（如 `defer_call()`、`hold()`）。
- **部署方式**：通过 `start_server()` 启动服务，或集成到现有 Web 框架。

---

### 3. **高级特性**
- **安全性**：支持防 XSS 攻击（`sanitize` 参数）。
- **SEO 支持**：通过注释或 `pywebio.platform.seo()` 设置 SEO 信息。
- **国际化支持**：便于多语言适配。
- **CDN 支持**：简化 Web 框架整合流程。

---

### 4. **与第三方库的集成**
- **数据可视化**：支持 Bokeh、Plotly 等库，通过 `bokeh.io.output_notebook()` 实现可视化。
- **独立应用打包**：使用 PyInstaller 将应用打包为独立可执行文件：
1. 创建 `pyinstaller` 规格文件：`pyi-makespec app.py`
2. 修改规格文件（如添加依赖）。
3. 构建可执行文件：`pyinstaller app.spec`

---

### 5. **发布说明**
- **新增功能**：
- 输出图像（`put_image()`）、移除内容（`remove()`）。
- 支持跨行/列单元格表格（`put_table()`）。
- 图表动画效果提升 UI 体验。
- **修复与改进**：
- 修复 `file_upload()` 参数解析错误。
- 优化自动打开浏览器功能。
- 支持多语言和 SEO。

---

### 总结
PyWebIO 通过简洁的 API 和强大的功能，帮助开发者快速构建基于浏览器的交互式应用，尤其适合需要快速开发但对 UI 要求不高的场景。其灵活的部署方式和与主流 Web 框架的集成能力，使其成为 Web 开发中的一个高效工具。