Bokeh 如何向数据表（Bokeh，Python）添加 HoverTool

在本文中，我们将介绍如何使用 Bokeh 和 Python 向数据表添加 HoverTool。Bokeh 是一个用于创建交互式可视化的 Python 库，它可以用于创建各种类型的图表和图形。

阅读更多：Bokeh 教程

何为 HoverTool

HoverTool 是 Bokeh 提供的一个工具，它可以在特定的数据点上悬停时显示一些额外的信息。通过使用 HoverTool，我们可以为数据表中的每个单元格添加悬停功能，以提供更多有用的信息。

创建一个数据表

首先，我们需要创建一个数据表用于展示并添加 HoverTool。在 Bokeh 中，可以使用 Table 类创建一个数据表。下面是一个示例：

from bokeh.models import ColumnDataSource, DataTable, NumberFormatter, StringFormatter
from bokeh.layouts import layout
from bokeh.io import show
from bokeh.plotting import curdoc

# 数据
data = {'name': ['Alice', 'Bob', 'Charlie'],
        'age': [25, 30, 35],
        'occupation': ['Engineer', 'Designer', 'Programmer']}

# 创建数据源
source = ColumnDataSource(data)

# 创建数据表
columns = [
    DataTable.Column(field='name', title='姓名', formatter=StringFormatter(text_align='center')),
    DataTable.Column(field='age', title='年龄', formatter=NumberFormatter(format='0')),
    DataTable.Column(field='occupation', title='职业', formatter=StringFormatter(text_align='center'))
]
data_table = DataTable(source=source, columns=columns)

# 显示数据表
curdoc().add_root(layout([[data_table]]))
show(layout([[data_table]]))

上述示例中，我们创建了一个包含姓名、年龄和职业的数据表。我们使用 ColumnDataSource 来存储数据，然后创建一个包含所有列的 DataTable 实例。DataTable 中的每个 Column 对象定义了列的字段、标题和格式化方式。

添加 HoverTool

要将 HoverTool 添加到数据表中，我们需要使用 add_tools 方法将其加载到 DataTable 对象中。下面的示例演示了如何添加 HoverTool：

from bokeh.models import HoverTool

# 创建 HoverTool
hover_tool = HoverTool(tooltips=[('姓名', '@name'), ('年龄', '@age'), ('职业', '@occupation')])

# 添加 HoverTool
data_table.add_tools(hover_tool)

# 显示数据表
curdoc().add_root(layout([[data_table]]))
show(layout([[data_table]]))

在上述示例中，我们首先创建了一个包含姓名、年龄和职业的悬停信息的 HoverTool 对象。然后，我们使用 add_tools 方法将其添加到数据表中。

当鼠标悬停在数据表的某个单元格上时，将显示包含相关信息的悬停工具提示。

自定义 HoverTool 样式

我们还可以自定义 HoverTool 的样式，以使其适应我们的需求。以下是一些常用的自定义选项：

mode：指定悬停的模式，默认为 'mouse'，表示鼠标悬停在数据点上时显示。可以设置为 'vline' 或 'hline'，分别表示垂直线或水平线上的悬停显示。
line_policy：指定线的显示策略，默认为 'interp'，表示鼠标悬停位置附近的最近数据点上的线。可以设置为 'prev' 或 'next'，分别表示前一个或后一个数据点上的线。
formatters：指定自定义格式化选项，例如使用 'datetime' 格式化时间戳。

下面的示例演示了如何自定义 HoverTool 的样式：

from bokeh.models import HoverTool

# 创建自定义样式的 HoverTool
hover_tool = HoverTool(tooltips=[('姓名', '@name'), ('年龄', '@age'), ('职业', '@occupation')],
                       mode='mouse',
                       line_policy='interp')

# 添加自定义样式的 HoverTool
data_table.add_tools(hover_tool)

# 显示数据表
curdoc().add_root(layout([[data_table]]))
show(layout([[data_table]]))

在上述示例中，我们在创建 HoverTool 对象时指定了自定义的模式和线的显示策略。这样，我们就可以根据需求来自定义悬停工具的样式。