1. Blocks 布局
  2. 列

刚开始使用 Gradio？ 从这里开始： 入门指南

查看 发布历史

←

手风琴

组

→

列

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 | Literal['hidden']
默认 = 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 中被保留（如果它们已被用户或事件监听器更改），而不是根据构造函数中提供的值进行重渲染。

←

手风琴

组

→
gradio