如何在Flet中创建支持滚动且不换行的多行TextField？

要实现内容不自动换行、单行过长横向滚动、多行时垂直滚动的TextField，核心是利用Flet组件的几个关键属性，以下是两种可行方案：

方案一：直接配置TextField属性（推荐） #

通过设置TextField的内置属性即可快速实现需求，代码简洁：

import flet as ft

def main(page: ft.Page):
    # 配置多行TextField
    scrollable_textfield = ft.TextField(
        multiline=True,          # 开启多行输入模式
        wrap=False,              # 禁用自动换行，保持单行内容连续
        scrollable=True,         # 启用滚动功能
        width=400,               # 固定组件宽度，触发横向滚动的前提
        height=200,              # 固定组件高度，触发垂直滚动的前提
        hint_text="输入内容：单行过长横向滚动，多行时垂直滚动",
        border=ft.InputBorder.OUTLINE
    )
    page.add(scrollable_textfield)

if __name__ == "__main__":
    ft.app(target=main)

属性说明 #

• multiline=True：必须开启，否则无法支持多行输入和滚动
• wrap=False：核心设置，禁止文本自动换行，确保单行超长内容不会折行
• scrollable=True：让组件在内容超出可视区域时自动显示对应方向的滚动条
• 固定width/height：明确可视范围，触发滚动的必要条件；若需自适应页面，可替换为expand=True

方案二：用ScrollView包裹（灵活布局场景） #

如果需要更精细控制滚动行为（比如强制显示滚动条、适配复杂布局），可以将TextField放入ScrollView组件：

import flet as ft

def main(page: ft.Page):
    # 创建支持双向滚动的容器
    scroll_container = ft.ScrollView(
        scroll=ft.ScrollMode.BOTH,  # 同时允许水平、垂直滚动
        expand=True,                # 自适应页面剩余空间
        content=ft.TextField(
            multiline=True,
            wrap=False,
            expand=True,            # 占满ScrollView的可用空间
            hint_text="自适应布局下的滚动输入框",
            border=ft.InputBorder.OUTLINE
        )
    )
    page.add(scroll_container)

if __name__ == "__main__":
    ft.app(target=main)

适用场景 #

• 输入框需要自适应页面或父容器的尺寸
• 需要强制显示滚动条（可通过ScrollView的scrollbar_always_visible=True实现）
• 需在滚动容器中添加其他辅助组件

内容的提问来源于stack exchange，提问作者Alex