Keel v0.5.1 English GitHub

公共绘图基础件

在线示例:这是真实的 Keel 程序编译成 WebAssembly,可以直接操作。首次加载约 10 MB。全屏打开
示例代码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。