过这里的终端变成 了浏览器。通过PyWebIO提供的命令式API， 你可以简单地调用 put_text 、 put_image 、 put_table 等函数输出文本、图片、表格等内容到浏览器，也可 以调用 input 、 select 、 file_upload 等函数在浏览器上显示不同表单来接收 用户的输入。此外PyWebIO中还提供了点击事件、布局等支持，让你可以使用 最少的代码完成与用户的交互， 最少的代码完成与用户的交互， 并尽可能提供良好的用户体验。 本篇使用指南从几个方面对PyWebIO的使用进行介绍，覆盖了PyWebIO的绝大 部分特性。本文档中大部分示例代码的右上方都有一个Demo链接，点击后可 以在线预览代码的运行效果。 输入 输入函数都定义在 pywebio.input 模块中，可以使用 from pywebio.input import * 引入。 调用输入函数会在浏览器上弹出一个输 户完 成输入将表单提交后，函数返回用户输入的值。 下面是一些其他类型的输入函数: age = input("How old are you?", type=NUMBER) 输入选项 输入函数可指定的参数非常丰富（全部参数及含义请见 函数文档 ）: 以上代码将在浏览器上显示如下： 我们可以为输入指定校验函数，校验函数应在校验通过时返回None，否则返回 错误消息: # 密码输入 password

