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

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.theme_mode = ft.ThemeMode.DARK
    page.horizontal_alignment = ft.CrossAxisAlignment.CENTER

    page.appbar = ft.AppBar(title="TextCapitalization Showcase")
    page.add(
        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],
        ),
    )


ft.run(main)

Properties

CHARACTERS = 'characters' class-attribute instance-attribute

Uppercase keyboard for each character.

Info

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

NONE = 'none' class-attribute instance-attribute

Lowercase keyboard.

SENTENCES = 'sentences' class-attribute instance-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.

WORDS = 'words' class-attribute instance-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.