如何使用Python Textual框架实现多行输入

问题根源 #

Textual的Input组件是为单行输入设计的，其内部渲染逻辑不会处理文本中的换行符，所以即使手动添加\n、设置height或overflow样式，也无法实现自动换行和多行显示。

方案1：使用官方TextArea组件（推荐） #

Textual提供了专门用于多行文本输入的TextArea组件，原生支持换行、光标移动、滚动等完整功能，无需自定义：

from textual.app import App
from textual.widgets import TextArea

class Minimal(App):
    def compose(self):
        # 设置height为4行，支持自动换行和多行输入
        yield TextArea(id="input", height=4)

if __name__ == "__main__":
    app = Minimal()
    app.run()

方案2：自定义支持多行的Input子类 #

如果必须基于Input扩展，需要重写其render方法，手动处理换行符的渲染逻辑：

from textual.app import App
from textual.binding import Binding
from textual.widgets import Input
from textual.renderables import RichRenderableType
from rich.text import Text

class MultiLineInput(Input):
    BINDINGS = [Binding("enter", "newline", "New line", show=True)]

    def action_newline(self):
        self.value += "\n"
        self.cursor_position = len(self.value)

    def on_mount(self):
        self.styles.height = 4

    def render(self) -> RichRenderableType:
        # 将文本按换行符分割为多行
        lines = self.value.split("\n")
        # 只保留当前高度能容纳的行数
        visible_lines = lines[:self.styles.height.value]
        # 拼接为带换行的Text对象进行渲染
        return Text("\n".join(visible_lines))

class Minimal(App):
    def compose(self):
        yield MultiLineInput(id="input")

if __name__ == "__main__":
    app = Minimal()
    app.run()

注意：自定义方案的光标跨行移动等逻辑还不完善，如果需要完整的多行输入体验，优先选择官方TextArea组件。

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