跳到主要内容

主题

theme 重新给所有不是数据的东西上色 —— 背景、坐标轴、网格、文字、图例外框。给它一个名字,或给一个 对象只覆盖个别颜色(以 light 为底)。

具名主题​

取值外观
"light"默认:白底黑字。
"dark"深色底、浅色字。
"minimal"极简:无网格、几乎没有装饰。
"solarized"Solarized 配色。

内置主题具体设了什么​

属性light(默认)darkminimalsolarized
背景white#1e1e1ewhite#fdf6e3
轴 / 刻度black#ccccccblack#586e75
文字black#e0e0e0black#657b83
网格#ccc#444444#e0e0e0#eee8d5
图例背景white#2d2d2dwhite#fdf6e3
图例边框black#666666无#93a1a1
字体默认字体栈默认字体栈serif默认字体栈
是否画网格是是否是

这些就是内置主题实际装上去的值 —— theme 对象以 light 为底,只覆盖你给出的键,下面的自定义主题就是这么来的。

字体与可移植性​

默认字体栈 DejaVu Sans, Verdana, Liberation Sans, Arial, sans-serif 是由渲染这份 SVG 的那个东西去解析的。 桌面环境都没问题;但一个没有系统字体的环境(容器、CI)里处理这个文件时,它会退到别的字体。kuva 可以把字体以 base64 的 @font-face 块内嵌进去,让文件自包含,代价是体积大约多 1 MB。

本扩展没有开放这个开关。 内嵌的字体得装进 .duckdb_extension 本身,让每一次安装都为此大出约 1 MB, 而 DuckDB 里根本不会遇到那个场景:SVG 是交给浏览器或排版工具显示的,它们都有字体。确实需要自包含的 SVG 时, 请直接用 kuva 重新渲染一份。

自定义主题​

对象形式以 light 主题为底,只覆盖你给出的键:

字段类型设置什么
backgroundstring画布背景。
axis_colorstring坐标轴线。
grid_colorstring网格线。
tick_colorstring刻度线。
text_colorstring所有文字。
legend_bgstring图例背景。
legend_borderstring图例外框。
pie_leaderstring饼图的引导线。
box_medianstring箱线图的中位数线。
violin_borderstring小提琴图外轮廓。
colorbar_borderstring热力图色条的外框。
font_familystring字体族(等同于 font.family)。
show_gridboolean是否画网格。

示例​

深色主题,配的是series页那张叠加图:

SELECT kuva_render(to_json({
'theme': 'dark',
'x_axis': {'name': 'time'},
'y_axis': {'name': 'value'},
'series': [
{'type': 'line', 'data': pts, 'legend': 'trend'},
{'type': 'scatter', 'data': pts, 'legend': 'points'}
]
})) AS chart
FROM (
SELECT array_agg({'x': time, 'y': value} ORDER BY time) AS pts
FROM read_csv_auto('{{DFK_BASE_URL}}data/measurements.tsv')
WHERE "group" = 'Condition_A'
);

另见​