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` 函数中图标路径的处理逻辑。
28 lines
907 B
Python
28 lines
907 B
Python
from typing import Literal
|
|
|
|
from pydantic import Field
|
|
|
|
from ..core.base import RenderableComponent
|
|
|
|
__all__ = ["UserInfoBlock"]
|
|
|
|
|
|
class UserInfoBlock(RenderableComponent):
|
|
"""一个带头像、名称和副标题的用户信息块组件。"""
|
|
|
|
component_type: Literal["user_info_block"] = "user_info_block"
|
|
avatar_url: str = Field(..., description="用户头像的URL")
|
|
"""用户头像的URL"""
|
|
name: str = Field(..., description="用户的名称")
|
|
"""用户的名称"""
|
|
subtitle: str | None = Field(
|
|
default=None, description="显示在名称下方的副标题 (如UID或角色)"
|
|
)
|
|
"""显示在名称下方的副标题 (如UID或角色)"""
|
|
tags: list[str] = Field(default_factory=list, description="附加的标签列表")
|
|
"""附加的标签列表"""
|
|
|
|
@property
|
|
def template_name(self) -> str:
|
|
return "components/widgets/user_info_block"
|