跳到主要内容

文本主题

用于自定义 Text 的样式。

Material 3 设计 定义 了 5 组文本样式，每组包含 3 种尺寸：“展示”、“标题”、“主题”、“标签”和“正文”，这些样式在 Flet 控件中广泛使用。

TextTheme 类具有以下属性：

body_large​

正文样式中最大的一种。正文样式用于较长的文本段落。

值的类型为 TextStyle。

body_medium​

正文样式的中等尺寸。正文样式用于较长的文本段落。这是 Material 的默认文本样式。

值的类型为 TextStyle。

body_small​

正文样式中最小的一种。

值的类型为 TextStyle。

display_large​

展示样式中最大的一种。作为屏幕上最大的文本，展示样式用于简短、重要的文本或数字。它们在大屏幕上效果最佳。

值的类型为 TextStyle。

display_medium​

展示样式的中等尺寸。

值的类型为 TextStyle。

display_small​

展示样式中最小的一种。

值的类型为 TextStyle。

headline_large​

标题样式中最大的一种。标题样式比展示样式小。它们最适合在较小屏幕上用于简短、强调程度高的文本。

值的类型为 TextStyle。

  • headline_medium - 标题样式的中等尺寸。
  • headline_small - 标题样式中最小的一种。

值的类型为 TextStyle。

label_large​

标签样式中最大的一种。标签样式是较小的、实用的样式，用于 UI 的某些区域，例如组件内部的文本或内容主体中非常小的辅助文本，如说明文字。用于 ElevatedButton、TextButton 和 OutlinedButton 上的文本。

label_medium​

标签样式的中等尺寸。

值的类型为 TextStyle。

label_small​

标签样式中最小的一种。

值的类型为 TextStyle。

title_large​

主题样式中最大的一种。主题样式比标题样式小，应用于较短、强调程度中等的文本。

值的类型为 TextStyle。

title_medium​

主题样式的中等尺寸。

值的类型为 TextStyle。

title_small​

主题样式中最小的一种。

值的类型为 TextStyle。

示例​

import flet as ft

def main(page: ft.Page):
    page.theme = ft.Theme(
        text_theme=ft.TextTheme(body_medium=ft.TextStyle(color=ft.Colors.GREEN))
    )

    page.add(ft.Text("Hello, green world!"))  # 默认情况下，文本使用正文中等样式

ft.app(main)