PyWebIO v1.8.1 使用手册

《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 开发中的一个高效工具。