跳到主要内容

自动完成

帮助用户通过输入一些文本并从建议列表中选择来进行选择。

示例​

在线示例

基本示例​

import flet as ft

def main(page: ft.Page):
    page.add(
        ft.AutoComplete(
            suggestions=[
                ft.AutoCompleteSuggestion(key="one 1", value="One"),
                ft.AutoCompleteSuggestion(key="two 2", value="Two"),
                ft.AutoCompleteSuggestion(key="three 3", value="Three"),
            ],
            on_select=lambda e: print(e.control.selected_index, e.selection),
        )
    )

ft.app(target=main)

属性​

selected_index​

选中建议的索引。

该属性为只读属性，在初始化时为 None，直到第一次选中建议。

值的类型为 int。

suggestions​

一个包含 AutoCompleteSuggestion 控件的列表，代表要显示的建议。

注意:

  • 内部的建议过滤过程（基于 key 的比较）是大小写不敏感的，因为比较是在小写中进行的。
  • 一个有效的 AutoCompleteSuggestion 必须至少有一个 key 或 value 指定，否则将被忽略。如果只提供 key，则 value 将被设置为 key 作为后备，反之亦然。

suggestions_max_height​

建议列表的最大可视高度。

值的类型为 OptionalNumber，默认值为 200。

事件​

on_select​

当选中建议时触发。

事件处理函数的类型为 AutoCompleteSelectEvent。