Bokeh: 客户端事件触发 CustomJS

在本文中，我们将介绍如何使用 Bokeh 的 CustomJS 来响应客户端事件。Bokeh 是一个用于创建交互式可视化图形的 Python 库，它提供了丰富的功能和灵活的工具，可以帮助我们以交互方式探索和分析数据。

阅读更多：Bokeh 教程

什么是 Bokeh？

Bokeh 是一个用于构建交互式数据可视化的 Python 库。它使用 HTML、CSS 和 JavaScript 技术，通过在服务器和浏览器之间建立通信，将图形渲染为交互式的 Web 应用程序。

Bokeh 提供了一个简单的 API，可以轻松地创建各种类型的图形，包括折线图、散点图、柱状图和热力图等。它还支持交互式工具，如缩放、平移和选取，使用户能够自由探索图形和数据。

CustomJS 和客户端事件

Bokeh 的 CustomJS 是一个用于处理客户端事件的工具。它允许我们根据用户的操作执行自定义的 JavaScript 代码。通过使用 CustomJS，我们可以在特定的客户端事件发生时，触发一系列操作或更新图形的状态。

常见的客户端事件包括鼠标点击、鼠标悬停、键盘按下等。当触发这些事件时，CustomJS 可以执行一些操作，如更新图形的颜色、显示/隐藏某些元素或触发异步数据请求等。

下面是一个简单的示例，演示了如何在 Bokeh 图形中使用 CustomJS 来响应鼠标点击事件：

from bokeh.plotting import figure, show
from bokeh.models import CustomJS

# 创建一个图形对象
p = figure(plot_width=400, plot_height=400)

# 添加一个圆形到图形中
circle = p.circle([1, 2, 3, 4, 5], [2, 4, 1, 2, 3], size=20)

# 创建一个 CustomJS 回调函数
callback = CustomJS(args=dict(circle=circle), code="""
    // 获取被点击的数据点的索引
    var index = cb_obj.selected.indices[0];

    // 将对应的数据点颜色修改为红色
    circle.glyph.fill_color[index] = "red";
""")

# 将回调函数绑定到图形对象上的点击事件
circle.js_on_event('tap', callback)

# 显示图形
show(p)

在上述示例中，我们创建了一个简单的散点图，并使用 CustomJS 将鼠标点击事件与图形的颜色更新操作关联起来。当用户点击图形上的数据点时，对应的数据点颜色会变为红色。

使用 CustomJS 处理其他客户端事件

除了鼠标点击事件，CustomJS 还可以用于处理其他的客户端事件。例如，我们可以使用 CustomJS 来实现以下功能：

在鼠标悬停时显示数据标签；
在鼠标拖动时更新图形；
在键盘按下时执行特定的操作。

为了更好地理解这些功能，我们来看一个例子。下面的代码演示了如何使用 CustomJS 来实现鼠标悬停时显示数据标签的功能：

from bokeh.plotting import figure, show
from bokeh.models import CustomJS, HoverTool

# 创建一个图形对象
p = figure(plot_width=400, plot_height=400)

# 添加一个圆形到图形中
circle = p.circle([1, 2, 3, 4, 5], [2, 4, 1, 2, 3], size=20)

# 创建一个 CustomJS 回调函数
callback = CustomJS(args=dict(circle=circle), code="""
    // 获取鼠标悬停的数据点的索引
    var index = cb_obj.index;

    // 获取对应的数据点的坐标
    var x = circle.data.x[index];
    var y = circle.data.y[index];

    // 显示数据标签
    console.log("Data point at (" + x + ", " + y + ")");
""")

# 创建一个 HoverTool 工具，绑定到图形对象上的鼠标悬停事件
hover_tool = HoverTool(renderers=[circle], callback=callback)

# 添加 HoverTool 工具到图形中
p.tools.append(hover_tool)

# 显示图形
show(p)