PyWebIO v1.6.3 使用手册

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

摘要

《PyWebIO v1.6.3 使用手册》介绍了PyWebIO框架的功能和用法，展示其通过Python代码实现浏览器交互的特性。文档详细说明了输入函数如input()、file_upload()等的使用，输出函数如put_text()、put_image()等的操作，以及布局和事件的处理。新版本v1.6.3修复了多项bug，包括plotly.js版本错误、选项隐藏问题，优化了数据可视化支持，并新增了严格模式和颜色输入类型。

AI总结

《PyWebIO v1.6.3 使用手册》总结如下：

---

### **概述**
PyWebIO是一款支持通过Python代码实现浏览器交互的库，用户可以像编写终端脚本一样快速开发Web应用或基于浏览器的GUI应用。其特点包括：
- **同步方式交互**：通过阻塞式输入函数获取用户输入，代码逻辑更自然。
- **命令式API**：提供`put_text()`、`put_image()`、`put_table()`等输出函数，以及`input()`、`select()`等输入函数，简化交互开发。
- **简单布局**：非声明式布局方式，代码侵入性小，易于将旧脚本改造成Web应用。
- **框架支持**：支持与Flask、Django、Tornado、aiohttp、FastAPI等框架集成。
- **数据可视化**：集成第三方库（如Plotly、Bokeh、pyecharts）实现可视化。

---

### **核心功能**
1. **输入与输出**
- **输入函数**：定义在`pywebio.input`模块，支持文本、数字、文件上传等多种输入类型。
- **输出函数**：支持输出文本、图片、表格、代码等内容，并提供布局控制（如`put_row()`、`put_grid()`）。
- **交互功能**：包括点击事件、表单取消、动画效果等，提升用户体验。

2. **安装与使用**
- **安装**：

     pip3 install -U pywebio  # 稳定版
     pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip  # 开发版

- **示例**：

     from pywebio.input import input, FLOAT
     from pywebio.output import put_text

     height = input("你的身高吗？", type=FLOAT)
     weight = input("你的体重吗？", type=FLOAT)
     bmi = weight / (height ** 2)
     put_text(f"你的BMI指数是：{bmi:.2f}")

3. **高级特性**
- **Web框架整合**：支持基于线程和协程的会话模型。
- **数据可视化**：集成Plotly、Bokeh等第三方库。
- **独立应用打包**：使用PyInstaller将应用打包为可执行文件。
- **SEO与CDN支持**：通过注释或API设置SEO信息，支持CDN加速。

---

### **版本更新**
1. **v1.6.3（2022/10/4）**
- 修复了`put_processbar()`中文显示问题。
- 修复Plotly CDN链接过时问题。

2. **v1.6.2（2022/7/16）**
- 修复了`plotly.js`版本错误。

3. **v1.6.1（2022/5/22）**
- 修复`put_processbar()`不支持空格问题。
- 修复`put_select()`隐藏问题。

4. **v1.6（2022/3/23）**
- 添加了`pin_on_change()`和严格模式。
- 支持波斯语界面。
- 添加颜色输入类型。

---

### **支持与资源**
- **文档与示例**：提供详细文档和在线Demo演示。
- **社区支持**：
- **讨论区**：https://github.com/wang0618/PyWebIO/discussions
- **报告问题**：https://github.com/wang0618/pywebio/issues
- **第三方库支持**：Bokeh、Plotly、pyecharts等।

---

PyWebIO通过简化的API和强大的功能，帮助开发者快速构建基于浏览器的交互式应用，适合快速开发和原型设计。