PyWebIO v1.5.0 使用手册

语言	格式	评分
中文（简体）	.pdf	3
摘要
PyWebIO 是一个支持通过 Python 代码实现浏览器交互的工具，提供了丰富的输入输出函数，如文本输入、密码输入、下拉选择、复选框等。其命令式 API 允许开发者像编写终端脚本一样构建 Web 应用，无需 HTML 和 JS 知识。PyWebIO 支持与多种 Web 框架集成，并提供了会话控制功能，如 defer_call() 和 hold()。新版本 1.5.0 添加了多项新功能，如动画支持、国际化、SEO 和 CDN 支持，以及安全增强。详细更新日志涵盖了 UI 改进、功能扩展和 Bug 修复。
AI总结
# 《PyWebIO v1.5.0 使用手册》总结 ## 1. 简介 PyWebIO 是一个通过命令式 API 实现浏览器交互的 Python 库，允许开发者用同步代码编写 Web 应用，无需悉悉sovess HTML 和 JavaScript。它支持快速构建用户交互式的 Web 应用，适合需要简单 UI 的场景，并且可以整合到现有的 Web 框架（如 Flask、Django、Tornado 等）中。 --- ## 2. 核心功能 ### 2.1 输入函数所有输入函数位于 `pywebio.input` 模块中，调用后会在浏览器弹出表单，阻塞式等待用户输入。常用输入函数包括： - 文本输入：`input()`，支持指定类型（如 `NUMBER`、`PASSWORD`）。 - 下拉选择：`select()`。 - 多选框：`checkbox()`。 - 单选框：`radio()`。 - 多行文本：`textarea()`。 - 文件上传：`file_upload()`。 --- ### 2.2 输出函数输出函数位于 `pywebio.output` 模块中，用于将内容显示在浏览器中，支持： - 文本：`put_text()`。 - 图片：`put_image()`。 - 表格：`put_table()`。 - Markdown：`put_markdown()`。 - 状态提醒：`put_success()`、`put_error()` 等。支持通过 `anchor` 参数指定输出位置，并提供内容删除、替换等功能。 --- ### 2.3 会话控制 - 支持 `defer_call()` 和 `hold()` 用于控制会话流程。 - 提供 `remove()` 和 `clear_range()` 删除或清除指定锚点内容。 - 支持 `scroll_to()` 控制滚动位置。 --- ### 2.4 第三方库生态 - 支持与 Plotly、Bokeh、PyEcharts 等库结合，实现数据可视化。 - 可通过 `put_code()` 输出代码块。 - 支持 `PyInstaller` 将应用打包为独立 executable 文件。 --- ## 3. 与 Web 框架整合 PyWebIO 支持多种 Web 框架： - Flask、Django、Tornado、aiohttp、FastAPI（Starlette）等。 - 通过 `start_server()` 启动服务或将任务函数整合到现有框架中。 - 支持基于线程或协程的执行模型。 --- ## 4. 版本更新记录 ### 4.1 v1.5.0 主要更新 - 添加 `defer_call()` 和 `hold()` 会话控制函数。 - 支持输出图像（`put_image()`）和移除内容（`remove()`）。 - 提供动画效果提升 UI 体验。 - 修复文件上传大小解析错误。 ### 4.2 v1.1 主要更新（2021/2/7） - 增强安全性：`put_html()` 和 `put_markdown()` 支持防 XSS 攻击。 - 添加国际化支持。 - 支持 CDN 和 SEO。 - 优化通信协议，不再通过探测请求确定协议。主要不兼容变更： - 移除 `django` 和 `flask` 中的 `disable_asyncio` 参数。 - 废弃 `pywebio.session.data()`，改用 `pywebio.session.local` 存储会话状态。 --- ## 5. 特性亮点 - 同步编程：代码逻辑自然，类似终端脚本。 - 非声明式布局：布局方式简单高效。 - 跨框架支持：支持 Flask、Django 等主流框架。 - 轻松部署：通过 `PyInstaller` 打包为独立应用。 --- ## 6. 总结 PyWebIO 通过简洁的 API 提供了丰富的交互功能，适合快速开发简单的 Web 应用或将 Python 脚本转化为 Web 服务。其跨框架支持和第三方库结合特性进一步提升了灵活性。