Keel v0.5.1 English GitHub

PieChart

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

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

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

package main

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

func init() {
	registerSection("pie_chart", "charts", func() core.Widget {
		data := []kit.PieSlice{{Name: demoText("East China", "华东"), Value: 48}, {Name: demoText("North China", "华北"), Value: 32}, {Name: demoText("South China", "华南"), Value: 20}}
		pie := kit.PieChart(data...).Title(demoText("Sales share by region", "销售地区占比")).TooltipContent(func(cx *el.Context, data kit.PieChartTooltip) el.Element {
			return el.Div().Gap(4).Child(el.Text(data.Slice.Name).Bold(), el.Text(demoText("Sales: ", "销售额:")+data.FormattedValue), el.Text(demoText("Visible region shares: ", "可见地区占比:")+data.FormattedShare).TextColor(data.Color))
		})
		donut := kit.PieChart(data...).Donut(.6).Title(demoText("Donut chart · Click the legend to toggle", "环形图 · 点击图例切换"))
		return el.Embed(el.ViewFunc(func(cx *el.Context) el.Element {
			return el.Div().P(24).Gap(16).W(el.Dp(600)).MaxW(el.Full).Child(pie.Render(cx), donut.Render(cx))
		}))
	})
}

饼图和环形图显示同一组数据的占比。

chart := kit.PieChart(
    kit.PieSlice{Name: "线上", Value: 60},
    kit.PieSlice{Name: "门店", Value: 40},
).Title("收入来源").Donut(.6)

Height(dp) 设置绘图区高度;Donut(fraction) 设置中心孔半径比例,范围 0–0.9,默认 0。Format(fn) 设置数值格式,占比保留一位小数。SetData 复制数据并恢复图例可见状态。

图例可点击或用空格/Enter 切换,对剩余可见数据重新计算比例。悬停扇区显示名称、原始值和占比;中心孔不命中。颜色按原始索引分配,隐藏不会改变其余项颜色。SetDisabled 禁用图例、表格切换和悬停。

仅有限正数参与扇区;0 没有扇区,负数、NaN、Inf 在表格中显示为 —。全空、全部隐藏或全部无效时显示空状态。比例先按最大值缩放,两个最大浮点数也不会使总量溢出。数据表保留所有项,隐藏项占比为 0。

Agent:外层 figure,名字是标题;图例是带选中状态的 toggle。切换到数据表可读取名称、值和占比。

验证:go run ./examples/components -section pie_chart,加 -theme dark 检查深色。测试覆盖扇区与中心孔命中、图例重算、禁用、数据复制、空数据、异常值和数据表。

TooltipContent(func(cx, PieChartTooltip) el.Element) 添加跟随鼠标的自定义浮层,原有底部读数与数据表保留。回调参数包含原始 Index/Slice、可见扇区归一化后的 Share(0–1)、格式化数值/比例和当前主题扇区色。参数为值快照;不要在渲染回调中修改数据。

传 nil 恢复仅底部读数,回调返回 nil 可按扇区隐藏浮层。提示只展示内容,不承载交互;离开饼图、进入圆环孔、隐藏扇区、更新数据或禁用后不再展示对应提示。浮层锚定鼠标位置并受窗口尺寸约束。组件库加入自定义提示。1×/2× 测试覆盖鼠标命中、浮层横向边界、显式禁用及图例切换后的占比;完整原生窗口交互仍待验收。

HoverAnimation(false) 关闭悬停过渡,默认开启。强调状态以 150ms 三次缓出变化,快速换目标从当前权重继续;减少动画时立即显示目标。饼图过渡选中边框,桑基图过渡不相关流带的透明度,折线/面积图过渡焦点线和点,柱/蜡烛图过渡类别背景,雷达图过渡焦点。命中和提示数据立即更新,不等待动画。更新数据清理旧过渡。共享动画测试覆盖中间帧权重、切换目标时的连续性、结束帧及减少动画;各图的原生动画观感仍待验收。