Flet中文文档

主题

Divider 继承自：Control, BaseControl

一条细的水平线（分隔线），两侧带有内边距。

python
ft.Column(
    width=240,
    spacing=10,
    controls=[
        ft.Text("Section A", weight=ft.FontWeight.W_600),
        ft.Divider(),
        ft.Text("Section B"),
    ],
)

示例 ​

python
import flet as ft


def main(page: ft.Page):
    page.add(
        ft.SafeArea(
            expand=True,
            content=ft.Column(
                spacing=0,
                expand=True,
                controls=[
                    ft.Container(
                        expand=True,
                        bgcolor=ft.Colors.AMBER,
                        alignment=ft.Alignment.CENTER,
                    ),
                    ft.Divider(),
                    ft.Container(
                        expand=True,
                        bgcolor=ft.Colors.PINK,
                        alignment=ft.Alignment.CENTER,
                    ),
                    ft.Divider(height=1, color=ft.Colors.WHITE),
                    ft.Container(
                        expand=True,
                        bgcolor=ft.Colors.BLUE_300,
                        alignment=ft.Alignment.CENTER,
                    ),
                    ft.Divider(height=9, thickness=3),
                    ft.Container(
                        expand=True,
                        bgcolor=ft.Colors.DEEP_PURPLE_200,
                        alignment=ft.Alignment.CENTER,
                    ),
                ],
            ),
        )
    )


if __name__ == "__main__":
    ft.run(main)
基础

属性 ​

名称类型默认值说明
colorOptional[ColorValue]None绘制线条时使用的颜色。 如果为 None，则使用 color。
heightAnnotated[Optional[Number], V.ge(0)]None分隔线的高度范围。分隔线本身始终绘制为一条水平线，并在此值指定的高度内居中。 如果为 None，则使用 space。如果它也为 None，默认为 16.0。 抛出异常： ValueError：如果 height 为负。
leading_indentAnnotated[Optional[Number], V.ge(0)]None分隔线起始边留出的空白量。 如果为 None，则使用 leading_indent。如果它也为 None，默认为 0.0。 抛出异常： ValueError：如果它不大于或等于 0。
thicknessAnnotated[Optional[Number], V.ge(0)]None在分隔线内绘制线条的粗细。 粗细为 0.0 的分隔线始终绘制为高度恰好为一个设备像素的线。 如果为 None，则使用 thickness。如果它也为 None，默认为 0.0。 抛出异常： ValueError：如果 thickness 为负。
trailing_indentAnnotated[Optional[Number], V.ge(0)]None分隔线末尾边留出的空白量。 如果为 None，则使用 trailing_indent。如果它也为 None，默认为 0.0。 抛出异常： ValueError：如果它不大于或等于 0。
radiusOptional[BorderRadiusValue]None分隔线的边框圆角。
expandAnnotated[Optional[Union[bool, int]], V.instance_of((bool, int))]None指定此控件是否／如何扩展以填满父布局中的可用空间。 更多信息见此处。 注意： 仅当此控件的直接父级是以下控件或其子类时才生效：Column、Row、View、Page。 抛出异常： ValueError：如果它不是 bool 或 int 类型。
expand_looseboolFalse允许控件在主轴方向有可用空间时扩展，但不要求它填满所有可用空间。 更多信息见此处。 注意： 如果 expand_loose 为 True，则仅在以下条件满足时才生效： - expand 不为 None，且 - 此控件的直接父级是以下控件或其子类之一：Column、Row、View、Page。
colResponsiveNumber12如果此控件的父级是 ResponsiveRow，则此属性决定该控件在屏幕上跨越多少虚拟列。 可以是一个数字，也可以是一个按断点配置不同值的字典，例如 col={"sm": 6}。 值为 0 时会在该断点隐藏控件，因此它不会占用父级 ResponsiveRow 中的任何列。 此控件默认跨越 12 个虚拟列。 | 断点 | 尺寸 | |---|---| | xs | <576px | | sm | ≥576px | | md | ≥768px | | lg | ≥992px | | xl | ≥1200px | | xxl | ≥1400px |
opacityAnnotated[Number, V.between(0.0, 1.0)]1.0定义控件的透明度。 取值范围从 0.0（完全透明）到 1.0（完全不透明，无任何透明感）。 抛出异常： ValueError：如果它不在 0.0 到 1.0（含）之间。
tooltipOptional[TooltipValue]None鼠标悬停在此控件上时显示的工具提示。
badgeOptional[BadgeValue]None显示在此控件顶部的徽章。
visibleboolTrue每个控件都有 visible 属性，默认为 True —— 控件会渲染在页面上。将 visible 设为 False 会彻底阻止控件（及其所有子控件，如果有）渲染到页面画布上。隐藏的控件无法通过键盘或鼠标获得焦点或选中，也不会触发任何事件。
disabledboolFalse每个控件都有 disabled 属性，默认为 False —— 控件及其所有子控件都处于启用状态。 注意： 此属性的值会递归向下传播到所有子控件。 示例： 例如，如果你有一个包含多个输入控件的表单，可以通过禁用容器来一并禁用它们： python ft.Column( disabled = True, controls=[ ft.TextField(), ft.TextField() ] )
rtlboolFalse控件的文本方向是否为从右到左（RTL）。
dataAnyskip_任意类型的自定义数据。
keyOptional['KeyValue']None用于在更新之间保持控件标识稳定的键。

只读属性 ​

名称类型默认值说明
parentOptional['BaseControl']—此控件的直接祖先（父级）。 默认为 None，只有在此控件被挂载（加入页面树）后才有值。 Page 控件（页面树的根）是个例外 —— 它的 parent 始终为 None。
page'Page'—此控件所属的页面。

方法 ​

名称类型默认值说明
is_isolated——返回此控件是否被标记为隔离。 隔离控件会被排除在父级驱动的更新遍历之外，并需要自行管理更新边界。
init——在控件实例初始化之后、首次 build / update 周期之前调用。 重写此钩子以执行依赖已初始化字段的轻量级设置。不要在此处调用 update()。
build——在控件初始化期间调用一次，用于定义其子控件。在此方法中 page 属性可用。
before_update——每当此控件被更新时都会调用此方法。 注意： 务必不要在此处调用或请求 update()。
before_event——在事件处理器执行之前拦截事件。 返回 False 可取消分发。返回 True 或 None 则继续正常的事件处理。
did_mount——在控件挂载到页面树之后调用。 重写此方法以启动需要已挂载页面的资源，例如订阅、定时器或服务监听器。
will_unmount——在控件从页面树移除之前调用。 重写此方法以释放 did_mount() 中创建的资源，例如订阅、定时器或外部句柄。
get_data_channel——解析为此 widget 在 Dart 侧分配的 [DataChannel]。模式： on_data_channel_open: Optional[ft.EventHandler[DataChannelOpenEvent]] = None def init(self): self.on_data_channel_open = self._on_open def _on_open(self, e): self._channel = self.get_data_channel(e.channel_id) 幂等 —— 底层的 Connection 会按 id 缓存 DataChannel，因此重复调用会返回同一实例。没有错误路径：该 id 始终来自框架触发的事件，所以当此方法运行时，通道在两端都已存在。
updateNone—为此控件请求一次 UI 更新。 在更改控件状态或属性后调用。控件必须已挂载到页面且未被标记为冻结。

关注我，学习大模型、大数据、Python等热门技术。

footer-banner