交互式图例#

Legends 添加到 Bokeh 图表中的图例可以设置为交互式,这样点击或轻触图例条目将会隐藏或静音图表中相应的图形。这些模式通过将 Legendclick_policy 属性设置为 "hide""mute" 来激活。

注意

交互式图例仅适用于“每个字形”图例。分组图例尚不支持以下描述的功能。

隐藏字形#

有时希望通过点击Legend中的条目来隐藏字形。在Bokeh中,可以通过将图例的click_policy属性设置为"hide"来实现,如下例所示:

import pandas as pd

from bokeh.palettes import Spectral4
from bokeh.plotting import figure, show
from bokeh.sampledata.stocks import AAPL, GOOG, IBM, MSFT

p = figure(width=800, height=250, x_axis_type="datetime")
p.title.text = 'Click on legend entries to hide the corresponding lines'

for data, name, color in zip([AAPL, IBM, MSFT, GOOG], ["AAPL", "IBM", "MSFT", "GOOG"], Spectral4):
    df = pd.DataFrame(data)
    df['date'] = pd.to_datetime(df['date'])
    p.line(df['date'], df['close'], line_width=2, color=color, alpha=0.8, legend_label=name)

p.legend.location = "top_left"
p.legend.click_policy="hide"

show(p)

静音字形#

有时,图例交互更倾向于使图形变暗,而不是完全隐藏它。在这种情况下,将click_policy属性设置为"mute"。此外,还需要指定“变暗图形”的视觉属性。通常,这与选中和未选中的图形悬停检查的方式完全相同。在下面的示例中,muted_alpha=0.2muted_color=color被传递给circle,以指定变暗的线条应以低alpha的变暗图形绘制。

import pandas as pd

from bokeh.palettes import Spectral4
from bokeh.plotting import figure, show
from bokeh.sampledata.stocks import AAPL, GOOG, IBM, MSFT

p = figure(width=800, height=250, x_axis_type="datetime")
p.title.text = 'Click on legend entries to mute the corresponding lines'

for data, name, color in zip([AAPL, IBM, MSFT, GOOG], ["AAPL", "IBM", "MSFT", "GOOG"], Spectral4):
    df = pd.DataFrame(data)
    df['date'] = pd.to_datetime(df['date'])
    p.line(df['date'], df['close'], line_width=2, color=color, alpha=0.8,
           muted_color=color, muted_alpha=0.2, legend_label=name)

p.legend.location = "top_left"
p.legend.click_policy="mute"

show(p)