Bokeh可视化工具中的Tooltips功能详解-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00641/article/details/148374497

Bokeh可视化工具中的Tooltips功能详解

bokeh bokeh/bokeh: 是一个用于创建交互式图形和数据的 Python 库。适合用于数据可视化、数据分析和呈现，以及创建动态的 Web 应用。特点是提供了一种简洁、直观的 API 来描述和处理数据，并生成交互式的可视化效果。项目地址: https://gitcode.com/gh_mirrors/bo/bokeh

什么是Tooltips

Tooltips（工具提示）是Bokeh可视化库中一项强大的交互功能，它允许用户在悬停或点击特定UI元素时显示额外的信息提示。这种交互方式可以显著提升数据可视化的用户体验，为用户提供更丰富的上下文信息。

Tooltip对象详解

Bokeh通过Tooltip模型来管理工具提示，这个对象提供了多种属性来自定义工具提示的行为和外观：

content：定义工具提示的内容，可以是纯文本或HTML格式
position：控制工具提示相对于目标元素的位置
target：指定工具提示关联的UI元素

from bokeh.models import Tooltip

# 创建基本工具提示
basic_tip = Tooltip(content="这是一个简单的提示", position="right")

# 创建HTML格式的工具提示
html_tip = Tooltip(content="<b>HTML格式</b>的提示可以包含<i>样式</i>", position="below")

工具提示内容类型

Bokeh支持两种类型的工具提示内容：

纯文本提示：简单的字符串，适用于基本说明
HTML提示：支持HTML标记，可以实现更丰富的样式和布局

# 纯文本示例
text_tip = Tooltip(content="请输入您的用户名", position="right")

# HTML示例
html_tip = Tooltip(
    content="""
    <div style="background: #f0f0f0; padding: 10px;">
        <h3>帮助信息</h3>
        <p>这里可以输入您的电子邮件地址</p>
        <p style="color: red;">必填字段</p>
    </div>
    """,
    position="right"
)

支持工具提示的UI元素

输入部件(Input Widgets)

Bokeh中所有继承自InputWidget基类的部件都内置支持工具提示。这些部件通过description属性来设置工具提示：

from bokeh.models import TextInput, Tooltip

# 创建文本输入框并添加工具提示
username_input = TextInput(
    title="用户名",
    description=Tooltip(content="请输入3-20个字符的用户名", position="right")
)

注意事项：

工具提示只在设置了title属性的部件上显示
每个工具提示实例应该只用于一个部件，重复使用会导致只有第一个部件显示提示

帮助按钮(HelpButton)

对于不支持内置工具提示的UI元素，可以使用HelpButton来添加帮助信息：

from bokeh.models import HelpButton, Tooltip

help_button = HelpButton(
    tooltip=Tooltip(
        content="这是关于此图表的额外说明",
        position="right"
    )
)

高级用法：为任意元素添加工具提示

Bokeh允许为任何UI元素添加工具提示，通过target属性实现：

from bokeh.models import Div, Tooltip

# 创建一个div元素
info_div = Div(text="<p>悬停在这里查看提示</p>")

# 创建工具提示并指定目标
custom_tip = Tooltip(
    content="这是自定义元素的提示",
    position="right",
    target=info_div  # 直接指定目标元素
)