mirror of
https://github.com/zhenxun-org/zhenxun_bot.git
synced 2025-12-14 21:52:56 +08:00
c7ef6fdb17
Some checks failed
检查bot是否运行正常 / bot check (push) Has been cancelled
CodeQL Code Security Analysis / Analyze (${{ matrix.language }}) (none, javascript-typescript) (push) Has been cancelled
CodeQL Code Security Analysis / Analyze (${{ matrix.language }}) (none, python) (push) Has been cancelled
Sequential Lint and Type Check / ruff-call (push) Has been cancelled
Release Drafter / Update Release Draft (push) Has been cancelled
Force Sync to Aliyun / sync (push) Has been cancelled
Update Version / update-version (push) Has been cancelled
Sequential Lint and Type Check / pyright-call (push) Has been cancelled
* ✨ feat(table): 添加 ComponentCell 以支持表格单元格中嵌入可渲染组件 * ✨ feat(ui): 增强表格构建器并完善组件模型文档 - 增强 `TableBuilder`，新增 `_normalize_cell` 辅助方法，支持自动将原生数据类型（如 `str`, `int`, `Path`）转换为 `TableCell` 模型，简化了表格行的创建。 - 完善 `zhenxun/ui/models` 目录下所有组件模型字段的 `description` 属性和文档字符串，显著提升了代码可读性和开发者体验。 - 优化 `shop/_data_source.py` 中 `gold_rank` 函数的平台路径判断格式，并统一 `my_props` 函数中图标路径的处理逻辑。 * 🚨 auto fix by pre-commit hooks --------- Co-authored-by: webjoin111 <455457521@qq.com> Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
36 lines
1.2 KiB
Python
36 lines
1.2 KiB
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'"
|
||
)
|
||
"""与上一周期的变化，例如 '+15%' 或 '-100'"""
|
||
change_type: Literal["positive", "negative", "neutral"] = Field(
|
||
default="neutral", description="变化的类型，用于决定颜色"
|
||
)
|
||
"""变化的类型，用于决定颜色"""
|
||
icon_svg: str | None = Field(
|
||
default=None, description="卡片中显示的可选图标 (SVG path data)"
|
||
)
|
||
"""卡片中显示的可选图标 (SVG path data)"""
|
||
|
||
@property
|
||
def template_name(self) -> str:
|
||
return "components/widgets/kpi_card"
|