Gradio 用户月活破百万之旅！
阅读更多
- 助手
- 示例
示例
gradio.Examples(···)描述
此类是 Dataset 组件的包装器，可用于为 Blocks / Interfaces 创建示例。使用示例填充 Dataset 组件，并分配事件侦听器，以便单击示例时填充输入/输出组件。 可选地处理示例缓存以实现快速推理。
初始化
参数
examples: list[Any] | list[list[Any]] | str
examples: list[Any] | list[list[Any]] | str可点击以填充特定组件的示例输入。应为嵌套列表，其中外层列表由样本组成，每个内层列表由与每个输入组件对应的输入组成。 也可以提供示例目录的字符串路径，但它应位于运行 gradio 应用程序的 python 文件所在的目录中。 如果有多个输入组件且提供了目录，则目录中必须存在 log.csv 文件以链接相应的输入。
outputs: Component | list[Component] | None
outputs: Component | list[Component] | None默认
= None可选地，提供与示例输出相对应的组件或组件列表。如果 `cache_examples` 不是 False，则为必填项。
fn: Callable | None
fn: Callable | None默认
= None可选地，提供用于运行以生成与示例对应的输出的函数。如果 `cache_examples` 不是 False，则为必填项。如果 `run_on_click` 为 True，则也为必填项。
cache_examples: bool | None
cache_examples: bool | None默认
= None如果为 True，则在服务器中缓存示例，以加快示例的运行时速度。如果为“lazy”，则在首次使用后（由应用程序的任何用户）缓存示例（对于应用程序的所有用户）。如果为 None，将使用 GRADIO_CACHE_EXAMPLES 环境变量，该变量应为“true”或“false”。在 HuggingFace Spaces 中，此参数为 True（只要也提供了 `fn` 和 `outputs`）。否则，默认选项为 False。
cache_mode: Literal['eager', 'lazy'] | None
cache_mode: Literal['eager', 'lazy'] | None默认
= None如果为“lazy”，则在首次使用后缓存示例。如果为“eager”，则在应用程序启动时缓存所有示例。如果为 None，将使用 GRADIO_CACHE_MODE 环境变量（如果已定义），否则默认为“eager”。
run_on_click: bool
run_on_click: bool默认
= False如果 cache_examples 为 False，则单击示例时不会在单击示例时运行该函数。 将此项设置为 True 以在单击示例时运行该函数。如果 cache_examples 为 True，则无效。
api_name: str | Literal[False]
api_name: str | Literal[False]默认
= "load_example"定义与单击示例关联的事件在 API 文档中的显示方式。 可以是字符串或 False。 如果设置为字符串，则端点将在 API 文档中以给定名称公开。 如果为 False，则端点将不会在 API 文档中公开，并且下游应用程序（包括 `gr.load` 此应用程序的应用程序）将无法使用示例函数。
属性
参数
示例
更新示例
在此演示中，我们展示了如何通过更新底层数据集的样本来更新示例。 请注意，这仅在 cache_examples=False 时有效，因为更新底层数据集不会更新缓存。
import gradio as gr
def update_examples(country):
if country == "USA":
return gr.Dataset(samples=[["Chicago"], ["Little Rock"], ["San Francisco"]])
else:
return gr.Dataset(samples=[["Islamabad"], ["Karachi"], ["Lahore"]])
with gr.Blocks() as demo:
dropdown = gr.Dropdown(label="Country", choices=["USA", "Pakistan"], value="USA")
textbox = gr.Textbox()
examples = gr.Examples([["Chicago"], ["Little Rock"], ["San Francisco"]], textbox)
dropdown.change(update_examples, dropdown, examples.dataset)
demo.launch()演示
import gradio as gr
def calculator(num1, operation, num2):
if operation == "add":
return num1 + num2
elif operation == "subtract":
return num1 - num2
elif operation == "multiply":
return num1 * num2
elif operation == "divide":
return num1 / num2
with gr.Blocks() as demo:
with gr.Row():
with gr.Column():
num_1 = gr.Number(value=4)
operation = gr.Radio(["add", "subtract", "multiply", "divide"])
num_2 = gr.Number(value=0)
submit_btn = gr.Button(value="Calculate")
with gr.Column():
result = gr.Number()
submit_btn.click(
calculator, inputs=[num_1, operation, num_2], outputs=[result], api_name=False
)
examples = gr.Examples(
examples=[
[5, "add", 3],
[4, "divide", 2],
[-4, "multiply", 2.5],
[0, "subtract", 1.2],
],
inputs=[num_1, operation, num_2],
)
if __name__ == "__main__":
demo.launch(show_api=False)