PyWebIO v1.7.0 使用手册

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

摘要

本文档详细介绍了PyWebIO v1.7.0的使用手册，包括其核心特性、安装方法、交互式功能、数据可视化支持以及版本更新日志。PyWebIO是一个通过Python代码在浏览器中实现交互式Web应用的库，提供了命令式的API来简化开发流程。其主要特性包括同步式输入获取、非声明式布局、高效的用户交互以及与主流Web框架的集成支持。本文档还介绍了如何利用PyWebIO进行数据可视化、构建独立应用，并详细列出了各版本的更新内容。

AI总结

《PyWebIO v1.7.0 使用手册》是一份详细介绍PyWebIO框架的文档，以下是对其内容的简要总结：

---

### **概述**
PyWebIO是一个基于Python的Web交互框架，允许开发者通过编写Python代码直接在浏览器中实现用户交互，类似于终端脚本的编写方式。它支持命令式API调用，能够轻松实现输入、输出、布局以及数据可视化等功能，适合快速构建对UI要求不高的Web应用。

---

### **核心功能**
1. **输入输出**
- 输入函数（如`input()`、`select()`、`file_upload()`）可以弹出表单获取用户输入，阻塞式调用，类似于Python内置的`input()`。
- 输出函数（如`put_text()`、`put_image()`、`put_table()`）可以将内容输出到浏览器，并支持布局控制（如`put_grid()`、`put_row()`）。
- 支持动态交互，如点击事件、JS执行、实时更新等。

2. **布局与样式**
- 提供丰富的布局函数，支持自定义样式和动画效果，提升用户体验。
- 添加了`toast()`、`popup()`等浮动提示功能。

3. **数据可视化**
- 支持第三方库（如Bokeh、Plotly、pyecharts、pyg2plot）进行数据可视化。

4. **Web框架整合**
- 支持与Flask、Django、Tornado、aiohttp、FastAPI等主流Web框架集成。

5. **多功能扩展**
- 支持WebSocket连接重连、静态文件托管、SEO优化、代码保护（防XSS攻击）等功能。

---

### **安装与使用**
1. **安装**
- 稳定版：`pip3 install -U pywebio`
- 开发版：通过阿里云仓库安装。
- 系统要求：Python 3.5.2及以上版本。

2. **快速上手**
- 示例代码：计算BMI指数的脚本，展示了输入输出的基本使用。
- 支持构建独立应用：通过PyInstaller将应用打包为可执行文件。

---

### **Release Notes**
- **v1.7.0**
- 添加多任务函数支持，实现任务间跳转（`go_app()`）。
- 提供布局支持（`put_grid()`、`put_row()`）和自定义样式。
- 添加新函数：`toast()、popup()、put_widget()`等。
- 更新UI，支持浮动输入框和异常日志记录。

- **v1.6.0**
- 提供国际化支持，并优化访问速度。
- 添加安全性支持，防止XSS攻击。
- 支持CDN部署，简化Web框架整合。

- **v1.5.0及以下**
- 支持多文件上传、文件大小限制及上传进度显示。
- 支持与第三方库结合实现数据可视化。

---

### **技术支持与文档**
- **讨论与反馈**
- GitHub讨论区：[https://github.com/wang0618/PyWebIO/discussions](https://github.com/wang0618/PyWebIO/discussions)
- 报告问题：[https://github.com/wang0618/pywebio/issues](https://github.com/wang0618/pywebio/issues)

- **更多资源**
- 官方文档提供详细功能说明、示例代码及发布日志。
- 支持离线构建应用，适合快速开发和部署。

---

### **总结**
PyWebIO通过简洁的API和强大的功能，帮助开发者快速构建基于浏览器的交互式应用，适合数据可视化、快速原型开发或简单的Web服务场景。