mirror of
https://github.com/zhenxun-org/zhenxun_bot.git
synced 2025-12-15 14:22:55 +08:00
0558c7c0a7
🏗️ **架构重构** - 移除charts.py中所有硬编码样式参数(grid、tooltip、legend等) - 将样式配置迁移至主题层style.json文件 - 统一图表模板消费样式文件的能力 📊 **图表组件优化** - bar_chart: 移除grid和坐标轴show参数 - pie_chart: 移除tooltip、legend样式和series视觉参数 - line_chart: 移除tooltip、grid和坐标轴配置 - radar_chart: 移除tooltip硬编码 🎨 **主题系统增强** - 新增pie_chart、line_chart、radar_chart的style.json配置 - 更新bar_chart/style.json，添加grid、xAxis、yAxis样式 - 所有图表模板支持deepMerge样式合并逻辑 🔧 **Breaking Changes** - 图表工厂函数不再接受样式参数 - 主题开发者现可通过style.json完全定制图表外观 - 提升组件可维护性和主题灵活性
30 lines
1008 B
Python
30 lines
1008 B
Python
from typing import Any, Literal
|
||
|
||
from pydantic import Field
|
||
|
||
from ..core.base import RenderableComponent
|
||
|
||
__all__ = ["KpiCard"]
|
||
|
||
|
||
class KpiCard(RenderableComponent):
|
||
"""一个用于展示关键性能指标（KPI）的统计卡片。"""
|
||
|
||
component_type: Literal["kpi_card"] = "kpi_card"
|
||
label: str = Field(..., description="指标的标签或名称")
|
||
value: Any = Field(..., description="指标的主要数值")
|
||
unit: str | None = Field(default=None, description="数值的单位，可选")
|
||
change: str | None = Field(
|
||
default=None, description="与上一周期的变化，例如 '+15%' 或 '-100'"
|
||
)
|
||
change_type: Literal["positive", "negative", "neutral"] = Field(
|
||
default="neutral", description="变化的类型，用于决定颜色"
|
||
)
|
||
icon_svg: str | None = Field(
|
||
default=None, description="卡片中显示的可选图标 (SVG path data)"
|
||
)
|
||
|
||
@property
|
||
def template_name(self) -> str:
|
||
return "components/widgets/kpi_card"
|