bokeh.themes

提供对内置主题的访问

内置主题

CALIBER

from bokeh.plotting import curdoc, figure, show

x = [1, 2, 3, 4, 5]
y = [6, 7, 6, 4, 5]

curdoc().theme = 'caliber'

p = figure(title='caliber', width=300, height=300)
p.line(x, y)

show(p)

CARBON

from bokeh.plotting import curdoc, figure, show

x = [1, 2, 3, 4, 5]
y = [6, 7, 6, 4, 5]

curdoc().theme = 'carbon'

p = figure(title='carbon', width=300, height=300)
p.line(x, y)

show(p)

DARK_MINIMAL

from bokeh.plotting import curdoc, figure, show

x = [1, 2, 3, 4, 5]
y = [6, 7, 6, 4, 5]

curdoc().theme = 'dark_minimal'

p = figure(title='dark_minimal', width=300, height=300)
p.line(x, y)

show(p)

LIGHT_MINIMAL

from bokeh.plotting import curdoc, figure, show

x = [1, 2, 3, 4, 5]
y = [6, 7, 6, 4, 5]

curdoc().theme = 'light_minimal'

p = figure(title='light_minimal', width=300, height=300)
p.line(x, y)

show(p)

NIGHT_SKY

from bokeh.plotting import curdoc, figure, show

x = [1, 2, 3, 4, 5]
y = [6, 7, 6, 4, 5]

curdoc().theme = 'night_sky'

p = figure(title='night_sky', width=300, height=300)
p.line(x, y)

show(p)

CONTRAST

from bokeh.plotting import curdoc, figure, show

x = [1, 2, 3, 4, 5]
y = [6, 7, 6, 4, 5]

curdoc().theme = 'contrast'

p = figure(title='contrast', width=300, height=300)
p.line(x, y)

show(p)

主题

class Theme(filename: str | PathLike[str])

class Theme(json: dict[str, Any])

为 Bokeh 模型提供新的默认值。

Bokeh 模型属性都具有一些内置的默认值。如果一个属性没有被显式设置（例如 m.foo = 10），访问该属性将返回默认值。用户可能需要能够指定一组与内置默认值不同的默认值。Theme 类允许将自定义默认值的集合轻松应用于 Bokeh 文档。

Theme 类可以从 YAML 文件或 JSON 字典（但不能同时从两者）构建。下面显示了两种格式的示例。

绘图 API 默认会覆盖一些主题属性。即：fill_alpha、fill_color、line_alpha、line_color、text_alpha 和 text_color。因此，在使用绘图 API 时，应显式设置这些属性。

参数:

• filename (str, 可选) – YAML 主题文件的路径

• json (str, 可选) – 指定主题值的 JSON 字典

Raises:

ValueError – 如果既未提供 filename 也未提供 json。

示例

主题通过提供顶层键 attrs 来指定，该键具有用于主题化的模型类型的块。每个块都具有键和值，用于指定该类型的新属性默认值。

请注意，YAML 将值 None 解释为字符串，这通常不是您想要的。要在 YAML 中将 None 作为值给出，请使用 !!null。要在 json 中将 ‘None’ 作为值给出，请使用 null。

这是一个 YAML 格式的示例主题，它为所有图形、网格和标题设置了各种视觉属性

attrs:
    Plot:
        background_fill_color: '#2F2F2F'
        border_fill_color: '#2F2F2F'
        outline_line_color: '#444444'
    Axis:
        axis_line_color: !!null
    Grid:
        grid_line_dash: [6, 4]
        grid_line_alpha: .3
    Title:
        text_color: "white"

这是相同的 JSON 格式主题

{
    'attrs' : {
        'Plot': {
            'background_fill_color': '#2F2F2F',
            'border_fill_color': '#2F2F2F',
            'outline_line_color': '#444444',
        },
        'Axis': {
            'axis_line_color': None,
        },
        'Grid': {
            'grid_line_dash': [6, 4],
            'grid_line_alpha': .3,
        },
        'Title': {
            'text_color': 'white'
        }
    }
}