Keel v0.5.1 English GitHub

Plot

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码Go · 可复制

这是上方组件库展示案例的完整源码。examples/components/plot.go

在脚手架项目中复用组件构造和 Render 写法;示例的 registerSection 与共享辅助函数由组件库提供。

package main

import (
	"math"

	"github.com/dyike/keel/ui/core"
	"github.com/dyike/keel/ui/el"
	"github.com/dyike/keel/ui/kit"
)

func init() {
	registerSection("plot", "charts", func() core.Widget {
		var wave, damped []kit.PlotPoint
		for i := 0; i <= 200; i++ {
			x := float64(i) / 10
			wave = append(wave, kit.PlotPoint{X: x, Y: math.Sin(x)})
			damped = append(damped, kit.PlotPoint{X: x, Y: math.Exp(-x/8) * math.Cos(x*1.3)})
		}
		lines := kit.Plot(kit.PlotSeries{Name: "sin(x)", Points: wave}, kit.PlotSeries{Name: demoText("Damped oscillation", "衰减振荡"), Points: damped}).
			Lines().Title(demoText("Scroll to zoom · Drag to pan · Double-click to reset", "滚轮缩放 · 拖动平移 · 双击复位"))
		var scatter []kit.PlotPoint
		for i := 0; i < 120; i++ {
			x := float64(i%40) + float64(i)/7
			scatter = append(scatter, kit.PlotPoint{X: x, Y: 30 + x*1.8 + 12*math.Sin(float64(i)*1.7)})
		}
		dots := kit.Plot(kit.PlotSeries{Name: demoText("Order amount vs quantity", "订单金额 vs 数量"), Points: scatter}).Title(demoText("Scatter plot: hover for values", "散点:悬停查看数值")).Height(200)
		return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
			return el.Div().P(24).Gap(16).W(el.Dp(620)).MaxW(el.Full).Child(lines.Render(cx), dots.Render(cx))
		}))
	})
}

数值型的 x / y 绘图,可以交互探索数据。

p := kit.Plot(
    kit.PlotSeries{Name: "sin(x)", Points: wave},
    kit.PlotSeries{Name: "实测", Points: samples},
).Lines().Title("信号")
  • 鼠标:滚轮以指针位置为中心缩放;拖动平移;双击或点"复位"恢复显示全部数据。
  • 键盘:获得焦点后,+ / − 缩放,方向键平移,0 复位。
  • 悬停时会选中 12dp 范围内最近的数据点,放大显示,并弹出提示框显示名称和坐标。
  • 默认画成散点;Lines() 用 2dp 的线把各点连起来,只放大显示被选中的那个点。点的颜色取 theme.Chart,外面有一圈背景色的描边,重叠时也能分清。
  • View() / SetView() 读取或设置当前可见范围,Reset() 适配全部数据,SetSeries 替换数据,Format(fn) 设置数值写法。

Agent:角色 figure;"复位"是一个按钮。

验证:go run ./examples/components -section plot,加 -theme dark 检查深色。

构造和 SetSeries 复制系列及点切片;包含 NaN/Inf 坐标的点不参与适配、拾取或绘制,折线在该处断开。空数据和全无效数据显示空状态。SetView 忽略非有限或倒置范围。

缩放保持端点有限且有序,达到相对精度下限(约当前坐标尺度的 10⁻¹²)后停止继续放大;平移或缩小若会溢出则保留原范围。滚轮单次倍率限制为 0.01–100。极大或极小数值默认使用科学记数法。

SetDisabled(true) 禁用指针、复位与键盘;拖动取消或拖动中禁用所属区域会回到拖动开始的视图。更换数据会清除旧的悬停选点。标题和图例在窄窗口换行,提示宽度不超过绘图区。

自定义图表可使用独立 ui/plot 包,见公共绘图基础件。