PyWebIO v1.1.0 使用手册

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

摘要

文档介绍了PyWebIO v1.1.0的使用手册，详细说明了其特性、输入输出功能、版本更新日志等。PyWebIO提供了一系列命令式的交互函数，允许开发者在浏览器上获取用户输入和进行输出，支持构建简单的Web应用或基于浏览器的GUI应用。其特性包括同步方式获取输入、非声明式布局、支持与Flask、Django等Web框架集成、数据可视化等。更新日志中提到了对输入函数、文件上传、表格输出等功能的改进和新增。通过简单的代码，用户可以实现复杂的交互功能，并提供良好的用户体验。

AI总结

《PyWebIO v1.1.0 使用手册》总结

PyWebIO 是一个能够通过最少代码实现用户交互并提供良好用户体验的库。它将浏览器变为“富文本终端”，使开发者像编写终端脚本一样快速构建 Web 应用，无需 HTML 和 JS知识，且支持整合到现有Web服务中。

### 核心特性
1. **同步式交互**：通过 input 和 output 函数实现阻塞式交互，代码逻辑自然。
2. **简单布局**：非声明式布局方式，使用命令式 API 即可输出文本、图片、表格等内容。
3. **轻松改造**：旧脚本仅需修改输入输出逻辑即可改造为 Web 服务。
4. **广泛整合**：支持 Flask、Django、Tornado、aiohttp 等框架集成，提供基于线程和协程的执行模型。
5. **数据可视化**：支持 Bokeh、Plotly、PyECharts 等库实现数据可视化。

### 输入函数
pywebio.input 模块提供多种输入函数：
- **text**: 文本输入，type 参数支持 NUMBER、PASSWORD 等类型。
- **select**: 下拉选择框。
- **checkbox**: 勾选框。
- **radio**: 单选框。
- **textarea**: 多行文本输入。
- **file_upload**: 文件上传，支持多文件、大小限制和进度显示。

### 输出函数
pywebio.output 模块提供多种输出函数：
- **put_text**: 输出文本，支持多个对象。
- **put_image**: 输出图片，支持通过 URL 指定。
- **put_table**: 输出表格，支持跨行/列单元格。
- **put_buttons**: 输出按钮，支持指定颜色。
- **put_widget**: 输出组件，字符串内容作为纯文本。

### 功能扩展
- **会话控制**：提供 defer_call、hold 等函数控制会话。
- **动画效果**：增强 UI 体验。
- **信息获取**：session.get_info() 获取会话信息。

### 安装与运行
- **安装**：pip3 install -U pywebio（稳定版），或安装开发版。
- **系统要求**：Python 3.5.2+。
- **启动服务**：io.start_server() 启动服务，示例可在线预览 Demo。

### 更新日志
- **v1.1.0**：input 支持动态值，put_buttons 支持颜色，put_widget 等输出纯文本。
- **v0.3**：支持 Bokeh 数据可视化，前端 js 迁移 TypeScript。
- **v0.2**：支持 Plotly、PyECharts，添加 put_image、remove 等功能。

PyWebIO 旨在通过简单的代码实现高效、直观的用户交互，适合快速构建 UI 要求不高的应用。