- 组件
- 条形图
条形图
gradio.BarPlot(···)描述
创建一个条形图组件，用于显示 pandas DataFrame 中的数据。
行为
作为输入组件: 要在折线图显示的数据。
您的函数应接受其中一种类型
def predict(
value: AltairPlotData
)
...作为输出组件: 期望一个 pandas DataFrame，其中包含要在折线图中显示的数据。DataFrame 应包含至少两列，一列用于 x 轴（对应于此组件的 x 参数），另一列用于 y 轴（对应于 y）。
您的函数应返回其中一种类型
def predict(···) -> pd.DataFrame | None
...
return value初始化
x_bin: str | float | None
x_bin: str | float | None= None用于对 x 值进行分组的聚合。如果 x 列是数字，则应为用于分箱 x 值的数字。如果 x 列是日期时间，则应为字符串，例如“1h”、“15m”、“10s”，使用“s”、“m”、“h”、“d”后缀。
y_aggregate: Literal['sum', 'mean', 'median', 'min', 'max', 'count'] | None
y_aggregate: Literal['sum', 'mean', 'median', 'min', 'max', 'count'] | None= None用于聚合 y 值的聚合函数，如果提供了 x_bin 或 x 是字符串/类别，则使用。必须是“sum”、“mean”、“median”、“min”、“max”之一。
color_map: dict[str, str] | None
color_map: dict[str, str] | None= None系列到颜色名称或代码的映射。例如，“{"success": "green", "fail": "#FF8888"}”。
x_lim: list[float | None] | None
x_lim: list[float | None] | None= None一个元组或列表，包含 x 轴的限制，指定为 [x_min, x_max]。要仅固定其中一个值，请将另一个设置为 None，例如 [0, None] 从 0 缩放到最大值。如果 x 列是日期时间类型，x_lim 应该是时间戳。
y_lim: list[float | None]
y_lim: list[float | None]= None一个元组或列表，包含 y 轴的限制，指定为 [y_min, y_max]。要仅固定其中一个值，请将另一个设置为 None，例如 [0, None] 从 0 缩放到最大值。
x_axis_format: str | None
x_axis_format: str | None= Nonex 轴标签的 d3 格式字符串（例如，“.2e”表示科学计数法，“~g”表示通用格式）。如果为 None，则使用 Vega-Lite 的默认格式。
y_axis_format: str | None
y_axis_format: str | None= Noney 轴标签的 d3 格式字符串（例如，“.2e”表示科学计数法，“~g”表示通用格式）。如果为 None，则使用 Vega-Lite 的默认格式。
sort: Literal['x', 'y', '-x', '-y'] | list[str] | None
sort: Literal['x', 'y', '-x', '-y'] | list[str] | None= Nonex 值（如果 x 列为字符串/类别类型）的排序顺序。可以是“x”、“y”、“-x”、“-y”，或代表类别顺序的字符串列表。
tooltip: Literal['axis', 'none', 'all'] | list[str]
tooltip: Literal['axis', 'none', 'all'] | list[str]= "axis"悬停在某点时显示的工具提示。“axis”显示轴列的值，“all”显示所有列的值，“none”显示无工具提示。也可以提供一个字符串列表，表示要在工具提示中显示的列，这些列将与轴值一起显示。
scale: int | None
scale: int | None= None与相邻组件相比的相对大小。例如，如果组件 A 和 B 在一个 Row 中，A 的 scale 为 2，B 的 scale 为 1，则 A 的宽度将是 B 的两倍。应为整数。scale 适用于 Rows，以及 Blocks 中 fill_height=True 的顶级组件。
min_width: int
min_width: int= 160最小像素宽度，如果屏幕空间不足以满足此值，则会换行。如果某个 scale 值导致此组件比 min_width 窄，则将首先考虑 min_width 参数。
every: Timer | float | None
every: Timer | float | None= None持续调用 `value` 来重新计算它（如果 `value` 是一个函数，否则无效）。可以提供一个 Timer，其滴答声会重置 `value`，或者提供一个浮点数来为重置 Timer 提供常规间隔。
inputs: Component | list[Component] | Set[Component] | None
inputs: Component | list[Component] | Set[Component] | None= None用作计算 `value` 的输入的组件（如果 `value` 是一个函数，否则无效）。`value` 在输入更改时会重新计算。
buttons: list[Literal['fullscreen', 'export'] | Button] | None
buttons: list[Literal['fullscreen', 'export'] | Button] | None= None要为组件显示的按钮列表。有效选项为“fullscreen”、“export”，或 gr.Button() 实例。“fullscreen”按钮允许用户全屏查看图表。“export”按钮允许用户将当前图表视图导出并下载为 PNG 图像。自定义的 gr.Button() 实例将显示在工具栏中，并带有其配置的图标和/或标签，单击它们将触发在按钮上注册的任何 .click() 事件。默认情况下，不显示任何按钮。
快捷方式
gradio.BarPlot
gradio.BarPlot"barplot"演示
事件监听器
描述
事件监听器允许您响应 Gradio Blocks 应用中定义的 UI 组件的用户交互。当用户与元素交互时（例如，更改滑块值或上传图像），会调用一个函数。
支持的事件监听器
BarPlot 组件支持以下事件监听器。每个事件监听器都接受相同的参数，这些参数在下表 事件参数 中列出。
BarPlot.select(fn, ···)
BarPlot.select(fn, ···)当用户选择或取消选择 NativePlot 时的事件监听器。使用事件数据 gradio.SelectData 来传递 value 指代 NativePlot 的标签，以及 selected 指代 NativePlot 的状态。有关更多详细信息，请参阅 https://gradio.org.cn/docs/gradio/eventdata。
BarPlot.double_click(fn, ···)
BarPlot.double_click(fn, ···)NativePlot 双击时触发。
事件参数
fn: Callable | None | Literal['decorator']
fn: Callable | None | Literal['decorator']= "decorator"当此事件触发时调用的函数。通常是机器学习模型的预测函数。函数的每个参数对应一个输入组件，函数应返回一个单一值或一个值元组，元组中的每个元素对应一个输出组件。
inputs: Component | BlockContext | list[Component | BlockContext] | Set[Component | BlockContext] | None
inputs: Component | BlockContext | list[Component | BlockContext] | Set[Component | BlockContext] | None= None用作输入的 gradio.components 列表。如果函数不接受输入，则此列表应为空。
outputs: Component | BlockContext | list[Component | BlockContext] | Set[Component | BlockContext] | None
outputs: Component | BlockContext | list[Component | BlockContext] | Set[Component | BlockContext] | None= None用作输出的 gradio.components 列表。如果函数不返回输出，则此列表应为空。
api_name: str | None
api_name: str | None= None定义该端点在 API 文档中如何显示。可以是字符串或 None。如果设置为字符串，则该端点将在 API 文档中以给定名称显示。如果为 None（默认），则使用函数的名称作为 API 端点。
api_description: str | None | Literal[False]
api_description: str | None | Literal[False]= NoneAPI 端点的描述。可以是字符串、None 或 False。如果设置为字符串，则该端点将在 API 文档中以给定描述显示。如果为 None，则使用函数的 docstring 作为 API 端点描述。如果为 False，则 API 文档中不会显示任何描述。
show_progress: Literal['full', 'minimal', 'hidden']
show_progress: Literal['full', 'minimal', 'hidden']= "full"事件运行时如何显示进度动画：“full”显示一个覆盖输出组件区域的加载指示器，并在右上角显示运行时信息，“minimal”仅显示运行时信息，“hidden”不显示任何进度动画。
show_progress_on: Component | list[Component] | None
show_progress_on: Component | list[Component] | None= None用于显示进度动画的组件或组件列表。如果为 None，则进度动画将显示在所有输出组件上。
queue: bool
queue: bool= True如果为 True，则会将请求放在队列中（如果队列已启用）。如果为 False，则不会将此事件放入队列，即使队列已启用。如果为 None，则将使用 Gradio 应用的队列设置。
batch: bool
batch: bool= False如果为 True，则函数应处理一批输入，这意味着它应该为每个参数接受一个输入值列表。列表的长度应相同（最多为 `max_batch_size`）。然后，该函数*必须*返回一个元组的列表（即使只有一个输出组件），元组中的每个列表对应一个输出组件。
preprocess: bool
preprocess: bool= True如果为 False，则在运行 'fn' 之前不会进行组件数据预处理（例如，当使用 `Image` 组件调用此方法时，将其保留为 base64 字符串）。
cancels: dict[str, Any] | list[dict[str, Any]] | None
cancels: dict[str, Any] | list[dict[str, Any]] | None= None取消其他事件的列表，当此监听器触发时。例如，设置 cancels=[click_event] 将会取消 click_event，其中 click_event 是另一个组件的 .click 方法的返回值。尚未运行的函数（或正在迭代的生成器）将被取消，但正在运行的函数将被允许完成。
trigger_mode: Literal['once', 'multiple', 'always_last'] | None
trigger_mode: Literal['once', 'multiple', 'always_last'] | None= None如果设置为 "once"（除 `.change()` 之外所有事件的默认值），则在事件挂起时不允许任何提交。如果设置为 "multiple"，则在事件挂起时允许无限次提交，而 "always_last"（`.change()` 和 `.key_up()` 事件的默认值）则允许在挂起事件完成后进行第二次提交。
js: str | Literal[True] | None
js: str | Literal[True] | None= None在运行 'fn' 之前运行可选的前端 JS 方法。JS 方法的输入参数是 'inputs' 和 'outputs' 的值，返回值应为输出组件的值列表。
concurrency_limit: int | None | Literal['default']
concurrency_limit: int | None | Literal['default']= "default"如果设置，这是可以同时运行的此事件的最大数量。可以设置为 None，表示没有并发限制（此事件可以同时运行任意数量）。设置为 "default" 可使用 `Blocks.queue()` 中的 `default_concurrency_limit` 参数定义的默认并发限制（该参数本身默认为 1）。
concurrency_id: str | None
concurrency_id: str | None= None如果设置，这是并发组的 ID。具有相同 `concurrency_id` 的事件将受到最低设置的 `concurrency_limit` 的限制。
api_visibility: Literal['public', 'private', 'undocumented']
api_visibility: Literal['public', 'private', 'undocumented']= "public"控制此端点的可见性和可访问性。可以是 "public"（在 API 文档中显示并可由客户端调用）、"private"（在 API 文档中隐藏，不可由客户端调用）或 "undocumented"（在 API 文档中隐藏，但可由客户端通过 gr.load 调用）。如果 fn 为 None，则 api_visibility 将自动设置为 "private"。