PyWebIO v1.8.2 使用手册

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

摘要

本文档为PyWebIO v1.8.2使用手册，主要介绍输入组和输出模块的使用方法。输入组部分说明了如何获取用户输入（如姓名、年龄），并包含错误处理逻辑（如姓名长度过长、年龄为负数）。输出部分涵盖了基本输出函数（如put_text、put_table、put_image、put_markdown、put_file）以及输出域（Scope）管理，包括clear、remove等操作。文档还介绍了高级特性，如使用start_server启动多应用、异步支持（await eval_js）、以及回调函数（如onclick）的绑定方式。此外，列出了输入和输出相关的函数清单，并强调了参数验证和用户输入处理的注意事项。

AI总结

PyWebIO v1.8.2 使用手册核心内容总结如下：

**1. 输入组**
* **输入验证**：可以对输入项（如姓名、年龄）进行自定义验证。例如，检查姓名是否为空或过长，年龄不能为负数。验证失败时会返回错误信息。
* **输入类型**：支持文本、数字等多种输入框。

**2. 输出**
* **基本输出函数**：
* `put_text`：输出纯文本。
* `put_table`：输出表格（如商品价格表）。
* `put_image`：输出图片（支持本地路径或网络URL）。
* `put_markdown`：输出Markdown格式内容（如删除线）。
* `put_file`：提供文件下载。
* **高级特性**：支持通过回调函数（`callback`参数）为按钮等组件绑定交互事件。

**3. 启动多应用**
* 使用 `start_server` 可以启动包含多个任务（Task）的应用。
* 通过 `tasks` 参数定义多个任务，每个任务对应一组页面函数。
* 可通过 `index` 参数指定默认显示的任务，或通过URL参数访问特定任务。

**4. 异步与JS交互**
* 支持 `await eval_js()` 执行JavaScript表达式，并获取返回值。
* 可通过 `run_js` 调用JavaScript函数（如改变页面位置）。
* 支持通过 `on_click` 等参数为按钮、图片、文本等组件绑定点击事件（回调函数）。

**5. 输出域与作用域**
* **输出域（Scope）**：用于管理输出内容的区域。
* **关键函数**：
* `put_scope`：创建新的输出域。
* `use_scope`：将后续输出放入指定域中。
* `get_scope`：获取指定域。
* `clear`：清空域内内容。
* `remove`：移除整个域。
* `scroll_to`：滚动到指定域位置。
* **作用域嵌套**：支持在父域中创建子域，实现精细化的内容布局和更新。

**6. 输入模块**
* **函数清单**：提供了 `input` 等函数用于接收用户输入。
* **输入组**：`input_group` 可将多个输入项组合在一起，并一次性提交。
* **参数**：支持 `required`（必填）、`placeholder`（占位符）等参数。

**7. 其他交互**
* **通知与提示**：支持 `toast`（短暂提示）、`popup`（弹窗）和 `close_popup`（关闭弹窗）等交互方式。
* **布局组件**：提供 `put_row`、`put_column`、`put_grid` 等函数进行行列布局，以及 `span` 和 `style` 进行样式调整。