直接跳到内容

Gauge 仪表盘

仪表盘提供了一个值的可视化表示,以仪表或速度计形式展示。Gauge组件使用ECharts库渲染。

底层实现为panel.widgets.Gauge,参数基本一致,参考文档:https://panel.holoviz.org/reference/indicators/Gauge.html

基本用法

最简单的仪表盘只需要设置一个在指定范围内的value。默认的格式化器和范围假设你提供的是百分比值:

自定义格式与颜色阈值

如果我们想要显示其他值,例如发动机每分钟转速,我们可以设置不同的bounds值并重写format。此外,我们还可以提供一组不同的颜色,定义应在提供范围的哪个点上更改颜色。colors接受一个元组列表,定义分数和颜色:

自定义指针颜色

您还可以通过传递自定义选项来更改指针的颜色:

API

属性

属性名说明类型默认值
value仪表当前值(需在bounds范围内)float|int 25
annulus_width仪表环宽度(像素)int 10
bounds仪表数值范围(最小值, 最大值)tuple (0, 100)
colors颜色阈值配置([(阈值比例, 颜色), ...])list []
custom_optsECharts仪表盘额外配置选项dict {}
end_angle仪表结束角度(度)float|int -45
format数值显示格式(支持{value}占位符)str '{value}%'
num_splits仪表刻度分割数量int 10
show_ticks是否显示刻度线bool True
show_labels是否显示刻度标签bool True
start_angle仪表起始角度(度)float|int 225
tooltip_format悬停提示框格式({b}:名称, {c}:值)str '{b}: {c}%'
title_size标题字体大小(像素)int 18

Events

事件名说明类型
change当值变化时触发的事件Callable 

Controls

src/examples/panel_vuepy/indicators/Gauge

Gauge 仪表盘已经加载完毕