跳到主要内容

控件参考

Flet UI 由控件组成。控件组织成层次结构或树形结构,其中每个控件都有一个父控件(除了 Page), 而容器控件 like ColumnDropdown 可以包含子控件,例如:

Page
├─ TextField
├─ Dropdown
│ ├─ Option
│ └─ Option
└─ Row
├─ ElevatedButton
└─ ElevatedButton

控件库 live 演示

按类别组织的控件

通用控件属性

Flet 控件具有以下属性:

adaptive

adaptive 属性可以在以下情况下指定:

  • 控件具有匹配的 Cupertino 控件,具有类似的功能和图形,如 iOS/macOS 上所期望的那样。在这种情况下,如果 adaptiveTrue,则根据目标平台创建 Material 或 Cupertino 控件。

这些控件具有 Cupertino 类似控件和 adaptive 属性:

以下容器控件具有 adaptive 属性:

bottom

仅在 Stack 中生效。子控件的底部边缘与栈的底部之间的距离。

data

可以附加到控件的任意数据。

disabled

每个控件都具有 disabled 属性, 默认值为 False,表示控件和所有子控件都是启用的。 disabled 属性主要用于数据输入控件,如 TextFieldDropdownCheckbox、按钮。 然而,disabled 也可以设置为父控件,并将其值传递给所有子控件递归。

例如,如果您有一个带有多个输入控件的表单,可以通过禁用容器来禁用它们:

c = ft.Column(controls=[
ft.TextField(),
ft.TextField()
])
c.disabled = True
page.add(c)

expand

当将子控件放入 ColumnRow 中时,可以“expand”它以填充可用空间。expand 属性可以是布尔值(True - 将控件扩展到填充所有可用空间)或整数 - 指定如何将自由空间与其他扩展子控件分配。

有关 expand 属性的更多信息和示例,请参阅 ColumnRow 的“Expanding children”部分。

expand_loose

仅在 expandTrue 时生效。

如果 expand_looseTrue,则 ColumnRow 的子控件将被授予在主轴(例如,Row 的水平方向或 Column 的垂直方向)上扩展以填充可用空间的灵活性,但不需要填充可用空间。

默认值为 False

以下是将容器放入 Row 中的示例,expand_loose = True

import flet as ft


class Message(ft.Container):
def __init__(self, author, body):
super().__init__()
self.content = ft.Column(
controls=[
ft.Text(author, weight=ft.FontWeight.BOLD),
ft.Text(body),
],
)
self.border = ft.border.all(1, ft.colors.BLACK)
self.border_radius = ft.border_radius.all(10)
self.bgcolor = ft.colors.GREEN_200
self.padding = 10
self.expand = True
self.expand_loose = True


def main(page: ft.Page):
chat = ft.ListView(
padding=10,
spacing=10,
controls=[
ft.Row(
alignment=ft.MainAxisAlignment.START,
controls=[
Message(
author="John",
body="Hi, how are you?",
),
],
),
ft.Row(
alignment=ft.MainAxisAlignment.END,
controls=[
Message(
author="Jake",
body="Hi I am good thanks, how about you?",
),
],
),
ft.Row(
alignment=ft.MainAxisAlignment.START,
controls=[
Message(
author="John",
body="Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum has been the industry's standard dummy text ever since the 1500s, when an unknown printer took a galley of type and scrambled it to make a type specimen book.",
),
],
),
ft.Row(
alignment=ft.MainAxisAlignment.END,
controls=[
Message(
author="Jake",
body="Thank you!",
),
],
),
],
)

page.window.width = 393
page.window.height = 600
page.window.always_on_top = False

page.add(chat)


ft.app(target=main)

height

控件的高度,以虚拟像素为单位。

parent

指向此控件的直接祖先(父级)。

它默认为 None,并且只有在将此控件挂载(添加到页面树)时才会有值。

Page 控件(它是树的根)是个例外 - 它始终具有 parent=None

left

仅在 Stack 中生效。子控件的左边缘与栈的左边缘之间的距离。

仅在 Stack 中生效。子控件的右边缘与栈的右边缘之间的距离。

top

仅在 Stack 中生效。子控件的顶部边缘与栈的顶部之间的距离。

visible

每个控件都具有 visible 属性, 默认值为 True,表示控件将被渲染在页面上。将 visible 设置为 False 将完全防止控件(及其所有子控件)被渲染在页面画布上。隐藏的控件不能被聚焦或选择,不能发出任何事件。

width

控件的宽度,以虚拟像素为单位。

变换

offset

在绘制控件之前应用平移变换。

transform.Offset这是一个相对于控件大小缩放的偏移量。例如,一个 Offsetx 值为 0.25 将导致水平方向的一半控件宽度的平移。

以下示例在栈的左上角显示容器,因为变换应用了 -1 * 100, -1 * 100offset * control_size)的水平和垂直平移:

import flet as ft

def main(page: ft.Page):

page.add(
ft.Stack(
[
ft.Container(
bgcolor="red",
width=100,
height=100,
left=100,
top=100,
offset=ft.transform.Offset(-1, -1),
)
],
width=1000,
height=1000,
)
)

ft.app(target=main)

opacity

使控件部分透明。0.0 - 控件完全透明,不绘制。1.0(默认) - 控件完全绘制,没有透明度。

rotate

使用围绕中心的旋转来变换控件。

rotate 属性的值可以是以下几种类型之一:

  • number - 以顺时针方向旋转的弧度数。完整的圆 360°math.pi * 2 弧度,90°pi / 245°pi / 4,等等。
  • transform.Rotate - 允许指定旋转的 angle 以及 alignment - 旋转中心的位置。

例如:

import flet as ft
import math
from flet.transform import Rotate

ft.Image(
src="https://picsum.photos/100/100",
width=100,
height=100,
border_radius=5,
rotate=Rotate(angle=0.25 * math.pi, alignment=ft.alignment.center_left)
)

scale

沿 2D 平面缩放控件。默认的缩放系数是 1.0 - 控件不缩放。0.5 - 控件缩小一倍,2.0 - 控件放大一倍。

可以为 xy 轴指定不同的缩放倍数,但要将 Control.scale 属性设置为 transform.Scale 类的实例:

from dataclasses import field
import flet as ft
from flet.transform import Scale
from flet.alignment import Alignment

class Scale:
scale: float = field(default=None)
scale_x: float = field(default=None)
scale_y: float = field(default=None)
alignment: Alignment = field(default=None)

可以指定 scalescale_xscale_y,但不能同时指定,例如:

ft.Image(
src="https://picsum.photos/100/100",
width=100,
height=100,
border_radius=5,
scale=Scale(scale_x=2, scale_y=0.5)
)