python-prompt-toolkit中如何为TextArea添加PageUp/PageDown翻页快捷键绑定

前置配置：启用TextArea滚动条能力 #

calculator示例中，输出文本区域的初始化代码原本为：
output_field = TextArea(style="class:output-field", text=help_text)
此时运行效果为无滚动条状态，超长内容无法滚动查看：

只要给TextArea初始化参数追加scrollbar=True配置，即可启用支持鼠标滚轮交互的滚动条：
output_field = TextArea(style="class:output-field", text=help_text, scrollbar=True)
配置完成后的运行效果如下：

自定义翻页快捷键实现 #

TextArea组件本身已内置适配组件可视高度的按页滚动方法，不需要手动计算滚动偏移量，直接调用对应方法即可实现翻页效果。

必须保证快捷键回调能访问到已经完成实例化的output_field对象，不要把output_field定义在回调函数的局部作用域里，否则会触发变量未定义的报错。

补全后的快捷键代码如下：

# 快捷键绑定定义
kb = KeyBindings()

@kb.add("pageup")
def _(event):
    # 向上滚动一页
    output_field.scroll_page_up()

@kb.add("pagedown")
def _(event):
    # 向下滚动一页
    output_field.scroll_page_down()

适配优化说明 #

• 上述两个内置翻页方法会自动匹配TextArea的可视高度，计算单次翻页对应的滚动行数，滚动到文本顶部/底部边界时会自动停止，不会出现偏移量越界的问题
• 如果界面同时存在多个可滚动的TextArea组件，可增加焦点判断逻辑，仅当输出文本区获得焦点时才触发翻页，避免和输入框的默认快捷键冲突：

@kb.add("pageup")
def _(event):
    if event.app.layout.has_focus(output_field):
        output_field.scroll_page_up()

• 最后只需将自定义的kb实例在创建应用对象时传入，和示例原有界面逻辑合并即可，不需要改动原有布局、样式的代码。

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