Skip to main content

TextCapitalization

Configures how the platform keyboard will select an uppercase or lowercase keyboard.

Only supports text keyboards, other keyboard types will ignore this configuration. Capitalization is locale-aware.

Inherits: enum.Enum

Properties

  • CHARACTERS - Uppercase keyboard for each character.
  • NONE - Lowercase keyboard.
  • SENTENCES - Uppercase keyboard for the first letter of each sentence.
  • WORDS - Uppercase keyboard for the first letter of each word.

Examples​

Showcase​

import flet as ft


def showcase_card(cap: ft.TextCapitalization) -> ft.Container:
    field = ft.TextField(
        width=260,
        label="Type here",
        capitalization=cap,
        border=ft.InputBorder.OUTLINE,
    )

    return ft.Container(
        width=320,
        padding=12,
        border=ft.Border.all(1, ft.Colors.RED),
        border_radius=10,
        bgcolor=ft.Colors.SURFACE_CONTAINER_LOW,
        content=ft.Column(
            spacing=8,
            controls=[
                ft.Text(cap.name, weight=ft.FontWeight.BOLD),
                field,
            ],
        ),
    )


def main(page: ft.Page):
    page.horizontal_alignment = ft.CrossAxisAlignment.CENTER

    page.appbar = ft.AppBar(title="TextCapitalization Showcase")
    page.add(
        ft.SafeArea(
            content=ft.Column(
                controls=[
                    ft.Text(
                        "Compare keyboard capitalization preferences for text fields."
                    ),
                    ft.Row(
                        wrap=True,
                        spacing=12,
                        expand=True,
                        scroll=ft.ScrollMode.AUTO,
                        alignment=ft.MainAxisAlignment.CENTER,
                        controls=[showcase_card(c) for c in ft.TextCapitalization],
                    ),
                ],
            ),
        )
    )


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

Properties​

CHARACTERSclass-attributeinstance-attribute​

Uppercase keyboard for each character.

Info

Corresponds to InputType.TYPE_TEXT_FLAG_CAP_CHARACTERS on Android, and UITextAutocapitalizationTypeAllCharacters on iOS.

NONEclass-attributeinstance-attribute​

Lowercase keyboard.

SENTENCESclass-attributeinstance-attribute​

Uppercase keyboard for the first letter of each sentence.

Info

Corresponds to InputType.TYPE_TEXT_FLAG_CAP_SENTENCES on Android, and UITextAutocapitalizationTypeSentences on iOS.

WORDSclass-attributeinstance-attribute​

Uppercase keyboard for the first letter of each word.

Info

Corresponds to InputType.TYPE_TEXT_FLAG_CAP_WORDS on Android, and UITextAutocapitalizationTypeWords on iOS.