公共绘图基础件
示例代码Go · 可复制
这是上方组件库展示案例的完整源码。examples/components/plot_primitives.go
在脚手架项目中复用组件构造和 Render 写法;示例的 registerSection 与共享辅助函数由组件库提供。
package main
import (
"fmt"
"image"
"math"
"github.com/dyike/keel/gio/f32"
"github.com/dyike/keel/gio/unit"
"github.com/dyike/keel/ui/core"
"github.com/dyike/keel/ui/el"
"github.com/dyike/keel/ui/plot"
"github.com/dyike/keel/ui/theme"
)
func init() {
registerSection("plot_primitives", "charts", func() core.Widget {
return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
return el.Div().P(24).W(el.Dp(640)).MaxW(el.Full).Gap(12).Child(
el.Text(demoText("Drawing primitives: stacked bars, trend lines, and donut charts", "绘图基础件:堆叠柱、趋势线与环图")),
el.Widget(core.Func(func(gtx core.C) core.D {
size := gtx.Constraints.Max
dp := func(v float32) float32 { return float32(gtx.Dp(unit.Dp(v))) }
c := plot.Canvas{Context: gtx, Bounds: image.Rectangle{Max: size}}
cats := []string{"Mon", "Tue", "Wed", "Thu"}
x := plot.NewBand(cats, [2]float64{float64(dp(40)), float64(size.X) - float64(dp(16))}).Padding(.25, .1)
y := plot.ScaleLinear{Domain: [2]float64{-10, 40}, Range: [2]float64{float64(size.Y) - float64(dp(30)), float64(dp(10))}}
stacks, _ := plot.Stack([][]float64{{14, 20, 12, 25}, {8, 10, -6, 9}})
var ticks []plot.AxisText
for i, cat := range cats {
left, _ := x.Map(cat)
ticks = append(ticks, plot.AxisText{Position: float32(left + x.Bandwidth()/2), Text: cat})
for s, values := range stacks {
lo, _ := y.Map(values[i].Low)
hi, _ := y.Map(values[i].High)
plot.Bar{Rect: plot.Rectangle{Min: f32.Pt(float32(left), float32(lo)), Max: f32.Pt(float32(left+x.Bandwidth()), float32(hi))}, Fill: theme.Chart[s], Radius: dp(3)}.Paint(c)
}
}
var yTicks []plot.AxisText
for _, value := range []float64{-10, 0, 10, 20, 30, 40} {
pos, _ := y.Map(value)
yTicks = append(yTicks, plot.AxisText{Position: float32(pos), Text: fmt.Sprint(value)})
}
plot.Axis{Side: plot.AxisLeft, At: dp(40), From: dp(10), To: float32(size.Y) - dp(30), TickSize: dp(4), Width: dp(1), Ticks: yTicks, Stroke: theme.Border, TextColor: theme.Muted}.Paint(c)
zero, _ := y.Map(0)
plot.Axis{Side: plot.AxisBottom, At: float32(size.Y) - dp(26), From: dp(40), To: float32(size.X) - dp(16), TickSize: dp(4), Width: dp(1), Ticks: ticks, Stroke: theme.Border, TextColor: theme.Muted}.Paint(c)
plot.CrossLine{At: f32.Pt(0, float32(zero)), Horizontal: true, Stroke: theme.Border, Width: dp(1)}.Paint(c)
var points []f32.Point
for i, v := range []float64{16, 30, 17, 36} {
xx, _ := x.Map(cats[i])
yy, _ := y.Map(v)
points = append(points, f32.Pt(float32(xx+x.Bandwidth()/2), float32(yy)))
}
plot.Line{Points: points, Stroke: theme.Chart[2], Width: dp(2), DotRadius: dp(4), Curve: plot.CurveSmooth}.Paint(c)
return core.D{Size: size}
})).H(el.Dp(240)),
el.Text(demoText("Blue and orange form separate positive and negative stacks; green is another trend series. Values below zero are negative.", "蓝色、橙色为独立正负堆叠,绿色为另一组趋势数据;零线以下表示负值。")),
el.Text("Mon:14 + 8;Tue:20 + 10;Wed:12 − 6;Thu:25 + 9"),
el.Widget(core.Func(func(gtx core.C) core.D {
size := gtx.Constraints.Max
dp := func(v float32) float32 { return float32(gtx.Dp(unit.Dp(v))) }
c := plot.Canvas{Context: gtx, Bounds: image.Rectangle{Max: size}}
arcs, _ := plot.Pie([]float64{40, 35, 25}, -math.Pi/2, 2*math.Pi, .04)
for _, a := range arcs {
plot.Arc{Center: f32.Pt(float32(size.X)/2, float32(size.Y)/2), Inner: dp(32), Outer: dp(60), Start: a.Start, End: a.End, Fill: theme.Chart[a.Index]}.Paint(c)
}
return core.D{Size: size}
})).H(el.Dp(140)),
el.Text(demoText("Donut: 40 / 35 / 25. The application supplies data descriptions and interactions for low-level drawing.", "环图:40 / 35 / 25。低层绘图由应用提供数据描述与交互。")),
)
}))
})
}
github.com/dyike/keel/ui/plot 提供自定义图表的比例尺、数据布局和即时绘制。kit.Plot 继续提供带缩放、平移和拾取的成品图;本包由应用掌握布局、主题颜色、输入处理与数据描述。
x := plot.NewBand([]string{"A", "B"}, [2]float64{0, 300}).Padding(.1, .1)
y := plot.ScaleLinear{Domain: [2]float64{0, 100}, Range: [2]float64{200, 0}}
left, ok := x.Map("A")
top, valid := y.Map(60)
if ok && valid {
plot.Bar{
Rect: plot.Rectangle{Min: f32.Pt(float32(left), float32(top)),
Max: f32.Pt(float32(left+x.Bandwidth()), 200)},
Fill: theme.Chart[0],
}.Paint(plot.Canvas{Context: gtx, Bounds: image.Rect(20, 10, 320, 210)})
}
Canvas 使用本地像素坐标,每次绘制平移到 Bounds.Min,并裁剪到 Bounds。应在 Layout 内创建,不跨帧保存。尺寸需要由调用方按 gtx.Metric 换算;Axis.TextSize 使用 sp。源几何坐标非有限或绝对值超过一千万像素时跳过绘制,避免交给底层图形引擎。
比例尺与数据布局
- ScaleLinear:支持反向域/值域、Map、Invert、Clamp;常量域映射到中点。Ticks 返回含端点的均匀刻度,数量限制为 2–1000,不做 nice 刻度取整。非法输入或不能表示的外推结果返回 false。
- NewBand:分类域去重并复制,Map 返回条带低坐标,Bandwidth 返回宽度。Padding 配置内外间距,Align 配置剩余空间分配;修改方法返回新比例尺。反向值域倒置分类顺序,宽度仍为正。
- NewPoint:分类点位置,默认两端对齐,单项居中;Padding 留两端空间。
- NewOrdinal:分类映射到循环使用的离散值域;复制输入切片,缺失分类/空值域返回 false,不自动扩域。值域元素中的引用由调用方管理。
- Stack:输入按系列组织的二维值,输出保留系列/样本索引及 Low/High/Valid。正负值分别从零累计,NaN/缺失样本保留无效槽;无穷或累计溢出整次返回错误。
- Pie:输出保留原始索引、值及起止弧度;允许正反方向最多一圈,零值省略,负数/非有限值报错。按最大值归一化避免大值求和溢出;间隙角限制在每项可用角度内。零角宽条目可保留索引但不绘制。
绘制
Bar 支持任意方向矩形和圆角;Line 支持直线、阶梯、逐段 smoothstep 曲线及数据点;Area 填充等长上下边界之间的区域,可描上边线。缺失或非法点打断线/面积,不连接缺口。Arc 绘制扇形/环形,使用有限分段近似圆弧;Dot 和 CrossLine 提供点及十字参考线。
Axis 支持上下左右四方向、自定义刻度标签、线宽、颜色和字号;At 为轴位置,From/To 为基线两端。标签同样受 Canvas 裁剪,调用方需预留边距。低层图形及轴标签不会自动生成 Agent 数据节点,应在周围提供可读标题、数据表或文本;提示框可用 kit.Tooltip 或应用浮层组合。此包不自动处理悬停动画,也不等同于上游全部样式配置。
示例将堆叠柱、趋势线、参考线、轴与环图组合:go run ./examples/components -section plot_primitives。