Python/Kivy技术问询：如何让TreeView搜索功能支持子节点？

我明白你遇到的困扰了——当前的搜索过滤只检查父节点的文本，导致子节点即使匹配搜索关键词，只要父节点不匹配就会被连带隐藏。要让搜索同时支持子节点，我们需要修改过滤逻辑，递归检查每个节点及其所有后代是否匹配，并且确保匹配节点的父节点会被自动展开显示。

下面是具体的实现步骤和代码修改：

1. 编写递归匹配辅助函数 #

先创建一个函数，用来检查某个节点或它的任意子节点是否包含搜索文本：

def has_matching_descendant(self, node, search_text):
    # 先检查当前节点是否匹配（大小写不敏感）
    if search_text.lower() in node.text.lower():
        return True
    # 递归遍历所有子节点，只要有一个匹配就返回True
    for child_node in node.nodes:
        if self.has_matching_descendant(child_node, search_text):
            return True
    return False

2. 实现带递归检查的过滤逻辑 #

接下来编写主过滤函数，它会遍历所有节点，根据递归匹配结果设置可见性，同时自动展开匹配节点的父节点：

def update_tree_filter(self, search_text):
    # 先重置所有节点的可见性和折叠状态，避免残留之前的过滤结果
    for node in self.tree_view.iterate_all_nodes():
        node.is_visible = False
        node.collapse()

    # 遍历所有根节点，检查是否有匹配的后代分支
    for root_node in self.tree_view.root.nodes:
        if self.has_matching_descendant(root_node, search_text):
            root_node.is_visible = True
            # 递归展开所有包含匹配节点的父节点
            self.expand_relevant_nodes(root_node, search_text)

def expand_relevant_nodes(self, node, search_text):
    # 如果当前节点匹配，直接展开
    if search_text.lower() in node.text.lower():
        node.expand()
    # 检查子节点：只要子节点有匹配项，就展开当前父节点并继续递归处理子节点
    for child_node in node.nodes:
        if self.has_matching_descendant(child_node, search_text):
            child_node.is_visible = True
            node.expand()  # 展开父节点，确保子节点能被看到
            self.expand_relevant_nodes(child_node, search_text)

3. 绑定过滤输入框的事件 #

把过滤函数绑定到你的搜索TextInput的text属性变化事件上，确保输入时实时更新过滤结果：

class YourScreen(Screen):
    def __init__(self, **kwargs):
        super(YourScreen, self).__init__(**kwargs)
        # 假设你的TreeView和过滤输入框的id分别是tree_view和filter_input
        self.tree_view = self.ids.tree_view
        self.filter_input = self.ids.filter_input
        # 绑定文本变化事件，触发过滤
        self.filter_input.bind(text=self.on_filter_text)

    def on_filter_text(self, instance, new_text):
        # 去除输入文本首尾空格后执行过滤
        self.update_tree_filter(new_text.strip())

    # 将上面的has_matching_descendant、update_tree_filter、expand_relevant_nodes函数放在这里

为什么这个方法有效？ #

• 递归检查确保了只要某个节点或它的任意子节点匹配搜索词，整个分支都会被保留，不会因为父节点不匹配而隐藏子节点。
• expand_relevant_nodes函数会自动展开所有包含匹配节点的父节点，让用户能直接看到匹配的子节点，不需要手动展开。
• 每次过滤前重置节点状态，避免之前的过滤结果残留影响新的搜索。

这样修改后，当你输入"R"时，只要"Reserves & Surplus"这个子节点匹配，它的父节点会自动显示并展开，你就能看到这个子节点了。

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