file_upload("Select a image:", accept="image/*") 10 Chapter 4. Documentation PyWebIO, 发布 1.1.0 输入选项 输入函数可指定的参数非常丰富（全部参数及含义请见函数文档 ）: input('This is label', type=TEXT, placeholder='This is placeholder', help_text='This put_xxx() 调 用 作 为 参 数 的 输 出 函 数 还 有put_collapse() 、put_scrollable() 、 put_row() 等, 此外，还可以通过put_widget() 自定义可接收 put_xxx() 调用的输出组件，具体用 法请参考函数文档。 使用组合输出时，如果想在内容输出后，对其中的 put_xxx() 子项进行动态修改，可以使用output() 函 数，output() put_buttons(['A', 'B', 'C'], onclick=btn_click) 注解: 在 PyWebIO 会话 (关于会话的概念见下文Server 与 script 模式 ) 结束后，事件回调也将不起作用，你可 4.1. User’s guide 15 PyWebIO, 发布 1.1.0 以在任务函数末尾处使用pywebio.session.hold() 函数来将会话保持，这样在用户关闭浏览器页面前，

file_upload("Select a image:", accept="image/*") 10 Chapter 4. Documentation PyWebIO, 发布 1.2.3 输入选项 输入函数可指定的参数非常丰富（全部参数及含义请见函数文档 ）: input('This is label', type=TEXT, placeholder='This is placeholder', help_text='This put_buttons(['A', 'B', 'C'], onclick=btn_click) 注解: 在 PyWebIO 会话 (关于会话的概念见下文Server 与 script 模式 ) 结束后，事件回调也将不起作用，你可 以在任务函数末尾处使用pywebio.session.hold() 函数来将会话保持，这样在用户关闭浏览器页面前， 事件回调将一直可用。 输出域 Scope PyWebIO 使用 Scope put_text(datetime.now()) 第一次调用 show_time 时，将会创建 time 输出域并在其中输出当前时间，之后每次调用 show_time() ， 输出域都会被新的内容覆盖。 Scope 是可嵌套的，初始条件下，PyWebIO 应用只有一个最顶层的 ROOT Scope。每创建一个新 Scope，Scope 的嵌套层级便会多加一层，每退出当前 Scope，Scope 的嵌套层级便会减少一层。PyWebIO

file_upload("Select a image:", accept="image/*") 10 Chapter 4. Documentation PyWebIO, 发布 1.2.2 输入选项 输入函数可指定的参数非常丰富（全部参数及含义请见函数文档 ）: input('This is label', type=TEXT, placeholder='This is placeholder', help_text='This put_buttons(['A', 'B', 'C'], onclick=btn_click) 注解: 在 PyWebIO 会话 (关于会话的概念见下文Server 与 script 模式 ) 结束后，事件回调也将不起作用，你可 以在任务函数末尾处使用pywebio.session.hold() 函数来将会话保持，这样在用户关闭浏览器页面前， 事件回调将一直可用。 输出域 Scope PyWebIO 使用 Scope put_text(datetime.now()) 第一次调用 show_time 时，将会在当前位置创建 time 输出域并在其中输出当前时间，之后每次调用 show_time() ，时间都会输出到相同的区域。 Scope 是可嵌套的，初始条件下，PyWebIO 应用只有一个最顶层的 ROOT Scope。每创建一个新 Scope，Scope 的嵌套层级便会多加一层，每退出当前 Scope，Scope 的嵌套层级便会减少一层。PyWebIO

过这里的终端变成 了浏览器。通过PyWebIO提供的命令式API， 你可以简单地调用 put_text 、 put_image 、 put_table 等函数输出文本、图片、表格等内容到浏览器，也可 以调用 input 、 select 、 file_upload 等函数在浏览器上显示不同表单来接收 用户的输入。此外PyWebIO中还提供了点击事件、布局等支持，让你可以使用 最少的代码完成与用户的交互， 最少的代码完成与用户的交互， 并尽可能提供良好的用户体验。 本篇使用指南从几个方面对PyWebIO的使用进行介绍，覆盖了PyWebIO的绝大 部分特性。本文档中大部分示例代码的右上方都有一个Demo链接，点击后可 以在线预览代码的运行效果。 输入 输入函数都定义在 pywebio.input 模块中，可以使用 from pywebio.input import * 引入。 调用输入函数会在浏览器上弹出一个输 户完 成输入将表单提交后，函数返回用户输入的值。 下面是一些其他类型的输入函数: age = input("How old are you?", type=NUMBER) 输入选项 输入函数可指定的参数非常丰富（全部参数及含义请见 函数文档 ）: 以上代码将在浏览器上显示如下： 我们可以为输入指定校验函数，校验函数应在校验通过时返回None，否则返回 错误消息: # Password

过这里的终端变成 了浏览器。通过PyWebIO提供的命令式API， 你可以简单地调用 put_text 、 put_image 、 put_table 等函数输出文本、图片、表格等内容到浏览器，也可 以调用 input 、 select 、 file_upload 等函数在浏览器上显示不同表单来接收 用户的输入。此外PyWebIO中还提供了点击事件、布局等支持，让你可以使用 最少的代码完成与用户的交互， 最少的代码完成与用户的交互， 并尽可能提供良好的用户体验。 本篇使用指南从几个方面对PyWebIO的使用进行介绍，覆盖了PyWebIO的绝大 部分特性。本文档中大部分示例代码的右上方都有一个Demo链接，点击后可 以在线预览代码的运行效果。 输入 输入函数都定义在 pywebio.input 模块中，可以使用 from pywebio.input import * 引入。 调用输入函数会在浏览器上弹出一个输 户完 成输入将表单提交后，函数返回用户输入的值。 下面是一些其他类型的输入函数: age = input("How old are you?", type=NUMBER) 输入选项 输入函数可指定的参数非常丰富（全部参数及含义请见 函数文档 ）: 以上代码将在浏览器上显示如下： 我们可以为输入指定校验函数，校验函数应在校验通过时返回None，否则返回 错误消息: # Password

file_upload("Select a image:", accept="image/*") 10 Chapter 4. Documentation PyWebIO, 发布 1.3.1 输入选项 输入函数可指定的参数非常丰富（全部参数及含义请见函数文档 ）: input('This is label', type=TEXT, placeholder='This is placeholder', help_text='This put_buttons(['A', 'B', 'C'], onclick=btn_click) 注解: 在 PyWebIO 会话 (关于会话的概念见下文Server 与 script 模式 ) 结束后，事件回调也将不起作用，你可 以在任务函数末尾处使用pywebio.session.hold() 函数来将会话保持，这样在用户关闭浏览器页面前， 事件回调将一直可用。 输出域 Scope PyWebIO 使用 Scope put_text(datetime.now()) 第一次调用 show_time 时，将会创建 time 输出域并在其中输出当前时间，之后每次调用 show_time() ， 输出域都会被新的内容覆盖。 Scope 是可嵌套的，初始条件下，PyWebIO 应用只有一个最顶层的 ROOT Scope。每创建一个新 Scope，Scope 的嵌套层级便会多加一层，每退出当前 Scope，Scope 的嵌套层级便会减少一层。PyWebIO

file_upload("Select a image:", accept="image/*") 10 Chapter 4. Documentation PyWebIO, 发布 1.3.3 输入选项 输入函数可指定的参数非常丰富（全部参数及含义请见函数文档 ）: input('This is label', type=TEXT, placeholder='This is placeholder', help_text='This put_buttons(['A', 'B', 'C'], onclick=btn_click) 注解: 在 PyWebIO 会话 (关于会话的概念见下文Server 与 script 模式 ) 结束后，事件回调也将不起作用，你可 以在任务函数末尾处使用pywebio.session.hold() 函数来将会话保持，这样在用户关闭浏览器页面前， 事件回调将一直可用。 输出域 Scope PyWebIO 使用 Scope put_text(datetime.now()) 第一次调用 show_time 时，将会创建 time 输出域并在其中输出当前时间，之后每次调用 show_time() ， 输出域都会被新的内容覆盖。 Scope 是可嵌套的，初始条件下，PyWebIO 应用只有一个最顶层的 ROOT Scope。每创建一个新 Scope，Scope 的嵌套层级便会多加一层，每退出当前 Scope，Scope 的嵌套层级便会减少一层。PyWebIO

file_upload("Select a image:", accept="image/*") 10 Chapter 4. Documentation PyWebIO, 发布 1.3.2 输入选项 输入函数可指定的参数非常丰富（全部参数及含义请见函数文档 ）: input('This is label', type=TEXT, placeholder='This is placeholder', help_text='This put_buttons(['A', 'B', 'C'], onclick=btn_click) 注解: 在 PyWebIO 会话 (关于会话的概念见下文Server 与 script 模式 ) 结束后，事件回调也将不起作用，你可 以在任务函数末尾处使用pywebio.session.hold() 函数来将会话保持，这样在用户关闭浏览器页面前， 事件回调将一直可用。 输出域 Scope PyWebIO 使用 Scope put_text(datetime.now()) 第一次调用 show_time 时，将会创建 time 输出域并在其中输出当前时间，之后每次调用 show_time() ， 输出域都会被新的内容覆盖。 Scope 是可嵌套的，初始条件下，PyWebIO 应用只有一个最顶层的 ROOT Scope。每创建一个新 Scope，Scope 的嵌套层级便会多加一层，每退出当前 Scope，Scope 的嵌套层级便会减少一层。PyWebIO

file_upload("Select a image:", accept="image/*") 10 Chapter 4. Documentation PyWebIO, 发布 1.3.0 输入选项 输入函数可指定的参数非常丰富（全部参数及含义请见函数文档 ）: input('This is label', type=TEXT, placeholder='This is placeholder', help_text='This put_buttons(['A', 'B', 'C'], onclick=btn_click) 注解: 在 PyWebIO 会话 (关于会话的概念见下文Server 与 script 模式 ) 结束后，事件回调也将不起作用，你可 以在任务函数末尾处使用pywebio.session.hold() 函数来将会话保持，这样在用户关闭浏览器页面前， 事件回调将一直可用。 输出域 Scope PyWebIO 使用 Scope put_text(datetime.now()) 第一次调用 show_time 时，将会创建 time 输出域并在其中输出当前时间，之后每次调用 show_time() ， 输出域都会被新的内容覆盖。 Scope 是可嵌套的，初始条件下，PyWebIO 应用只有一个最顶层的 ROOT Scope。每创建一个新 Scope，Scope 的嵌套层级便会多加一层，每退出当前 Scope，Scope 的嵌套层级便会减少一层。PyWebIO