VerticalDivider 继承自： Control, BaseControl

一条细的竖线，两侧留有内边距。

在 Material Design 设计语言中，这表示一条分隔线。

Example:

ft.Row(
    width=120,
    height=60,
    expand=True,
    spacing=0,
    controls=[
        ft.Container(
            bgcolor=ft.Colors.BLUE_GREY_200,
            alignment=ft.Alignment.CENTER,
            expand=True,
        ),
        ft.VerticalDivider(),
        ft.Container(
            bgcolor=ft.Colors.GREY_500,
            alignment=ft.Alignment.CENTER,
            expand=True,
        ),
    ],
)

示例

import flet as ft


def main(page: ft.Page):
    page.add(
        ft.SafeArea(
            content=ft.Row(
                width=180,
                height=100,
                spacing=0,
                controls=[
                    ft.Container(
                        bgcolor=ft.Colors.ORANGE_300,
                        alignment=ft.Alignment.CENTER,
                        expand=True,
                    ),
                    ft.VerticalDivider(),
                    ft.Container(
                        bgcolor=ft.Colors.BROWN_400,
                        alignment=ft.Alignment.CENTER,
                        expand=True,
                    ),
                    ft.VerticalDivider(width=1, color=ft.Colors.WHITE),
                    ft.Container(
                        bgcolor=ft.Colors.BLUE_300,
                        alignment=ft.Alignment.CENTER,
                        expand=True,
                    ),
                    ft.VerticalDivider(width=9, thickness=3),
                    ft.Container(
                        bgcolor=ft.Colors.GREEN_300,
                        alignment=ft.Alignment.CENTER,
                        expand=True,
                    ),
                ],
            ),
        )
    )


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

属性

名称	类型	默认值	说明
width	Annotated[Optional[Number], V.ge(0)]	None	The divider's width. The divider itself is always drawn as a vertical line that is centered within the width specified by this value. If None, space is used. If that's is also None, defaults to 16.0. Raises: ValueError: If it is not greater than or equal to 0.
thickness	Annotated[Optional[Number], V.ge(0)]	None	The thickness of this divider. Note: A divider with a thickness of 0.0 is always drawn as a line with a width of exactly one device pixel. If None, thickness is used. If that's is also None, defaults to 0.0. Raises: ValueError: If it is not greater than or equal to 0.
color	Optional[ColorValue]	None	The color to use when painting the line. If None, color is used.
leading_indent	Annotated[Optional[Number], V.ge(0)]	None	The amount of empty space to the leading edge of the divider. If None, leading_indent is used. If that's is also None, defaults to 0.0. Raises: ValueError: If it is not greater than or equal to 0.
trailing_indent	Annotated[Optional[Number], V.ge(0)]	None	The amount of empty space to the trailing edge of the divider. If None, trailing_indent is used. If that's is also None, defaults to 0.0. Raises: ValueError: If it is not greater than or equal to 0.
radius	Optional[BorderRadiusValue]	None	The border radius of the divider.
expand	Annotated[Optional[Union[bool, int]], V.instance_of((bool, int))]	None	指定此控件是否/如何扩展以填充父布局中的可用空间。 详见 此处. Note: Has effect only if the direct parent of this control is one of the following controls, or their subclasses: Column, Row, View, Page. Raises: ValueError: If it is not of type bool or int.
expand_loose	bool	False	允许控件在主轴方向上有可用空间时扩展，但不要求填满所有可用空间。 详见 此处. Note: 若 expand_loose 为 True，则仅当同时满足以下条件时生效： - expand 不为 None，且 - the direct parent of this control is one of the following controls, or their subclasses: Column, Row, View, Page.
col	ResponsiveNumber	12	若此控件的父控件是 ResponsiveRow，此属性用于决定该控件横跨多少个虚拟列。 可以是数字，也可以是为不同断点配置不同值的字典，例如 col={"sm": 6}。 0 表示在该断点下隐藏控件，不占用任何列。 默认横跨 12 个虚拟列。 \
opacity	Annotated[Number, V.between(0.0, 1.0)]	1.0	定义控件的透明度，取值范围 0.0（完全透明）到 1.0（完全不透明）。 抛出异常：ValueError：若不在 0.0 到 1.0 的闭区间内。
tooltip	Optional[TooltipValue]	None	鼠标悬停时显示的 tooltip。
badge	Optional[BadgeValue]	None	显示在控件顶部的徽标。
visible	bool	True	Every control has visible property which is True by default - control is rendered on the page. Setting visible to False 完全阻止该控件（及其所有子控件）渲染到页面画布上. 隐藏的控件不能通过键盘或鼠标聚焦或选中，也不会触发任何事件。
disabled	bool	False	Every control has disabled property which is False by default - control and all its children are enabled. Note: The value of this property will be propagated down to all children controls recursively. Example: For example, if you have a form with multiple entry controls you can disable them all together by disabling container: python ft.Column( disabled = True, controls=[ ft.TextField(), ft.TextField() ] )
rtl	bool	False	控件的文字方向是否为从右到左（RTL）。
data	Any	skip_	任意类型的自定义数据。
key	Optional['KeyValue']	None	用于在更新之间保持控件身份稳定的 key。

只读属性

名称	类型	默认值	说明
parent	Optional['BaseControl']	—	The direct ancestor(parent) of this control. It defaults to None and will only have a value when this control is mounted (added to the page tree). Page 控件（树的根）为例外 —— 它始终 parent=None。
page	'Page'	—	此控件所属的页面。

方法

名称	类型	默认值	说明
is_isolated	—	—	Return whether this control is marked as isolated. 被隔离的控件不会参与父级驱动的更新遍历，需要自行管理更新边界。
init	—	—	Called after control instance initialization and before the first build / update cycle. 可重写此钩子执行依赖于已初始化字段的轻量设置。 不要在这里调用 update()。
build	—	—	在控件初始化期间调用一次，用于定义其子控件。 page 属性在此方法中可用。
before_update	—	—	每次控件即将更新时调用。 Note: 不要在此处调用 update()。
before_event	—	—	在事件处理器执行前拦截事件。 返回 False 取消分发，返回 True 或 None 则继续正常的事件处理。
did_mount	—	—	在控件挂载到页面树之后调用。 可重写以启动需要已挂载页面的资源，例如订阅、定时器或服务监听。
will_unmount	—	—	在控件从页面树移除之前调用。 可重写以释放 did_mount() 中创建的资源，例如订阅、定时器或外部句柄。
get_data_channel	—	—	Resolve the [DataChannel] allocated on the Dart side for this widget. Pattern: 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) Idempotent — the underlying Connection caches DataChannels by id, so repeated calls return the same instance. No error path: the id always comes from a framework-fired event, so by the time this runs the channel exists on both sides.
update	None	—	请求更新该控件的 UI。 在修改控件状态或属性后调用。 控件必须已挂载到页面，并且未被冻结。