Gradio Agents & MCP 黑客马拉松

获奖者
Gradio logo
  1. Blocks 布局
  2. Column

Gradio 新手？从这里开始： 入门

查看 发布历史

←

Accordion

Group

→

Column

gradio.Column(···)

描述

Column 是 Blocks 中的一个布局元素，它垂直渲染所有子元素。列的宽度可以通过 scale 和 min_width 参数设置。如果某个比例导致列的宽度小于 min_width，则 min_width 参数将优先。

使用示例

with gr.Blocks() as demo:
    with gr.Row():
        with gr.Column(scale=1):
            text1 = gr.Textbox()
            text2 = gr.Textbox()
        with gr.Column(scale=4):
            btn1 = gr.Button("Button 1")
            btn2 = gr.Button("Button 2")

初始化

参数
🔗 
scale: int
默认值 = 1

相对于相邻 Column 的相对宽度。例如，如果 Column A 的 scale=2，Column B 的 scale=1，那么 A 的宽度将是 B 的两倍。

🔗 
min_width: int
默认值 = 320

Column 的最小像素宽度，如果屏幕空间不足以满足此值，则会换行。如果某个 scale 值导致列的宽度小于 min_width，则 min_width 参数将首先被遵守。

🔗 
variant: Literal['default', 'panel', 'compact']
默认值 = "default"

列类型，'default'（无背景），'panel'（灰色背景和圆角），或 'compact'（圆角且无内部间隙）。

🔗 
visible: bool
默认值 = True

如果为 False，列将被隐藏。

🔗 
elem_id: str | None
默认值 = None

一个可选字符串，作为此组件在 HTML DOM 中的 id。可用于 CSS 样式定位。

🔗 
elem_classes: list[str] | str | None
默认值 = None

一个可选字符串或字符串列表，作为此组件在 HTML DOM 中的 class。可用于 CSS 样式定位。

🔗 
render: bool
默认值 = True

如果为 False，组件将不会在 Blocks 上下文中渲染。当意图是现在分配事件监听器但稍后渲染组件时应使用此参数。

🔗 
show_progress: bool
默认值 = False

如果为 True，更新时显示进度动画。

🔗 
key: int | str | tuple[int | str, ...] | None
默认值 = None

在 `gr.render` 中，跨重新渲染具有相同键的组件被视为同一组件，而不是新组件。在重新渲染时，'preserved_by_key' 中设置的属性不会被重置。

🔗 
preserved_by_key: list[str] | str | None
默认值 = None

此组件构造函数中的参数列表。在 `gr.render()` 函数内部，如果组件使用相同的键重新渲染，则这些（且仅这些）参数将在 UI 中保留（如果它们已被用户或事件监听器更改），而不是根据构造函数中提供的值重新渲染。

指南

控制布局

←

Accordion

Group

→