如何捕获Bokeh TextInput组件回调函数的返回结果？

嘿，我明白你现在的需求——想用TextInput的输入去查询数据库，然后把结果展示在MultiSelect里对吧？在Bokeh里，涉及数据库查询的场景肯定是用Bokeh Server，而Python端的回调不能直接通过return传递结果，而是要直接操作组件属性来更新界面。下面给你具体的解决方案：

核心思路 #

Bokeh的服务器回调是事件驱动的：当TextInput的值变化时触发db_query回调，你需要在这个回调里完成三件事：

1. 获取输入框的最新值
2. 执行数据库查询
3. 把查询结果转换成MultiSelect需要的格式，直接更新它的options属性

完整代码示例 #

假设你的数据库查询函数是your_db_query_function（替换成你自己的实际查询逻辑即可），下面是完整的组件构建和回调绑定代码：

from bokeh.models import TextInput, MultiSelect
from bokeh.layouts import column
from bokeh.plotting import curdoc

def SearchDisplay():
    # 创建输入框和结果展示的MultiSelect组件
    ask_fruit = TextInput(value="Enter fruit name...", title="搜索水果")
    fruit_results = MultiSelect(options=[], title="匹配的水果")

    def db_query(attr, old, new):
        # new参数就是TextInput的最新输入值
        # 1. 执行数据库查询
        query_result = your_db_query_function(new)
        
        # 2. 转换结果格式：MultiSelect的options支持两种格式
        # 这里用元组列表，第一个元素是实际值，第二个是显示标签（两者一致时也可以用纯字符串列表）
        formatted_results = [(fruit, fruit) for fruit in query_result]
        
        # 3. 直接更新MultiSelect的选项
        fruit_results.options = formatted_results

    # 绑定输入框的value变化事件到回调函数
    ask_fruit.on_change('value', db_query)
    
    # 返回组件布局
    return column(ask_fruit, fruit_results)

# 把组件添加到Bokeh文档中
curdoc().add_root(SearchDisplay())

关键细节说明 #

• 回调参数：db_query的三个参数attr, old, new分别代表变化的属性名（这里是value）、旧值、新值，你只需要用new获取输入框的最新内容即可。
• 结果格式选择：
  • 纯字符串列表：比如["Apple", "Banana"]，适合值和显示文本完全一致的场景
  • 元组列表：比如[("apple", "苹果"), ("banana", "香蕉")]，适合需要区分内部值和显示标签的场景
• 慢查询优化：如果数据库查询耗时较长，建议用异步方式避免阻塞Bokeh服务器，示例如下：

  import asyncio
  
  async def your_db_query_function(search_term):
      # 模拟异步数据库查询（替换成你的实际逻辑）
      await asyncio.sleep(0.5)
      return [f for f in ["Apple", "Banana", "Apricot", "Avocado"] if search_term.lower() in f.lower()]
  
  def db_query(attr, old, new):
      asyncio.create_task(update_results(new))
  
  async def update_results(search_term):
      result = await your_db_query_function(search_term)
      fruit_results.options = [(f, f) for f in result]
  

这样就能实现输入框输入内容后，自动查询数据库并更新MultiSelect的结果啦！

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