mirror of
https://github.com/zhenxun-org/zhenxun_bot.git
synced 2025-12-15 14:22:55 +08:00
f89d677def
- 增强 `TableBuilder`，新增 `_normalize_cell` 辅助方法，支持自动将原生数据类型（如 `str`, `int`, `Path`）转换为 `TableCell` 模型，简化了表格行的创建。 - 完善 `zhenxun/ui/models` 目录下所有组件模型字段的 `description` 属性和文档字符串，显著提升了代码可读性和开发者体验。 - 优化 `shop/_data_source.py` 中 `gold_rank` 函数的平台路径判断格式，并统一 `my_props` 函数中图标路径的处理逻辑。
40 lines
1.2 KiB
Python
40 lines
1.2 KiB
Python
from pathlib import Path
|
|
from typing import Any
|
|
|
|
from pydantic import Field
|
|
|
|
from .base import RenderableComponent
|
|
|
|
__all__ = ["TemplateComponent"]
|
|
|
|
|
|
class TemplateComponent(RenderableComponent):
|
|
"""基于独立模板文件的UI组件"""
|
|
|
|
_is_standalone_template: bool = True
|
|
"""标记此组件为独立模板"""
|
|
template_path: str | Path = Field(..., description="指向HTML模板文件的路径")
|
|
"""指向HTML模板文件的路径"""
|
|
data: dict[str, Any] = Field(..., description="传递给模板的上下文数据字典")
|
|
"""传递给模板的上下文数据字典"""
|
|
|
|
@property
|
|
def template_name(self) -> str:
|
|
"""返回模板路径"""
|
|
if isinstance(self.template_path, Path):
|
|
return self.template_path.as_posix()
|
|
return str(self.template_path)
|
|
|
|
def get_render_data(self) -> dict[str, Any]:
|
|
"""返回传递给模板的数据"""
|
|
return self.data
|
|
|
|
def __getattr__(self, name: str) -> Any:
|
|
"""允许直接访问 `data` 字典中的属性。"""
|
|
try:
|
|
return self.data[name]
|
|
except KeyError:
|
|
raise AttributeError(
|
|
f"'{type(self).__name__}' 对象没有属性 '{name}'"
|
|
) from None
|