跳到主要内容

网格、刻度与画布开关

grid 对象控制所有不是数据的东西:网格线、坐标轴外框、刻度,以及一组改变整块画布画法的开关。

网格、坐标轴线与刻度​

字段类型设置什么
show_gridboolean画网格线。
axis_linestring"open"(默认,只画下边与左边)或 "box"(整框)。
ticksinteger每根轴大致画多少刻度。
tick_alignstring"outside"(默认)· "inside" · "center"。
tick_posstring"primary"(默认)· "both"(四条边都镜像刻度)。
grid_line_widthnumber网格线宽。
axis_line_widthnumber坐标轴线宽。
tick_widthnumber刻度线宽。
tick_lengthnumber刻度长度(像素)。
minor_ticksinteger主刻度之间再分几个小格。
show_minor_gridboolean副刻度处也画网格线。

整块画布的开关​

字段类型设置什么
clamp_axisboolean轴范围贴紧数据,不再向外取整。
clamp_y_axisboolean同上,但只作用在 y 轴。
equal_aspectboolean一个数据单位在两轴上占同样的像素(圆保持是圆)。
scalenumber缩放所有文字与刻度,但不改变画布尺寸。
label_backgroundboolean给数值标签垫一层背景(柱、饼等),让它在填充色上依然看得清。
bw_modeboolean灰度 / 色盲友好模式:调色板换成灰阶,线型与 marker 轮流变化,让 series 仍能区分。见黑白模式。
interactiveboolean往 SVG 里注入悬停 / 点击的 JavaScript。见 SVG 交互。
wrapinteger一次给所有文字(标题、轴标题、图例)设折行宽度;逐元素设置会覆盖它。见文字折行。
bw_mode 与 interactive 属于画布,不属于 series

它们写在 grid 下,不要写在 series 上。bw_mode 是palette的可访问性版本; interactive 让 SVG 响应指针,需要有能跑 JavaScript 的宿主(浏览器,而不是栅格导出)。

示例​

整框 + 副刻度 + 四边镜像刻度,画一张简单柱状图:

SELECT kuva_render(to_json({
'x_axis': {'name': 'GO term', 'tick_rotate': 60},
'y_axis': {'name': 'hits'},
'grid': {'axis_line': 'box', 'minor_ticks': 4, 'show_minor_grid': true, 'tick_pos': 'both'},
'series': [{
'type': 'bar',
'categories': list(category ORDER BY count DESC),
'values': list(count ORDER BY count DESC)
}]
})) AS chart
FROM read_csv_auto('{{DFK_BASE_URL}}data/bar.tsv');

灰度模式:同一张多 series 散点,画给打印、也给色盲读者看:

SELECT kuva_render(to_json({
'x_axis': {'name': 'x'},
'y_axis': {'name': 'y'},
'grid': {'bw_mode': true},
'series': list({'type': 'scatter', 'data': pts, 'legend': g} ORDER BY g)
})) AS chart
FROM (
SELECT "group" AS g, array_agg({'x': x, 'y': y} ORDER BY x) AS pts
FROM read_csv_auto('{{DFK_BASE_URL}}data/scatter.tsv')
GROUP BY "group"
);

另见​